如何使用 LocalDateTime 解析/格式化日期？ （Java 8）

解析日期和时间

要从字符串创建 LocalDateTime 对象，您可以使用静态 LocalDateTime.parse() 方法。它接受一个字符串和一个 DateTimeFormatter 作为参数。 DateTimeFormatter 用于指定日期/时间模式。

String str = "1986-04-08 12:30";
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");
LocalDateTime dateTime = LocalDateTime.parse(str, formatter);

格式化日期和时间

要从 LocalDateTime 对象创建格式化字符串，您可以使用 format() 方法。

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");
LocalDateTime dateTime = LocalDateTime.of(1986, Month.APRIL, 8, 12, 30);
String formattedDateTime = dateTime.format(formatter); // "1986-04-08 12:30"

请注意，有一些常用的日期/时间格式在 DateTimeFormatter 中预定义为常量。例如：使用 DateTimeFormatter.ISO_DATE_TIME 格式化上面的 LocalDateTime 实例将产生字符串 "1986-04-08T12:30:00"。

parse() 和 format() 方法可用于所有与日期/时间相关的对象（例如 LocalDate 或 ZonedDateTime）

---

如果 String 在 ISO-8601 format 中，您也可以在 String 上使用 LocalDate.parse() 或 LocalDateTime.parse() 而无需为其提供模式。

例如，

String strDate = "2015-08-04";
LocalDate aLD = LocalDate.parse(strDate);
System.out.println("Date: " + aLD);

String strDatewithTime = "2015-08-04T10:11:30";
LocalDateTime aLDT = LocalDateTime.parse(strDatewithTime);
System.out.println("Date with Time: " + aLDT);

输出，

Date: 2015-08-04
Date with Time: 2015-08-04T10:11:30

并且仅当您必须处理其他日期模式时才使用 DateTimeFormatter。

例如，在以下示例中，dd MMM uuuu 表示月份中的日期（两位数）、月份名称的三个字母（Jan、Feb、Mar、...）和四位数的年份：

DateTimeFormatter dTF = DateTimeFormatter.ofPattern("dd MMM uuuu");
String anotherDate = "04 Aug 2015";
LocalDate lds = LocalDate.parse(anotherDate, dTF);
System.out.println(anotherDate + " parses to " + lds);

输出

04 Aug 2015 parses to 2015-08-04

还要记住 DateTimeFormatter 对象是双向的；它既可以解析输入也可以格式化输出。

String strDate = "2015-08-04";
LocalDate aLD = LocalDate.parse(strDate);
DateTimeFormatter dTF = DateTimeFormatter.ofPattern("dd MMM uuuu");
System.out.println(aLD + " formats as " + dTF.format(aLD));

输出

2015-08-04 formats as 04 Aug 2015

（见完整的 list of Patterns for Formatting and Parsing DateFormatter）

  Symbol  Meaning                     Presentation      Examples
  ------  -------                     ------------      -------
   G       era                         text              AD; Anno Domini; A
   u       year                        year              2004; 04
   y       year-of-era                 year              2004; 04
   D       day-of-year                 number            189
   M/L     month-of-year               number/text       7; 07; Jul; July; J
   d       day-of-month                number            10

   Q/q     quarter-of-year             number/text       3; 03; Q3; 3rd quarter
   Y       week-based-year             year              1996; 96
   w       week-of-week-based-year     number            27
   W       week-of-month               number            4
   E       day-of-week                 text              Tue; Tuesday; T
   e/c     localized day-of-week       number/text       2; 02; Tue; Tuesday; T
   F       week-of-month               number            3

   a       am-pm-of-day                text              PM
   h       clock-hour-of-am-pm (1-12)  number            12
   K       hour-of-am-pm (0-11)        number            0
   k       clock-hour-of-am-pm (1-24)  number            0

   H       hour-of-day (0-23)          number            0
   m       minute-of-hour              number            30
   s       second-of-minute            number            55
   S       fraction-of-second          fraction          978
   A       milli-of-day                number            1234
   n       nano-of-second              number            987654321
   N       nano-of-day                 number            1234000000

   V       time-zone ID                zone-id           America/Los_Angeles; Z; -08:30
   z       time-zone name              zone-name         Pacific Standard Time; PST
   O       localized zone-offset       offset-O          GMT+8; GMT+08:00; UTC-08:00;
   X       zone-offset 'Z' for zero    offset-X          Z; -08; -0830; -08:30; -083015; -08:30:15;
   x       zone-offset                 offset-x          +0000; -08; -0830; -08:30; -083015; -08:30:15;
   Z       zone-offset                 offset-Z          +0000; -0800; -08:00;

   p       pad next                    pad modifier      1

   '       escape for text             delimiter
   ''      single quote                literal           '
   [       optional section start
   ]       optional section end
   #       reserved for future use
   {       reserved for future use
   }       reserved for future use

