DateTimeFormatter周年差异

Question

我正在将我的应用程序从Joda-Time迁移到Java8Java.time。

我遇到的一件事是使用DateTimeFormatter中的模式打印以周为单位的年份。

注意：我已经看到这个问题：Java Time的week-of-week-based-year模式用DateTimeFormatter解析

根据文件

y       year-of-era                 year              2004; 04
Y       week-based-year             year              1996; 96

然而，当我尝试这两个时，y似乎总是返回与y相同的内容。

我的测试代码：

DateTimeFormatter yearF = DateTimeFormatter.ofPattern("yyyy").withZone(ZoneOffset.UTC);
DateTimeFormatter weekYearF = DateTimeFormatter.ofPattern("YYYY").withZone(ZoneOffset.UTC);

DateTimeFormatter dateTimeFormatter = new DateTimeFormatterBuilder()
    .appendValue(ChronoField.YEAR_OF_ERA)   .appendLiteral(" ") .append(yearF)
    .appendLiteral(" -- ")
    .appendValue(IsoFields.WEEK_BASED_YEAR) .appendLiteral(" ") .append(weekYearF)
    .toFormatter()
    .withZone(ZoneOffset.UTC);

System.out.println(dateTimeFormatter.toString());

ZonedDateTime dateTime = ZonedDateTime.ofInstant(Instant.ofEpochMilli(946778645000L), ZoneOffset.UTC);
for (int i = 2000 ; i < 2020; i ++ ) {
    System.out.println(dateTime.withYear(i).format(dateTimeFormatter));
}

输出：

Value(YearOfEra)' '(Value(YearOfEra,4,19,EXCEEDS_PAD))' -- 'Value(WeekBasedYear)' '(Localized(WeekBasedYear,4,19,EXCEEDS_PAD))
2000 2000 -- 1999 2000
2001 2001 -- 2001 2001
2002 2002 -- 2002 2002
2003 2003 -- 2003 2003
2004 2004 -- 2004 2004
2005 2005 -- 2004 2005
2006 2006 -- 2006 2006
2007 2007 -- 2007 2007
2008 2008 -- 2008 2008
2009 2009 -- 2009 2009
2010 2010 -- 2009 2010
2011 2011 -- 2010 2011
2012 2012 -- 2012 2012
2013 2013 -- 2013 2013
2014 2014 -- 2014 2014
2015 2015 -- 2015 2015
2016 2016 -- 2015 2016
2017 2017 -- 2017 2017
2018 2018 -- 2018 2018
2019 2019 -- 2019 2019

查看重要的年份（如2000、2005、2009和2016年），.appendvalue(isofields.week_based_year)和.ofpattern（“yyyy”）的输出是不同的。

在Java Time使用DateTimeFormatter进行的基于周年的模式解析中，说明了这与本地化有关（可以清楚地看到DateTimeFormatter的tostring()的不同）。

现在我不明白/不需要的事情很少了：

>

所以“以周为基础的年份”随地区的不同而变化，很好。然而，我不明白的是，显然在某些地方，周基年总是与“正常”年相同。为什么会这样？

为什么yyyy的解析没有映射到ISO-8601定义，而不是（非常混乱！）本地化形式。

我在哪里可以找到适当的文档？甲骨文表面上的“官方”文档至少可以说是模糊的。答：我找到了DateTimeFormatterBuilder更广泛的文档。

Answer 1

根据javadoc的说法，基于Week-year字段取决于两个方面：一周的第一天是什么，以及第一周的最短天数。

ISO标准将星期一定义为一周的第一天，第一周至少有4天：

System.out.println(WeekFields.ISO.getFirstDayOfWeek()); // Monday
System.out.println(WeekFields.ISO.getMinimalDaysInFirstWeek()); // 4

