如何使用LocalDateTime解析/格式化日期? (Java 8)

时间:2014-03-17 19:00:02

标签: java datetime java-8 java-time

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

我将日期和时间作为字符串(例如"2014-04-08 12:30")。如何从给定字符串中获取LocalDateTime实例?

使用LocalDateTime对象后,我怎样才能将LocalDateTime实例转换回与上面显示格式相同的字符串?

9 个答案:

答案 0 :(得分:464)

解析日期和时间

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

答案 1 :(得分:130)

如果LocalDate.parse()位于ISO-8601 format,您也可以在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

(参见完整的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

答案 2 :(得分:31)

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

答案 3 :(得分:3)

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

但是,这种复杂性带来了很多混乱。

了解日期解析的关键是:

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

  1. 有几种测量时间的系统。例如,日本的历史日历是从各个皇帝或王朝统治的时间范围得出的。然后有例如UNIX时间戳。 幸运的是,整个(商业)世界都使用了相同的东西。
  2. 从历史上看,various reasons的系统是从/切换到的。例如。从儒略历到1582年的格里高利历。因此,在此之前的“西方”日期需要区别对待。
  3. 当然,更改不会立即发生。因为日历来自某些宗教的起源,而欧洲其他地区则相信其他饮食习惯,例如德国直到1700年才转换。

...以及LocalDateTimeZonedDateTime等的原因。如此复杂

  1. time zones。 时区基本上是地球表面的“条带” * [1] ,其权限遵循何时具有哪个时间偏移的相同规则。这包括夏季时间规则。
    时区会随时间变化,各个地区的变化主要取决于谁征服谁。还有一个时区的规则change over time

  2. 存在时间偏移。这与时区不同,因为时区可能是“布拉格”,但具有夏令时偏移和冬令时偏移。
    如果获得带时区的时间戳,则偏移量可能会有所不同,具体取决于所在的年份。在the年期间,时间戳可能表示2个不同的时间,因此如果没有其他信息,它就无法可靠地显示出来。已转换。
    注意: timestamp 的意思是“包含日期和/或时间,以及时区和/或时间偏移的字符串。”

  3. 在某些时段中,多个时区可能共享相同的时间偏移。例如,夏令时未生效时,GMT / UTC时区与“伦敦”时区相同。

要使其复杂一点(但这对您的用例而言并不重要):

    科学家观察地球的动态,随着时间的推移而变化;基于此,它们在各个年份的末尾增加了几秒钟。 (因此2040-12-31 24:00:00可能是有效的日期时间。)这需要定期更新元数据,系统使用这些元数据来进行日期转换。例如。在Linux上,您会定期更新Java软件包,包括这些新数据。
  1. 更新并不总是保留历史和未来时间戳的先前行为。因此,当在不同版本的软件上运行时,围绕某个时区变化的两个时间戳的解析可能会比较它们may give different results,从而发生这种情况。这也适用于在受影响的时区和其他时区之间进行比较。

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

  2. 由于值为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集成,因此使用它有点麻烦。因此,在就如何解决此问题进行了很长时间的讨论之后,JSR-310被创建为mainly based on JodaTime

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

确定将时间戳解析为哪种类型

使用时间戳字符串时,您需要知道它包含哪些信息。 这是关键点。如果您做不到这一点,则会遇到诸如“无法创建即时”或“缺少区域偏移”或“未知区域ID”之类的神秘异常。

其中是否包含日期和时间?

  1. 它有时间偏移吗?
    时间偏移是+hh:mm部分。有时,+00:00可以用Z替换为'Zulu time',用UTC替换为通用时间,或者用GMT替换为格林威治标准时间。这些也会设置时区。
    对于这些时间戳,请使用OffsetDateTime

  2. 它有时区吗?
    对于这些时间戳,请使用ZonedDateTime
    区域由

    指定
    • 名称(“布拉格”,“太平洋标准时间”,“ PST”)或
    • java.time.ZoneId表示的“区域ID”(“美国/洛杉矶”,“欧洲/伦敦”)。

    时区列表由"TZ database"编译,并得到ICAAN的支持。

    根据ZoneId的javadoc,区域ID也可以以某种方式指定为Z和偏移量。我不确定这是如何映射到真实区域的。 如果只有TZ的时间戳落入时间偏移量变化的a时间,则表示该模棱两可,并且解释受ResolverStyle的约束,请参见下文。

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

    • 您可以假定为UTC时间。添加0小时的UTC偏移量。
    • 您可以假设这是进行转换的时间。通过添加系统的时区进行转换。
    • 您可以忽略,并按原样使用它。这很有用,例如比较或减去两次(请参阅Duration),或者在您不知道或不重要的时候进行比较或减去(例如,当地公交时刻表)。

部分时间信息

  • 根据时间戳记,您可以取出LocalDateLocalTimeOffsetTimeMonthDayYearYearMonth

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

弄清楚如何解析

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

现在,常见的错误是进入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点(如果我算错了:))

答案 4 :(得分:3)

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

答案 5 :(得分:1)

所有答案都很好。 java8+ 有以下模式来解析和格式化时区:VzOXxZ

根据文档中的规则,它们是解析

   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.Datejava.util.Calendar - 并非所有类型都能正常工作,因为这些类型已损坏(因此标记为已弃用,请不要使用它们)

答案 6 :(得分:1)

使用 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")); 

答案 7 :(得分:0)

我发现覆盖这样的日期时间格式的多种变体非常好:

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

答案 8 :(得分:0)

让我们问两个问题,例如字符串"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)