---

上面的两个答案都很好地解释了有关字符串模式的问题。但是，如果您正在使用 ISO 8601，则无需应用 DateTimeFormatter，因为 LocalDateTime 已经为此做好了准备：

将 LocalDateTime 转换为时区 ISO8601 字符串

LocalDateTime ldt = LocalDateTime.now(); 
ZonedDateTime zdt = ldt.atZone(ZoneOffset.UTC); //you might use a different zone
String iso8601 = zdt.toString();

从 ISO8601 字符串转换回 LocalDateTime

String iso8601 = "2016-02-14T18:32:04.150Z";
ZonedDateTime zdt = ZonedDateTime.parse(iso8601);
LocalDateTime ldt = zdt.toLocalDateTime();

---

将带有日期和时间的字符串解析为特定时间点（Java 将其称为“Instant”）非常复杂。 Java 已经在多次迭代中解决了这个问题。最新的 java.time 和 java.time.chrono 几乎涵盖了所有需求（Time Dilation :) 除外。

然而，这种复杂性带来了很多混乱。

理解日期解析的关键是：

为什么Java有这么多解析日期的方法

有几个系统可以测量时间。例如，历史上的日本历法是从各个天皇或朝代在位的时间范围派生出来的。然后是例如 UNIX 时间戳。幸运的是，整个（商业）世界都设法使用它。从历史上看，出于各种原因，系统正在从/到切换。例如，从 1582 年的儒略历到公历。因此，在此之前的“西方”日期需要区别对待。当然，这种变化并不是一蹴而就的。因为日历来自某些宗教的总部，而欧洲其他地区则信仰其他宗教，例如德国直到 1700 年才转换。

...为什么是 LocalDateTime、ZonedDateTime 等。太复杂了

有时区。时区基本上是地球表面的“条纹”* [1]，其权威遵循相同的规则，即何时具有哪个时间偏移。这包括夏令时规则。不同地区的时区随时间而变化，主要取决于谁征服了谁。一个时区的规则也会随着时间而改变。有时间偏移。这与时区不同，因为时区可能是例如“布拉格”，但它具有夏季时间偏移和冬季时间偏移。如果您获得带有时区的时间戳，则偏移量可能会有所不同，具体取决于它所在的年份。在闰小时，时间戳可能意味着 2 个不同的时间，因此如果没有额外的信息，它就不能可靠转换。注意：时间戳我的意思是“一个包含日期和/或时间的字符串，可以选择带有时区和/或时间偏移量。”几个时区可能在某些时期共享相同的时间偏移。例如，当夏令时偏移无效时，GMT/UTC 时区与“伦敦”时区相同。

让它更复杂一点（但这对你的用例来说不是太重要）：

