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

Question

Java 8 添加了一个新的java.time API 用于处理日期和时间 ( JSR 310 )。

我有日期和时间作为字符串（例如"2014-04-08 12:30"）。如何LocalDateTime从给定的字符串中获取实例？

处理完LocalDateTime对象后：如何将LocalDateTime实例转换回具有与上所示相同格式的字符串？

Answer 1

解析日期和时间

要从字符串创建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()LocalDateZonedDateTime

Answer 2

如果是ISO-8601 格式，您也可以在不提供模式的情况下使用LocalDate.parse()or 。LocalDateTime.parse()StringString

例如，

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

（请参阅格式化和解析 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

Answer 3

上面的两个答案都很好地解释了有关字符串模式的问题。但是，如果您使用的是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();

Answer 4

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

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

理解日期解析的关键是：

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

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

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

4. 有时区。时区基本上是地球表面的“条纹” * [1] ，其权威遵循相同的规则，即何时具有哪个时间偏移。这包括夏令时规则。
   不同地区的时区随时间而变化，主要取决于谁征服了谁。一个时区的规则也会随着时间而改变。

5. 有时间偏移。这与时区不同，因为时区可能是例如“布拉格”，但它具有夏季时间偏移和冬季时间偏移。
   如果您获得带有时区的时间戳，则偏移量可能会有所不同，具体取决于它所在的年份。在闰小时，时间戳可能意味着 2 个不同的时间，因此如果没有额外的信息，它就不能可靠转换。
   注意：时间戳我的意思是“一个包含日期和/或时间的字符串，可以选择带有时区和/或时间偏移量。”

6. 几个时区可能在某些时期共享相同的时间偏移。例如，当夏令时偏移无效时，GMT/UTC 时区与“伦敦”时区相同。

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

7. 科学家们观察地球的动态，随着时间的推移而变化；基于此，他们在个别年份结束时增加秒数。（因此2040-12-31 24:00:00可能是一个有效的日期时间。）这需要定期更新系统使用的元数据以正确进行日期转换。例如，在 Linux 上，您会定期更新 Java 包，包括这些新数据。

8. 更新并不总是保留历史和未来时间戳的先前行为。因此，当在不同版本的软件上运行时，解析两个时间戳围绕某个时区的变化进行比较可能会产生不同的结果。这也适用于比较受影响的时区和其他时区。

   如果这会导致您的软件出现错误，请考虑使用一些没有如此复杂规则的时间戳，例如UNIX 时间戳。

9. 由于 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

它是否包含日期和时间？

1. 它有时间偏移吗？
   时间偏移是+hh:mm一部分。有时，+00:00可替换Z为“祖鲁时间”、UTC协调世界时或GMT格林威治标准时间。这些也设置了时区。
   对于这些时间戳，您使用OffsetDateTime.

2. 它有时区吗？
   对于这些时间戳，您使用ZonedDateTime.
   区域由以下方式指定

   • 名称（“布拉格”、“太平洋标准时间”、“PST”），或
   • “zone ID”（“America/Los_Angeles”、“Europe/London”），由java.time.ZoneId表示。

   时区列表由 ICAAN 支持的“TZ 数据库”编制。

   根据ZoneId's javadoc，区域 id 也可以以某种方式指定为Z和偏移量。我不确定这如何映射到真实区域。如果只有 TZ 的时间戳落入时间偏移变化的闰小时，则为模棱两可，解释为ResolverStyle，见下文。

3. 如果两者都没有，则假定或忽略缺少的上下文。消费者必须做出决定。因此需要将其解析为并通过添加缺少的信息LocalDateTime转换为：OffsetDateTime

   • 您可以假设它是 UTC 时间。添加 0 小时的 UTC 偏移量。
   • 您可以假设这是发生转换的地方的时间。通过添加系统的时区来转换它。
   • 您可以忽略并按原样使用它。这很有用，例如比较或减去两次（请参阅Duration），或者当您不知道并且它并不重要时（例如当地的巴士时刻表）。

兼职信息

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

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

弄清楚如何解析它

有一个广泛的文档DateTimeFormatter可以解析时间戳字符串和格式为字符串。

预先创建DateTimeFormatter的s应该涵盖更多的所有标准时间戳格式。例如，ISO_INSTANT可以解析2011-12-03T10:15:30.123457Z.

如果你有一些特殊的格式，那么你可以创建你自己的 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.timeJava 6 和 7 有一个向后移植：ThreeTen-Backport。对于 Android，它具有ThreeTenABP。

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

Answer 5

以所需格式获取当前 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));

Answer 6

需要注意的另一件事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")); 

Answer 7

所有的答案都很好。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- 由于这些类型已损坏（并因此标记为已弃用，请不要使用它们）

Answer 8

让我们回答两个问题，示例字符串"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)

Answer 9

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

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);