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

版本

• JDK8

前言

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

日期格式化基础

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

- `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

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

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

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 的区别，避免常见的格式化陷阱，可以帮助开发者编写更准确和可靠的代码。通过充分的测试和明确的文档，可以有效地避免由于日期格式化问题导致的错误。
• ISO 8601 标准 如何判断当周属于哪一年：

1、找出这一周的周四：因为ISO 8601标准定义的第一周是包含1月4日的那一周，而每周的周四总是属于那一年的ISO年份。
2、判断周四的年份：查看这周的周四是在哪一年。

个人简介

👋 你好，我是 Lorin 洛林，一位 Java 后端技术开发者！座右铭：Technology has the power to make the world a better place.

🚀 我对技术的热情是我不断学习和分享的动力。我的博客是一个关于Java生态系统、后端开发和最新技术趋势的地方。

🧠 作为一个 Java 后端技术爱好者，我不仅热衷于探索语言的新特性和技术的深度，还热衷于分享我的见解和最佳实践。我相信知识的分享和社区合作可以帮助我们共同成长。

💡 在我的博客上，你将找到关于Java核心概念、JVM 底层技术、常用框架如Spring和Mybatis 、MySQL等数据库管理、RabbitMQ、Rocketmq等消息中间件、性能优化等内容的深入文章。我也将分享一些编程技巧和解决问题的方法，以帮助你更好地掌握Java编程。

🌐 我鼓励互动和建立社区，因此请留下你的问题、建议或主题请求，让我知道你感兴趣的内容。此外，我将分享最新的互联网和技术资讯，以确保你与技术世界的最新发展保持联系。我期待与你一起在技术之路上前进，一起探讨技术世界的无限可能性。

📖 保持关注我的博客，让我们共同追求技术卓越。