科学家们观察地球的动态，随着时间的推移而变化；基于此，他们在个别年份结束时增加秒数。 （因此 2040-12-31 24:00:00 可能是一个有效的日期时间。）这需要定期更新系统使用的元数据，以便正确进行日期转换。例如，在 Linux 上，您会定期更新 Java 包，包括这些新数据。更新并不总是保留历史和未来时间戳的先前行为。因此，当在不同版本的软件上运行时，解析两个时间戳围绕某个时区的变化进行比较可能会产生不同的结果。这也适用于比较受影响的时区和其他时区。如果这会导致您的软件出现错误，请考虑使用一些没有如此复杂规则的时间戳，例如 UNIX 时间戳。由于 7，对于未来的日期，我们无法确定地准确转换日期。因此，例如，当前对 8524-02-17 12:00:00 的解析可能与未来的解析相差几秒钟。

JDK 的 API 随当代需求而发展

早期的 Java 版本只有 java.util.Date，它的方法有点幼稚，假设只有年、月、日和时间。这很快就不够了。

另外，数据库的需求不同，所以很早就引入了java.sql.Date，但也有其自身的局限性。

因为两者都没有很好地涵盖不同的日历和时区，所以引入了 Calendar API。

这仍然没有涵盖时区的复杂性。然而，上述 API 的混合使用起来确实很痛苦。因此，随着 Java 开发人员开始致力于全球 Web 应用程序，针对大多数用例的库（如 JodaTime）迅速流行起来。 JodaTime 是大约十年来的事实标准。

但是 JDK 没有与 JodaTime 集成，所以使用它有点麻烦。所以，在对如何处理这个问题进行了很长时间的讨论之后，主要基于 JodaTime 创建了 JSR-310。

如何在 Java 的 java.time 中处理它

确定将时间戳解析为什么类型

当您使用时间戳字符串时，您需要知道它包含哪些信息。这是关键点。如果你做的不对，你最终会得到一个神秘的异常，比如“无法创建即时”或“区域偏移丢失”或“未知区域 id”等。

无法从 TemporalAccessor 获取 OffsetDateTime

无法从 TemporalAccessor 获取 ZonedDateTime

无法从 TemporalAccessor 获取 LocalDateTime

无法从 TemporalAccessor 获取 Instant

它是否包含日期和时间？

它有时间偏移吗？时间偏移是 +hh:mm 部分。有时，+00:00 可以用 Z 代替“祖鲁时间”，UTC 代替世界协调时间，或 GMT 代替格林威治标准时间。这些也设置了时区。对于这些时间戳，您使用 OffsetDateTime。它有时区吗？对于这些时间戳，您使用 ZonedDateTime。区域由名称（“布拉格”、“太平洋标准时间”、“PST”）或“区域 ID”（“America/Los_Angeles”、“Europe/London”）指定，由 java.time.ZoneId 表示。时区列表由 ICAAN 支持的“TZ 数据库”编制。根据 ZoneId 的 javadoc，区域 id 也可以以某种方式指定为 Z 和偏移量。我不确定这如何映射到真实区域。如果只有 TZ 的时间戳落入时间偏移变化的闰小时，则具有歧义，解释为 ResolverStyle 的主题，见下文。如果两者都没有，则假定或忽略缺少的上下文。消费者必须做出决定。因此需要将其解析为 LocalDateTime 并通过添加缺少的信息转换为 OffsetDateTime：您可以假设它是 UTC 时间。添加 0 小时的 UTC 偏移量。您可以假设这是发生转换的地方的时间。通过添加系统的时区来转换它。您可以忽略并按原样使用它。这很有用，例如比较或减去两次（请参阅持续时间），或者当您不知道并且它并不重要（例如当地巴士时刻表）时。

兼职信息

根据时间戳包含的内容，您可以从中取出 LocalDate、LocalTime、OffsetTime、MonthDay、Year 或 YearMonth。

如果您有完整的信息，您可以获得java.time.Instant。这也在内部用于在 OffsetDateTime 和 ZonedDateTime 之间进行转换。

弄清楚如何解析它

DateTimeFormatter 上有大量文档，它既可以解析时间戳字符串，也可以将格式转换为字符串。

