如何将 1893 年之前的日期 util.Date 正确转换为 time.LocalDate
How to convert util.Date to time.LocalDate correctly for dates before 1893
我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 中进行了解释。但是，我看不出如何根据这些知识推断出正确的转换。
似乎是一个无法修复的已知错误：https://bugs.openjdk.java.net/browse/JDK-8061577
经过大量研究，我放弃了所有简单的 API 方法，而只是手动转换它。您可以将日期包装在 sql.Date 中并调用 toLocalDate() 或者您只使用与 sql.Date 相同的已弃用方法。
如果没有弃用的方法，您需要将 util.Date 转换为 Calendar 并一一获取字段：
Calendar calendar = Calendar.getInstance();
calendar.setTime(value);
return LocalDate.of(calendar.get(Calendar.YEAR), calendar.get(Calendar.MONTH) + 1,
calendar.get(Calendar.DAY_OF_MONTH));
如果您还想像 SimpleDateFormat 那样进行两位数的年份转换（将日期转换为现在的范围 - 80 年至今 + 19 年），您可以使用此实现：
Calendar calendar = Calendar.getInstance();
calendar.setTime(value);
int year = calendar.get(Calendar.YEAR);
if (year <= 99) {
LocalDate pivotLocalDate = LocalDate.now().minusYears(80);
int pivotYearOfCentury = pivotLocalDate.getYear() % 100;
int pivotCentury = pivotLocalDate.minusYears(pivotYearOfCentury).getYear();
if (year < pivotYearOfCentury) {
year += 100;
}
year += pivotCentury;
}
return LocalDate.of(year, calendar.get(Calendar.MONTH) + 1, calendar.get(Calendar.DAY_OF_MONTH));
结论：真的丑到我不敢相信没有简单的API！
如果你只是解析一个 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)。所以你可以说 "it's in UTC"，但是当你打印它时，值是 "converted" 到系统的默认时区（在你的情况下，它是 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 类 的扩展，由同一个人顺便说一句创建）。在 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（year/month/day 值），请使用 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) 如果您已经知道这些值。
但是将这些本地日期 from/to 转换为 java.util.Date 更复杂，因为 Date 表示完整的时间戳毫秒，并且日期可能因使用的日历系统而异。
这段代码对我有用：
@Test
public void oldDate() throws ParseException {
Date date = new SimpleDateFormat("yyyy-MM-dd").parse("1893-04-01");
assertEquals("1893-04-01", String.format("%tF", date));
}
我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 中进行了解释。但是，我看不出如何根据这些知识推断出正确的转换。
似乎是一个无法修复的已知错误：https://bugs.openjdk.java.net/browse/JDK-8061577
经过大量研究，我放弃了所有简单的 API 方法，而只是手动转换它。您可以将日期包装在 sql.Date 中并调用 toLocalDate() 或者您只使用与 sql.Date 相同的已弃用方法。
如果没有弃用的方法，您需要将 util.Date 转换为 Calendar 并一一获取字段：
Calendar calendar = Calendar.getInstance();
calendar.setTime(value);
return LocalDate.of(calendar.get(Calendar.YEAR), calendar.get(Calendar.MONTH) + 1,
calendar.get(Calendar.DAY_OF_MONTH));
如果您还想像 SimpleDateFormat 那样进行两位数的年份转换（将日期转换为现在的范围 - 80 年至今 + 19 年），您可以使用此实现：
Calendar calendar = Calendar.getInstance();
calendar.setTime(value);
int year = calendar.get(Calendar.YEAR);
if (year <= 99) {
LocalDate pivotLocalDate = LocalDate.now().minusYears(80);
int pivotYearOfCentury = pivotLocalDate.getYear() % 100;
int pivotCentury = pivotLocalDate.minusYears(pivotYearOfCentury).getYear();
if (year < pivotYearOfCentury) {
year += 100;
}
year += pivotCentury;
}
return LocalDate.of(year, calendar.get(Calendar.MONTH) + 1, calendar.get(Calendar.DAY_OF_MONTH));
结论：真的丑到我不敢相信没有简单的API！
如果你只是解析一个 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)。所以你可以说 "it's in UTC"，但是当你打印它时，值是 "converted" 到系统的默认时区（在你的情况下，它是 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 类 的扩展，由同一个人顺便说一句创建）。在 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（year/month/day 值），请使用 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) 如果您已经知道这些值。
但是将这些本地日期 from/to 转换为 java.util.Date 更复杂，因为 Date 表示完整的时间戳毫秒，并且日期可能因使用的日历系统而异。
这段代码对我有用：
@Test
public void oldDate() throws ParseException {
Date date = new SimpleDateFormat("yyyy-MM-dd").parse("1893-04-01");
assertEquals("1893-04-01", String.format("%tF", date));
}