基于周的模式无法按预期工作

Question

我希望这两个格式化程序是等价的：

DateTimeFormatter fromBuilder = new DateTimeFormatterBuilder()
    .appendValue(IsoFields.WEEK_BASED_YEAR, 4)
    .appendLiteral('-')
    .appendValue(IsoFields.WEEK_OF_WEEK_BASED_YEAR, 2)
    .toFormatter();
DateTimeFormatter fromPattern = DateTimeFormatter.ofPattern("YYYY-ww");

但它们给出的结果不同：

LocalDate date = LocalDate.of(2017, 1, 1);
System.out.printf("from builder: %s%n", fromBuilder.format(date));  // prints 'from builder: 2016-52'
System.out.printf("from pattern: %s%n", fromPattern.format(date));  // prints 'from pattern: 2017-01'

我错过了什么？

Answer 1

Y 和 w 模式 correspond to a localized version of week-fields，使用 JVM 的默认语言环境 (java.util.Locale)。第二个格式化程序相当于：

// localized week fields (using default Locale)
WeekFields weekFields = WeekFields.of(Locale.getDefault());
// equivalent to YYYY-ww
DateTimeFormatter fmt = new DateTimeFormatterBuilder()
    .appendValue(weekFields.weekBasedYear(), 4)
    .appendLiteral('-')
    .appendValue(weekFields.weekOfWeekBasedYear(), 2)
    .toFormatter();

由于这取决于语言环境，它可以或不能像IsoFields 那样工作。上面创建的 WeekFields 将根据 JVM 的默认语言环境具有不同的行为。

另一方面，IsoFields 遵循 ISO-8601 定义来定义基于周的字段，如 described in the javadoc：

以周为基础的年的第一周是标准 ISO 年的第一个以星期一为基础的周，新的一年至少有 4 天。

• 如果 1 月 1 日^st 是星期一，则第 1 周从 1 月 1 日^st 开始
• 如果 1 月 1 日^st 是星期二，那么第 1 周将从上一个标准年的 12 月 31 日^st开始
• 如果 1 月 1 日^st 是星期三，那么第 1 周将从上一个标准年的 12 月 30 日^th开始
• 如果 1 月 1 日^st 是星期四，那么第 1 周开始于上一个标准年的 12 月 29 日^th
• 如果 1 月 1 日^st 是星期五，那么第 1 周将从 1 月 4 日开始^th
• 如果 1 月 1 日^st 是星期六，则第 1 周从 1 月 3 日开始^rd
• 如果 1 月 1 日^st 是星期日，则第 1 周从 1 月 2 日开始^nd

由于2017-01-01 是星期日，它对应于上面的最后一行：第 1 周开始于 2017 年 1 月 2 日^nd，所以 1 月 1 日^st 2017 还是 2016 年的最后一周。

---

您可以通过调用用于calculate the values of the respecitive week-based fields 的方法getFirstDayOfWeek() 和getMinimalDaysInFirstWeek() 来检查您的WeekFields 实例与IsoFields 的不同之处：

一周的定义是：

• 一周的第一天。例如，ISO-8601 标准将星期一视为一周中的第一天。
• 第一周的最少天数。例如，ISO-8601 标准将第一周视为至少需要 4 天。

这两个值一起可以将一年或一个月划分为几周。

在我使用的 JVM 中，默认语言环境是 pt_BR，而创建的 WeekFields 的第一天是星期天，第一周的最少天数是 1。检查你的，你会发现它也不同于IsoFields。

---

您可以使用constant WeekFields.ISO 检查 ISO 的定义：getFirstDayOfWeek() 返回星期一，getMinimalDaysInFirstWeek() 返回 4。

---

另外，请注意IsoFields 和WeekFields.ISO 之间存在细微差别。引用JodaStephen's comment in this thread:

唯一可以观察到的区别是 WeekFields 在所有日历系统上运行（通过转换为 ISO），而 IsoFields 仅在 ISO 上运行（并拒绝其他日历系统）