Java 日期字符串格式化：请不要乱用 YYYY 和 yyyy

版本

• JDK8

前言

• 在软件开发中，处理日期和时间是一个常见的任务。一个常见的误区涉及到日期格式化中的 YYYY 和 yyyy。虽然它们看起来很相似，但实际上有着重要的区别，特别是在处理年初和年末的日期时。本文将深入探讨 YYYY 的陷阱，并通过代码示例解释如何正确使用这些格式化符号。

日期格式化基础

• 日期格式化是将日期对象转换为特定格式的字符串的过程。常见的格式化符号包括：

代码语言：txt复制

- `yyyy`：表示年份（例如，2024）
- `MM`：表示月份（例如，06）
- `dd`：表示日期（例如，08）

• 在大多数情况下，yyyy 被用来表示年份。然而，许多开发者会接触到大写的 YYYY，并错误地将其视为与 yyyy 等同。

YYYY 与 yyyy 的区别

• yyyy：基于日历年的年份。一个日历年从 1 月 1 日开始，到 12 月 31 日结束。例如，2024-01-01 和 2024-12-31 都属于年份 2024。
• YYYY：基于 ISO 8601 标准的周年份。周年份的开始和结束取决于该年的第一个星期一。也就是说，周年份的起点不一定是 1 月 1 日。例如，2024 年的第一周可能会从 2023 年的最后几天开始，因此 YYYY 和 yyyy 可能在年初和年末产生不同的结果。

典型陷阱

• 为了更好地理解 YYYY 的陷阱，让我们看一些具体的例子和代码示例。

例子 1：新年前夕

假设当前日期是 2023 年 12 月 31 日，星期一。根据 ISO 8601 标准，这一天属于 2024 年的第一周。因此：

• 使用 yyyy 格式化：2023
• 使用 YYYY 格式化：2024

代码语言：java复制

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;

public class DateExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2023, 12, 31);

        DateTimeFormatter yyyyFormatter = DateTimeFormatter.ofPattern("yyyy");
        DateTimeFormatter YYYYFormatter = DateTimeFormatter.ofPattern("YYYY");

        System.out.println("Using yyyy: "   date.format(yyyyFormatter));  // 2023
        System.out.println("Using YYYY: "   date.format(YYYYFormatter));  // 2024
    }
}

例子 2：新年第一周

假设当前日期是 2024 年 1 月 1 日，星期二。这一天属于 2024 年的第一周。因此：

• 使用 yyyy 格式化：2024
• 使用 YYYY 格式化：2024

代码语言：java复制

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;

public class DateExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2024, 1, 1);

        DateTimeFormatter yyyyFormatter = DateTimeFormatter.ofPattern("yyyy");
        DateTimeFormatter YYYYFormatter = DateTimeFormatter.ofPattern("YYYY");

        System.out.println("Using yyyy: "   date.format(yyyyFormatter));  // 2024
        System.out.println("Using YYYY: "   date.format(YYYYFormatter));  // 2024
    }
}

例子 3：年末

假设当前日期是 2022 年 12 月 30 日，星期五。根据 ISO 8601 标准，这一天属于 2023 年的第一周。因此：

• 使用 yyyy 格式化：2022
• 使用 YYYY 格式化：2023

代码语言：java复制

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;

public class DateExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2022, 12, 30);

        DateTimeFormatter yyyyFormatter = DateTimeFormatter.ofPattern("yyyy");
        DateTimeFormatter YYYYFormatter = DateTimeFormatter.ofPattern("YYYY");

        System.out.println("Using yyyy: "   date.format(yyyyFormatter));  // 2022
        System.out.println("Using YYYY: "   date.format(YYYYFormatter));  // 2023
    }
}

结论

• 理解 YYYY 和 yyyy 的区别，避免常见的格式化陷阱，可以帮助开发者编写更准确和可靠的代码。通过充分的测试和明确的文档，可以有效地避免由于日期格式化问题导致的错误。

个人简介