如何使用 Java 解析 RFC 3339 日期时间？

Question

我正在尝试解析从 HTML5 datetime 输入字段返回的日期。在 Opera 中尝试一下以查看示例。返回的日期如下所示：2011-05-03T11:58:01Z。

我想将其解析为 Java 日期或日历对象。

理想情况下，解决方案应具有以下内容：

• 没有外部库（jar）
• 处理所有可接受的 RFC 3339 格式
• 应该能够轻松验证字符串以查看它是否是有效的 RFC 3339 日期

Answer 1

tl;dr

Instant.parse( "2011-05-03T11:58:01Z" )

ISO 8601

实际上，RFC 3339 只是一个自称的“配置文件”实际标准 ISO 8601。

RFC 的不同之处在于，它故意违反 ISO 8601，允许零小时 (-00:00) 的负偏移，并赋予其“偏移未知”的语义含义。对我来说，这种语义似乎是一个非常糟糕的主意。我建议坚持更明智的 ISO 8601 规则。在 ISO 8601 中，根本没有偏移量意味着偏移量未知——这是一个显而易见的含义，而 RFC 规则则很深奥。

现代 java.time 类在解析/生成字符串时默认使用 ISO 8601 格式。

您的输入字符串代表 UTC 中的某个时刻。末尾的 Z 是 Zulu 的缩写，表示 UTC。

Instant（不是Date）

现代类Instant 表示UTC 中的某个时刻。此类替换 java.util.Date，并使用纳秒而不是毫秒的更精细分辨率。

Instant instant = Instant.parse( "2011-05-03T11:58:01Z" ) ;

ZonedDateTime（不是 Calendar）

要通过特定区域（时区）的人们使用的挂钟时间查看同一时刻，请应用 ZoneId 获取 ZonedDateTime。此类 ZonedDateTime 替换 <代码>java.util.Calendar类。

ZoneId z = ZoneId.of( "Africa/Tunis" ) ;
ZonedDateTime zdt = instant.atZone( z ) ;  // Same moment, same point on the timeline, different wall-clock time.

转换

我强烈建议尽可能避免使用遗留的日期时间类。但是，如果您必须与尚未更新到 java.time 的旧代码进行互操作，则可以来回转换。调用添加到旧类中的新方法。

Instant 取代了 java.util.Date。

java.util.Date myJUDate = java.util.Date.from( instant ) ;  // From modern to legacy.
Instant instant = myJUDate.toInstant() ;                    // From legacy to modern.

ZonedDateTime 取代 GregorianCalendar。

java.util.GregorianCalendar myGregCal = java.util.GregorianCalendar.from( zdt ) ;  // From modern to legacy.
ZonedDateTime zdt = myGregCal.toZonedDateTime() ;           // From legacy to modern.

如果您的 java.util.Calendar 实际上是 GregorianCalendar，请进行强制转换。

java.util.GregorianCalendar myGregCal = ( java.util.GregorianCalendar ) myCal ;  // Cast to the concrete class.
ZonedDateTime zdt = myGregCal.toZonedDateTime() ;           // From legacy to modern.

项目符号关注点

关于您的问题的具体问题...

• 没有外部库（jar）

java.time 类内置于 Java 8、9、10 及更高版本中。后来的 Android 中也包含了一个实现。对于早期的 Java 和早期的 Android，请参阅本答案的下一部分。

• 处理所有可接受的 RFC 3339 格式

各种 java.time 类可以处理我所知道的每种 ISO 8601 格式。他们甚至处理一些从标准的后续版本中神秘消失的格式。

对于其他格式，请参阅各种类的 parse 和 toString 方法，例如 LocalDate、OffsetDateTime 等在。另外，请搜索 Stack Overflow，因为有许多关于此主题的示例和讨论。

• 应该能够轻松验证字符串以查看它是否是有效的 RFC 3339 日期

要验证输入字符串，请捕获 DateTimeParseException。