pre-created DateTimeFormatters 应该涵盖更多的所有标准时间戳格式。例如，ISO_INSTANT 可以解析 2011-12-03T10:15:30.123457Z。

如果你有一些特殊的格式，那么你可以create your own DateTimeFormatter（它也是一个解析器）。

private static final DateTimeFormatter TIMESTAMP_PARSER = new DateTimeFormatterBuilder()
   .parseCaseInsensitive()
   .append(DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss.SX"))
   .toFormatter();

我建议查看 DateTimeFormatter 的源代码，并获得有关如何使用 DateTimeFormatterBuilder 构建的灵感。当您在那里时，还请查看 ResolverStyle，它控制解析器对于格式和模棱两可的信息是 LENIENT、SMART 还是 STRICT。

时间存取器

现在，常见的错误是进入 TemporalAccessor 的复杂性。这源于开发人员习惯于使用 SimpleDateFormatter.parse(String) 的方式。对，DateTimeFormatter.parse("...") 给你 TemporalAccessor。

// No need for this!
TemporalAccessor ta = TIMESTAMP_PARSER.parse("2011-... etc");

但是，借助上一节的知识，您可以方便地解析为您需要的类型：

OffsetDateTime myTimestamp = OffsetDateTime.parse("2011-12-03T10:15:30.123457Z", TIMESTAMP_PARSER);

您实际上也不需要 DateTimeFormatter。您要解析的类型具有 parse(String) 方法。

OffsetDateTime myTimestamp = OffsetDateTime.parse("2011-12-03T10:15:30.123457Z");

关于 TemporalAccessor，如果您对字符串中包含哪些信息有一个模糊的概念，并且想要在运行时决定，则可以使用它。

我希望我能对你的灵魂有所了解:)

注意：java.time 向后移植到 Java 6 和 7：ThreeTen-Backport。对于 Android，它具有 ThreeTenABP。

[1] 不仅它们不是条纹，而且还有一些奇怪的极端。例如，some neighboring pacific islands 有 +14:00 和 -11:00 时区。这意味着，虽然在一个岛上，有 5 月 1 日下午 3 点，但在另一个岛上不远，它仍然是 4 月 30 日下午 12 点（如果我计算正确的话:)）

---

以所需格式获取当前 UTC 时间

// Current UTC time
        OffsetDateTime utc = OffsetDateTime.now(ZoneOffset.UTC);

        // GET LocalDateTime 
        LocalDateTime localDateTime = utc.toLocalDateTime();
        System.out.println("*************" + localDateTime);

        // formated UTC time
        DateTimeFormatter dTF = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");
        System.out.println(" formats as " + dTF.format(localDateTime));

        //GET UTC time for current date
        Date now= new Date();
        LocalDateTime utcDateTimeForCurrentDateTime = Instant.ofEpochMilli(now.getTime()).atZone(ZoneId.of("UTC")).toLocalDateTime();
        DateTimeFormatter dTF2 = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm");
        System.out.println(" formats as " + dTF2.format(utcDateTimeForCurrentDateTime));

---

LocalDateTime.parse 需要注意的另一件事是，您不能将它与只有日期格式化字符的自定义格式化程序一起使用，例如 uuuuMMdd。在这种情况下，您应该改用 LocalDate.parse。例如：

String s = "20210223";
        
// ok
LocalDate.parse(s, DateTimeFormatter.ofPattern("uuuuMMdd"));
        
// java.time.format.DateTimeParseException
LocalDateTime.parse(s, DateTimeFormatter.ofPattern("uuuuMMdd")); 

---

让我们来回答两个问题，例如字符串 "2014-04-08 12:30"

如何从给定的字符串中获取 LocalDateTime 实例？

import java.time.format.DateTimeFormatter
import java.time.LocalDateTime

final DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm")

// Parsing or conversion
final LocalDateTime dt = LocalDateTime.parse("2014-04-08 12:30", formatter)

dt 应该允许您进行所有与日期时间相关的操作

