java - 如何将 util.Date 转换为 time.LocalDate 以正确处理 1893 年之前的日期

Question

我google了一下，最常用的方法好像是

date.toInstant().atZone(ZoneId.systemDefault()).toLocalDate();

但是，对于 1893-04-01 之前的日期，此方法似乎会失败

以下测试在我的机器上失败，结果为 1893-03-31 而不是 1893-04-01:

@Test
public void testBeforeApril1893() throws ParseException {
    Date date = new SimpleDateFormat("yyyy-MM-dd").parse("1893-04-01");

    System.out.println(date);

    LocalDate localDate2 = date.toInstant().atZone(ZoneId.systemDefault()).toLocalDate();

    System.out.println(localDate2);

    assertEquals(1893, localDate2.getYear());
    assertEquals(4, localDate2.getMonth().getValue());
    assertEquals(1, localDate2.getDayOfMonth());
}

System.out.prinln 供我仔细检查创建日期。我看到以下输出:

Sun Apr 02 00:00:00 CET 1893
1893-04-02
Sat Apr 01 00:00:00 CET 1893
1893-03-31

对于 1400-04-01，我什至得到 1400-04-09 的输出。

是否有任何方法可以将 1893-04 之前的日期正确转换为 LocalDate？

正如一些有用的指出的那样，这种转变的原因在 this question 中有解释。 .但是，我看不出如何根据这些知识推断出正确的转换。

Answer 1

如果你只是解析一个 String 输入，它是直截了当的:

LocalDate d1 = LocalDate.parse("1893-04-01");
System.out.println(d1); // 1893-04-01
LocalDate d2 = LocalDate.parse("1400-04-01");
System.out.println(d2); // 1400-04-01

输出是:

1893-04-01
1400-04-01

---

但是如果你有一个 java.util.Date 对象并且需要转换它，那就有点复杂了。

A java.util.Date contains the number of milliseconds from unix epoch (1970-01-01T00:00Z)。所以你可以说“它是 UTC”，但是当你打印它时，该值被“转换”为系统的默认时区(在你的情况下，它是 CET)。并且 SimpleDateFormat 也在内部使用默认时区(我必须承认我不完全理解的晦涩方式)。

在您的示例中，-2422054800000 的毫秒值相当于 UTC 即时 1893-03-31T23:00:00Z。在 Europe/Berlin 时区检查此值:

System.out.println(Instant.ofEpochMilli(-2422054800000L).atZone(ZoneId.of("Europe/Berlin")));

输出是:

1893-03-31T23:53:28+00:53:28[Europe/Berlin]

是的，这很奇怪，但是在 1900 年之前所有地方都使用奇怪的偏移量 - 在 UTC 标准出现之前，每个城市都有自己的本地时间。这解释了为什么您得到 1893-03-31。 Date 对象打印 April 1st 可能是因为旧 API (java.util.TimeZone) 没有所有偏移历史记录，所以它假设它是 +01:00。

使这项工作可行的一种替代方法是始终使用 UTC 作为时区:

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
sdf.setTimeZone(TimeZone.getTimeZone("UTC")); // set UTC to the format
Date date = sdf.parse("1893-04-01");
LocalDate d = date.toInstant().atZone(ZoneOffset.UTC).toLocalDate();
System.out.println(d); // 1893-04-01

这将获得正确的本地日期:1893-04-01。

---

但对于 1582-10-15 之前的日期，上面的代码不起作用。那是引入公历的日期。在此之前，使用的是儒略历，日期早于它need an adjustment .

我可以用 ThreeTen Extra project 做到这一点(java.time 类的扩展，由同一个人 BTW 创建)。在 org.threeten.extra.chrono 包中有 JulianChronology 和 JulianDate 类:

// using the same SimpleDateFormat as above (with UTC set)
date = sdf.parse("1400-04-01");
// get julian date from date
JulianDate julianDate = JulianChronology.INSTANCE.date(date.toInstant().atZone(ZoneOffset.UTC));
System.out.println(julianDate); // Julian AD 1400-04-01

输出将是:

Julian AD 1400-04-01

现在我们需要将 JulianDate 转换为 LocalDate。如果我执行 LocalDate.from(julianDate)，它会转换为公历(结果为 1400-04-10)。

但是如果你想创建一个 LocalDate 正好是 1400-04-01，你必须这样做:

LocalDate converted = LocalDate.of(julianDate.get(ChronoField.YEAR_OF_ERA),
                                   julianDate.get(ChronoField.MONTH_OF_YEAR),
                                   julianDate.get(ChronoField.DAY_OF_MONTH));
System.out.println(converted); // 1400-04-01

输出将是:

1400-04-01

请注意，1582-10-15 之前的日期有此调整，SimpleDateFormat 无法正确处理这些情况。如果您只需要使用 1400-04-01(年/月/日值)，请使用 LocalDate。但如果您需要将其转换为 java.util.Date，请注意它可能不是同一日期(由于 Gregorian/Julian 调整)。

---

如果您不想添加其他依赖项，您也可以手动完成所有数学运算。我已经改编了 ThreeTen 的代码，但 IMO 的理想是使用 API 本身(因为它可以覆盖极端情况和其他我可能通过复制一段代码而遗漏的东西):

// auxiliary method
public LocalDate ofYearDay(int prolepticYear, int dayOfYear) {
    boolean leap = (prolepticYear % 4) == 0;
    if (dayOfYear == 366 && leap == false) {
        throw new DateTimeException("Invalid date 'DayOfYear 366' as '" + prolepticYear + "' is not a leap year");
    }
    Month moy = Month.of((dayOfYear - 1) / 31 + 1);
    int monthEnd = moy.firstDayOfYear(leap) + moy.length(leap) - 1;
    if (dayOfYear > monthEnd) {
        moy = moy.plus(1);
    }
    int dom = dayOfYear - moy.firstDayOfYear(leap) + 1;
    return LocalDate.of(prolepticYear, moy.getValue(), dom);
}

// sdf with UTC set, as above
Date date = sdf.parse("1400-04-01");
ZonedDateTime z = date.toInstant().atZone(ZoneOffset.UTC);

LocalDate d;
// difference between the ISO and Julian epoch day count
long julianToIso = 719164;
int daysPerCicle = (365 * 4) + 1;
long julianEpochDay = z.toLocalDate().toEpochDay() + julianToIso;
long cycle = Math.floorDiv(julianEpochDay, daysPerCicle);
long daysInCycle = Math.floorMod(julianEpochDay, daysPerCicle);
if (daysInCycle == daysPerCicle - 1) {
    int year = (int) ((cycle * 4 + 3) + 1);
    d = ofYearDay(year, 366);
} else {
    int year = (int) ((cycle * 4 + daysInCycle / 365) + 1);
    int doy = (int) ((daysInCycle % 365) + 1);
    d = ofYearDay(year, doy);
}
System.out.println(d); // 1400-04-01

输出将是:

1400-04-01

只是提醒一下，1582-10-15 之后的日期不需要所有这些数学运算。

---

无论如何，如果您有一个输入 String 并且想要解析它，请不要使用 SimpleDateFormat - 您可以使用 LocalDate.parse() 代替。或者 LocalDate.of(year, month, day) 如果您已经知道这些值。

但是将这些本地日期从/转换为 java.util.Date 更为复杂，因为 Date 表示完整的时间戳毫秒，并且日期可能会根据日历而变化正在使用的系统。