此类提供用于打印和解析的主要应用程序入口点，并提供 DateTimeFormatter 的常见实现：

DateTimeFormatterBuilder 提供了更复杂的格式化程序。

主要的日期时间类提供两种方法 - 一种用于格式化 format(DateTimeFormatter formatter) ，另一种用于解析 parse(CharSequence text, DateTimeFormatter formatter) 。

例如：

除了格式之外，还可以使用所需的 Locale、Chronology、ZoneId 和 DecimalStyle 创建格式化程序。

withLocale 方法返回一个覆盖locale的新格式化程序。locale会影响格式化和解析的某些方面。例如，ofLocalizedDate 提供了一个使用区域设置特定日期格式的格式化程序。

withChronology 方法返回一个覆盖年表的新格式化程序。如果被覆盖，日期时间值将在格式化之前转换为年表。在解析期间，日期时间值在返回之前被转换为年表。

withZone 方法返回一个覆盖区域的新格式化程序。如果被覆盖，日期时间值将在格式化之前转换为具有请求的 ZoneId 的 ZonedDateTime。在解析期间，在返回值之前应用 ZoneId。

withDecimalStyle 方法返回一个覆盖 DecimalStyle 的新格式化程序。 DecimalStyle 符号用于格式化和解析。

某些应用程序可能需要使用旧的 java.text.Format 类进行格式化。 toFormat() 方法返回 java.text.Format 的实现。

例如：

所有字母“A”到“Z”和“a”到“z”都保留为模式字母。定义了以下模式字母：

模式字母的数量决定了格式。

Text：文本样式根据使用的模式字母的数量确定。少于 4 个模式字母将使用 short form 。恰好 4 个模式字母将使用 full form 。恰好 5 个模式字母将使用 narrow form 。模式字母“L”、“c”和“q”指定文本样式的独立形式。

Number：如果字母数为 1，则使用最小位数输出值且不进行填充。否则，位数用作输出字段的宽度，必要时用零填充值。以下模式字母对字母数有限制。只能指定 'c' 和 'F' 中的一个字母。最多可以指定“d”、“H”、“h”、“K”、“k”、“m”和“s”两个字母。最多可以指定三个字母“D”。

数字/文本：如果模式字母的数量为 3 或更多，请使用上面的文本规则。否则使用上面的数字规则。

分数: 以秒的分数形式输出纳秒级字段。纳秒值有九位，因此模式字母的个数为1到9。如果小于9，则纳秒值被截断，只输出最高有效位。

Year：字母数决定最小字段宽度，低于该宽度使用填充。如果字母数是两个，则使用 reduced 两位数形式。对于打印，这会输出最右边的两位数字。对于解析，这将使用 2000 的基值进行解析，从而得到 2000 到 2099（含）范围内的年份。如果字母数少于四个（但不是两个），则根据 SignStyle.NORMAL 仅输出负数年份的符号。否则，如果超出焊盘宽度，则输出符号，如 SignStyle.EXCEEDS_PAD 。

ZoneId：这会输出时区 ID，例如“欧洲/巴黎”。如果字母数为二，则输出时区 ID。任何其他字母计数都会抛出 IllegalArgumentException 。

区域名称：输出时区 ID 的显示名称。如果模式字母是“z”，则输出是夏令时感知区域名称。如果没有足够的信息来确定是否适用夏令时，将使用忽略夏令时的名称。如果字母数为一、二或三，则输出短名称。如果字母数为四个，则输出全名。五个或更多字母抛出 IllegalArgumentException 。

如果模式字母为“v”，则输出提供区域名称，忽略夏令时。如果字母数为一，则输出短名称。如果字母数为四个，则输出全名。两个、三个和五个或更多字母抛出 IllegalArgumentException 。

偏移 X 和 x：这会根据模式字母的数量来格式化偏移量。一个字母只输出小时，例如“+01”，除非分钟不为零，在这种情况下也会输出分钟，例如“+0130”。两个字母输出小时和分钟，不带冒号，如'+0130'。三个字母输出小时和分钟，带冒号，如'+01:30'。四个字母输出小时和分钟以及可选的秒，没有冒号，例如'+013015'。五个字母输出小时和分钟以及可选的秒，带有冒号，例如'+01:30:15'。六个或更多字母抛出 IllegalArgumentException 。当要输出的偏移量为零时，模式字母“X”（大写）将输出“Z”，而模式字母“x”（小写）将输出“+00”、“+0000”或“+00” :00'。

偏移 O：对于非零偏移量，这会根据模式字母的数量格式化本地化偏移量。一个字母输出本地化偏移量的short形式，即本地化偏移量文本，例如'GMT'，小时不带前导零，如果非零则可选2位分秒，以及冒号，例如'GMT+8 '.四个字母输出 满的 形式，这是本地化的偏移文本，例如“GMT”，具有 2 位数字小时和分钟字段，如果第二个字段非零，则可选，还有冒号，例如“GMT+08:00”。如果偏移量为零，则仅输出本地化文本。任何其他字母计数都会抛出 IllegalArgumentException 。

偏移 Z：这会根据模式字母的数量来格式化偏移量。一、二或三个字母输出小时和分钟，不带冒号，如'+0130'。当偏移量为零时，输出将为“+0000”。四个字母输出满的形式的局部偏移量，相当于四个字母的Offset-O。如果偏移量为零，则输出将是相应的本地化偏移量文本。五个字母输出小时、分钟，如果非零则带有可选的秒，带有冒号。如果偏移量为零，则输出“Z”。六个或更多字母抛出 IllegalArgumentException 。

可选部分：可选部分标记的工作方式与调用 DateTimeFormatterBuilder.optionalStart() 和 DateTimeFormatterBuilder.optionalEnd() 完全相同。

焊盘修饰符: 修改紧随其后的模式以用空格填充。焊盘宽度由模式字母的数量决定。这与调用 DateTimeFormatterBuilder.padNext(int) 相同。

例如，'ppH' 输出在左侧用宽度为 2 的空格填充的一天中的小时数。

任何无法识别的字母都是错误的。除了'['、']'、'{'、'}'、'#'和单引号之外的任何非字母字符都将被直接输出。尽管如此，还是建议在您要直接输出的所有字符周围使用单引号，以确保将来的更改不会破坏您的应用程序。

此类提供了五种解析方法。其中四个执行解析和解析阶段。第五个方法 parseUnresolved(CharSequence, ParsePosition) 仅执行第一阶段，结果未解决。因此，它本质上是一个低级操作。

解析阶段由在此类上设置的两个参数控制。

ResolverStyle 是一个枚举，它提供三种不同的方法：严格、智能和宽松。智能选项是默认选项。可以使用 withResolverStyle(ResolverStyle) 进行设置。

withResolverFields(TemporalField...) 参数允许在解析开始之前过滤要解析的字段集。例如，如果格式化程序已经解析了年、月、月中日和年中日，那么有两种方法来解析日期：(年+月+月中日)和(年+年）。解析器字段允许选择两种方法之一。如果未设置解析器字段，则两种方法必须产生相同的日期。

解析单独的字段以形成完整的日期和时间是一个复杂的过程，其行为分布在多个类中。它遵循以下步骤：