(weekfields.iso.weekbasedyear()等效于isofields.week_based_year，在其他日历系统中略有不同）

例如，考虑到2009年1月2日^nd，这是一个星期五。在javadoc中检查基于周的年份字段：

第一周（1）是从getFirstDayOfWeek（）开始的一周，其中一年中至少有getMinimalDaysInFirstWeek（）天。因此，第一周可能在年初之前开始。

考虑到ISO定义（一周从星期一开始，第一周的最短天数为4)，第1周从2008年12月29日开始，到2009年1月4日结束（这是从星期一开始的第一周，在2009年至少有4天），因此，2009年1月2日^和的周年等于2009年（根据ISO定义）：

// January 2st 2009
LocalDate dt = LocalDate.of(2009, 1, 2);
System.out.println(dt.get(WeekFields.ISO.weekBasedYear())); // 2009
System.out.println(dt.get(WeekFields.ISO.weekOfWeekBasedYear())); // 1
// WeekFields.ISO and IsoFields are equivalent
System.out.println(dt.get(IsoFields.WEEK_BASED_YEAR)); // 2009
System.out.println(dt.get(IsoFields.WEEK_OF_WEEK_BASED_YEAR)); // 1

但是，如果考虑en_mt区域设置（英语（马耳他））的WeekFields实例，则一周的第一天是星期日，第一周的最短天数为4天：

WeekFields wf = WeekFields.of(new Locale("en", "MT"));
System.out.println(wf.getFirstDayOfWeek()); // Sunday
System.out.println(wf.getMinimalDaysInFirstWeek()); // 4
System.out.println(dt.get(wf.weekBasedYear())); // 2008
System.out.println(dt.get(wf.weekOfWeekBasedYear())); // 53

2009年，从周日开始且至少有4天的第一周是从1月4日^日到10日^日的一周。因此，根据en_mt区域设置的周定义，2009年1月2日^nd属于基于2008年的第53个周。

现在，如果使用AR_SA区域设置（阿拉伯语（沙特阿拉伯）)，则一周从星期六开始，第一周的最短天数为1：

WeekFields wf = WeekFields.of(new Locale("ar", "SA"));
System.out.println(wf.getFirstDayOfWeek()); // Saturday
System.out.println(wf.getMinimalDaysInFirstWeek()); // 1
System.out.println(dt.get(wf.weekBasedYear())); // 2009
System.out.println(dt.get(wf.weekOfWeekBasedYear())); // 1

对于此区域设置，第1周开始于2008年12月27日^th，结束于2009年1月2日^nd(2009年第一周开始于星期六，至少有一天）。因此，在AR_SA区域设置中，2009年1月2日^nd的基于周的年份也是2009年（与使用isofields得到的值相同，尽管周定义与ISO完全不同）。

虽然isoFields.week_based_year使用ISO的定义，但模式yyyy将使用与格式化程序中设置的区域设置相对应的weekFields实例（如果没有设置，则为JVM默认区域设置）。

根据每个区域设置的定义（一周的第一天和第一周的最小天数），本地化模式(yyyy)中基于周的年份可能具有相同的ISO字段值（或不是）。

虽然一周可以在另一年开始或结束这听起来很奇怪，但javadoc认为这是完全有效的：

一年的第一周和最后一周可能分别包含上一个日历年或下一个日历年的天数。

java.time的模式字母基于CLDR（Unicode Common Locale Data Repository）。这个基于周的模式的链接说：

Y表示的年份通常从区域设置的第一天开始，到最后一天结束

无论如何，CLDR完全是关于本地化的，所以y也是本地化的--正如Stephen Colebourne在下面的评论中所述：

CLDR的全部目的是本地化，所以是的，“Y”模式字母是本地化的。虽然我理解对一个总是使用ISO规则操作的模式字母的渴望，但它并不存在，让CLDR添加它将是很难甚至不可能的。（Java正在密切关注CLDR）

我的结论是，如果您想要ISO周字段，不要使用本地化模式。或者，作为一种--不理想，也很难看--的解决办法，使用与ISO的周定义相匹配的区域设置（在我的JVM中，locale.french可以做到这一点，因为weekfields.iso.equals(weekfields.of(locale.french))返回true)。唯一的问题是，区域设置还会影响其他字段（如果您有月份或星期名称，如MMM或EEE，以及任何其他区域设置敏感的数据）。