try {
    Instant instant = Instant.parse( "2011-05-03T11:58:01Z" ) ;
} catch ( DateTimeParseException e ) {
    … handle invalid input
}

---

关于 java.time

java.time 框架内置于 Java 8 及更高版本中。这些类取代了麻烦的旧遗留日期时间类，例如java.util.Date，日历，& SimpleDateFormat。

Joda-Time 项目，现已在 维护模式，建议迁移到 java.time 类。

要了解更多信息，请参阅 Oracle 教程 。并在 Stack Overflow 上搜索许多示例和解释。规范为 JSR 310。

您可以直接与数据库交换java.time对象。使用符合 JDBC 驱动程序 jeps/170" rel="noreferrer">JDBC 4.2 或更高版本。不需要字符串，不需要 java.sql.* 类。

从哪里获取 java.time 类？

• Java SE 8，Java SE 9 以及更高版本的
• 内置版本。
• 具有捆绑实现的标准 Java API 的一部分。
• Java 9 添加了一些小功能和修复。
• Java SE 6 和 Java SE 7
• 许多 java.time 功能向后移植到 Java 6 和 Java 6。 7 ThreeTen-Backport。
• Android
• 更高版本的 Android 捆绑包实现 java.lang.时间类。
• 对于早期的 Android (<26)，ThreeTenABP 项目采用 ThreeTen-Backport（如上所述）。请参阅如何使用 ThreeTenABP...。

ThreeTen-Extra 项目通过附加类扩展了 java.time。该项目是 java.time 未来可能添加的内容的试验场。您可能会在这里找到一些有用的类，例如 Interval ，YearWeek ，YearQuarter ，以及更多。

Answer 2

因此，原则上这将使用不同的 SimpleDateFormat 模式。

以下是 RFC 3339 中的单独声明的模式列表：

• 日期-fullear：yyyy
• 日期-月份：MM
• 日期-mday：dd
• 时间-小时：HH
• 时间-分钟: mm
• time-second: ss
• time-secfrac: .SSS （S 表示毫秒，但它是不清楚如果这些数字多于或少于 3 位会发生什么。）
• time-numoffset: （像 +02:00 似乎不受支持 - 相反，它支持格式 + 0200、GMT+02:00 以及一些使用 z 和 Z 的命名时区。）
• 时间偏移： 'Z'（不支持其他时区） - 在使用此功能之前，您应该使用 format.setTimezone(TimeZone.getTimeZone("UTC"))。）
• 部分时间： HH:mm:ss 或 HH:mm:ss.SSS。
• 全职：HH:mm:ss'Z' 或 HH:mm:ss.SSS'Z'。
• 完整日期：yyyy-MM-dd
• 日期时间：yyyy-MM-dd'T'HH:mm:ss'Z' 或 yyyy-MM -dd'T'HH:mm:ss.SSS'Z'

正如我们所看到的，这似乎无法解析所有内容。也许从头开始实现 RFC3339DateFormat 是一个更好的主意（为了简单起见，使用正则表达式，为了提高效率，使用手动解析）。

Answer 3

刚刚发现谷歌在谷歌HTTP客户端库中实现了Rfc3339解析器

https://github.com/google/google-http-java-client/blob/dev/google-http-client/src /main/java/com/google/api/client/util/DateTime.java

已测试。它可以很好地解析不同的亚秒时间片段。

import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
import java.util.Date;

import com.google.api.client.util.DateTime;

DateTimeFormatter formatter = DateTimeFormatter
            .ofPattern("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'")
            .withZone(ZoneId.of("UTC"));

@Test
public void test1e9Parse() {
    String timeStr = "2018-04-03T11:32:26.553955473Z";

    DateTime dateTime = DateTime.parseRfc3339(timeStr);
    long millis = dateTime.getValue();

    String result = formatter.format(new Date(millis).toInstant());

    assert result.equals("2018-04-03T11:32:26.553Z");
}

