具有可选模式的 Java DateTimeFormatterBuilder 导致 DateTimeParseException

Question

目标

为可以处理以下格式之一的输入的 LocalDate 实例提供灵活的解析器:

• 年
• 年月
• 年月日

实现尝试

下面的类尝试处理第一个和第二个模式。解析适用于年份输入，但年份 + 月份会导致下面列出的异常。

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeFormatterBuilder;
import java.time.temporal.ChronoField;

public class DateTest {

    public static void main(String[] args) {
        DateTimeFormatter parser = new DateTimeFormatterBuilder()
        .parseDefaulting(ChronoField.MONTH_OF_YEAR, 1)
        .parseDefaulting(ChronoField.DAY_OF_MONTH, 1)
        .appendPattern("yyyy")
        .optionalStart().appendPattern("MM").optionalEnd().toFormatter();

        System.out.println(parser.parse("2014", LocalDate::from)); // Works
        System.out.println(parser.parse("201411", LocalDate::from)); // Fails
    }
}

第二次 parse() 尝试导致以下异常:

Exception in thread "main" java.time.format.DateTimeParseException: Text '201411' could not be parsed at index 0
at java.time.format.DateTimeFormatter.parseResolved0(DateTimeFormatter.java:1949)
at java.time.format.DateTimeFormatter.parse(DateTimeFormatter.java:1851)

我认为我对可选部分模式的工作原理缺乏了解。我的目标是实现一个具有灵活格式的解析器，还是我需要检查输入长度并从解析器列表中进行选择？一如既往，我们将不胜感激。

Answer 1

问题的真正原因是符号处理。您的输入没有符号，但解析器元素“yyyy”贪婪地解析尽可能多的数字并期望一个正号，因为找到的数字超过四位。

我的分析以两种不同的方式进行:

• 调试(以查看不清楚的错误消息背后的真正原因)

• 基于我的 lib Time4J 在另一个解析引擎中模拟行为以获得更好的错误消息:

  ChronoFormatter<LocalDate> cf =
  ChronoFormatter
      .ofPattern(
          "yyyy[MM]",
          PatternType.THREETEN,
          Locale.ROOT,
          PlainDate.axis(TemporalType.LOCAL_DATE)
      )
      .withDefault(PlainDate.MONTH_AS_NUMBER, 1)
      .withDefault(PlainDate.DAY_OF_MONTH, 1)
      .with(Leniency.STRICT);
  System.out.println(cf.parse("201411")); 
  // java.text.ParseException: Positive sign must be present for big number.
  

您可以通过指示构建器始终仅使用四位数字来规避该问题:

DateTimeFormatter parser =
    new DateTimeFormatterBuilder()
        .appendValue(ChronoField.YEAR, 4)
        .optionalStart()
        .appendPattern("MM[dd]")
        .optionalEnd()
        .parseDefaulting(ChronoField.MONTH_OF_YEAR, 1)
        .parseDefaulting(ChronoField.DAY_OF_MONTH, 1)
        .toFormatter();

System.out.println(parser.parse("2014", LocalDate::from)); // 2014-01-01
System.out.println(parser.parse("201411", LocalDate::from)); // 2014-11-01
System.out.println(parser.parse("20141130", LocalDate::from)); // 2014-11-30

注意构建器中默认元素的位置。它们不是在开始时调用，而是在结束时调用，因为不幸的是，默认元素的处理在 java.time 中是位置敏感的。我还在第一个可选部分中为月份的日期添加了一个额外的可选部分。这个解决方案对我来说似乎更干净，而不是使用 Danila Zharenkov 建议的一系列 3 个可选部分，因为后者也可以解析具有更多数字的完全不同的输入(可能滥用可选部分作为 or-patterns 的替代品，特别是在宽松的情况下)解析)。

关于默认元素的位置敏感行为，这里引用自 API-documentation :

During parsing, the current state of the parse is inspected. If the specified field has no associated value, because it has not been parsed successfully at that point, then the specified value is injected into the parse result. Injection is immediate, thus the field-value pair will be visible to any subsequent elements in the formatter. As such, this method is normally called at the end of the builder.

---

顺便说一句:在我的 Time4J 库中，我还可以使用符号“|”定义真实或模式然后创建这个格式化程序:

ChronoFormatter<LocalDate> cf =
    ChronoFormatter
        .ofPattern(
            "yyyyMMdd|yyyyMM|yyyy",
            PatternType.CLDR,
            Locale.ROOT,
            PlainDate.axis(TemporalType.LOCAL_DATE)
        )
        .withDefault(PlainDate.MONTH_AS_NUMBER, 1)
        .withDefault(PlainDate.DAY_OF_MONTH, 1)
        .with(Leniency.STRICT);