然后如何将 LocalDateTime 实例转换回具有相同格式的字符串？

final String date = dt.format(formatter) 

---

所有的答案都很好。 java8+ 有以下模式用于解析和格式化时区：V、z、O、X、x、Z。

根据文档中的规则，它们是用于解析的：

   Symbol  Meaning                     Presentation      Examples
   ------  -------                     ------------      -------
   V       time-zone ID                zone-id           America/Los_Angeles; Z; -08:30
   z       time-zone name              zone-name         Pacific Standard Time; PST
   O       localized zone-offset       offset-O          GMT+8; GMT+08:00; UTC-08:00;
   X       zone-offset 'Z' for zero    offset-X          Z; -08; -0830; -08:30; -083015; -08:30:15;
   x       zone-offset                 offset-x          +0000; -08; -0830; -08:30; -083015; -08:30:15;
   Z       zone-offset                 offset-Z          +0000; -0800; -08:00;

但是格式化呢？下面是一个日期示例（假设为 ZonedDateTime），它显示了针对不同格式模式的这些模式行为：

// The helper function:
static void printInPattern(ZonedDateTime dt, String pattern) {
    System.out.println(pattern + ": " + dt.format(DateTimeFormatter.ofPattern(pattern)));
}        

// The date:
String strDate = "2020-11-03 16:40:44 America/Los_Angeles";
DateTimeFormatter format = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss zzzz");
ZonedDateTime dt = ZonedDateTime.parse(strDate, format);
// 2020-11-03T16:40:44-08:00[America/Los_Angeles]

// Rules:
// printInPattern(dt, "V");     // exception!
printInPattern(dt, "VV");       // America/Los_Angeles
// printInPattern(dt, "VVV");   // exception!
// printInPattern(dt, "VVVV");  // exception!
printInPattern(dt, "z");        // PST
printInPattern(dt, "zz");       // PST
printInPattern(dt, "zzz");      // PST
printInPattern(dt, "zzzz");     // Pacific Standard Time
printInPattern(dt, "O");        // GMT-8
// printInPattern(dt, "OO");    // exception!
// printInPattern(dt, "OO0");   // exception!
printInPattern(dt, "OOOO");     // GMT-08:00
printInPattern(dt, "X");        // -08
printInPattern(dt, "XX");       // -0800
printInPattern(dt, "XXX");      // -08:00
printInPattern(dt, "XXXX");     // -0800
printInPattern(dt, "XXXXX");    // -08:00
printInPattern(dt, "x");        // -08
printInPattern(dt, "xx");       // -0800
printInPattern(dt, "xxx");      // -08:00
printInPattern(dt, "xxxx");     // -0800
printInPattern(dt, "xxxxx");    // -08:00
printInPattern(dt, "Z");        // -0800
printInPattern(dt, "ZZ");       // -0800
printInPattern(dt, "ZZZ");      // -0800
printInPattern(dt, "ZZZZ");     // GMT-08:00
printInPattern(dt, "ZZZZZ");    // -08:00

在正偏移的情况下，+ 符号字符在任何地方都使用（现在有 -）并且从不省略。

这适用于新的 java.time 类型。如果您打算将这些用于 java.util.Date 或 java.util.Calendar - 由于这些类型已损坏（并因此标记为已弃用，请不要使用它们），因此并非所有都可以使用

---

我发现像这样涵盖日期时间格式的多种变体非常棒：

final DateTimeFormatterBuilder dtfb = new DateTimeFormatterBuilder();
dtfb.appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSSSS"))
.appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSSS"))
.appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS"))
.appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSS"))
.appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSS"))
.appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSS"))
    .appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSS"))
    .appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SS"))
    .appendOptional(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.S"))
    .parseDefaulting(ChronoField.HOUR_OF_DAY, 0)
    .parseDefaulting(ChronoField.MINUTE_OF_HOUR, 0)
    .parseDefaulting(ChronoField.SECOND_OF_MINUTE, 0);

---