@Test
public void test1e3Parse() {
    String timeStr = "2018-04-03T11:32:26.553Z";

    DateTime dateTime = DateTime.parseRfc3339(timeStr);
    long millis = dateTime.getValue();

    String result = formatter.format(new Date(millis).toInstant());

    assert result.equals("2018-04-03T11:32:26.553Z");
}

@Test
public void testEpochSecondsParse() {

    String timeStr = "2018-04-03T11:32:26Z";

    DateTime dateTime = DateTime.parseRfc3339(timeStr);
    long millis = dateTime.getValue();

    String result = formatter.format(new Date(millis).toInstant());

    assert result.equals("2018-04-03T11:32:26.000Z");
}

Answer 4

使用您的格式，例如 2011-05-03T11:58:01Z，下面的代码就可以了。然而，我最近在 Chrome 和 Opera 中尝试了 html5 datetime，它给了我 2011-05-03T11:58Z -->没有无法通过下面的代码处理的 ss 部分。

new Timestamp(javax.xml.datatype.DatatypeFactory.newInstance().newXMLGregorianCalendar(date).toGregorianCalendar().getTimeInMillis());

Answer 5

也许不是最优雅的方式，但肯定是我最近制作的一种方式：

Calendar cal = Calendar.getInstance();
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd-HH:mm:ss");
cal.setTime(sdf.parse(dateInString.replace("Z", "").replace("T", "-")));

Answer 6

我正在使用这个：

DateTimeFormatter RFC_3339_DATE_TIME_FORMATTER = new DateTimeFormatterBuilder()
            .append(ISO_LOCAL_DATE_TIME)
            .optionalStart()
            .appendOffset("+HH:MM", "Z")
            .optionalEnd()
            .toFormatter();

示例：

String dateTimeString = "2007-05-01T15:43:26.3452+07:00";
ZonedDateTime zonedDateTime = ZonedDateTime.from(RFC_3339_DATE_TIME_FORMATTER.parse(dateTimeString));

Answer 7

虽然，这个问题很老了，但它可能会帮助那些想要这个答案的 Kotlin 版本的人。通过使用此文件，任何人都可以将 Rfc3339 日期转换为任何日期格式。在这里，我采用一个空文件名 DateUtil 并创建一个名为 getDateString() 的函数，该函数有 3 个参数。

1st argument : Your input date
2nd argument : Your input date pattern
3rd argument : Your wanted date pattern

DateUtil.kt

object DatePattern {
    const val DAY_MONTH_YEAR = "dd-MM-yyyy"
    const val RFC3339 = "yyyy-MM-dd'T'HH:mm:ss'Z'"
}

fun getDateString(date: String, inputDatePattern: String, outputDatePattern: String): String {
    return try {
        val inputFormat = SimpleDateFormat(inputDatePattern, getDefault())
        val outputFormat = SimpleDateFormat(outputDatePattern, getDefault())

        outputFormat.format(inputFormat.parse(date))
    } catch (e: Exception) {
        ""
    }
}

现在在您的 Activity/fuction/dataSourse Mapper 中使用此方法来获取字符串格式的日期，如下所示

getDate("2022-01-18T14:41:52Z", RFC3339, DAY_MONTH_YEAR)

，输出将如下所示

18-01-2022

Answer 8

为了将来参考，作为替代方案，您可以使用 ITU[1]，它是手写的，可以精确处理 RFC-3339 解析，并且还可以让您轻松处理闰秒。该库没有依赖关系，大小仅为 18 kB。

完全披露：我是作者

try 
{
    final OffsetDateTime dateTime = ITU.parseDateTime(dateTimeStr);
}
catch (LeapSecondException exc) 
{
  // The following helper methods are available let you decide how to progress
  //int exc.getSecondsInMinute()
  //OffsetDateTime exc.getNearestDateTime()
  //boolean exc.isVerifiedValidLeapYearMonth()
}

[1] - https://github.com/ethlo/itu

Answer 9

Date date = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'").parse(datetimeInFRC3339format)