423. Java 日期时间 API - DayOfWeek 和 Month 枚举

文章目录

[423. Java 日期时间 API - DayOfWeek 和 Month 枚举](#423. Java 日期时间 API - DayOfWeek 和 Month 枚举)
- [✅ DayOfWeek 枚举](#✅ DayOfWeek 枚举)
- - [🔹 示例 1：加天数](#🔹 示例 1：加天数)
  - [🔹 示例 2：本地化显示](#🔹 示例 2：本地化显示)
- [✅ Month 枚举](#✅ Month 枚举)
- - [🔹 示例 1：获取最大天数](#🔹 示例 1：获取最大天数)
  - [🔹 示例 2：本地化显示](#🔹 示例 2：本地化显示)
- [🎯 小结](#🎯 小结)

423. Java 日期时间 API - DayOfWeek 和 Month 枚举

大家好，接下来我们要认识 Date-Time API 里面的两个非常常用的枚举类型：

👉 DayOfWeek （星期几）

👉 Month（月份）

它们可以让我们用更直观的方式表示时间元素，而不是写死的数字，这样代码更可读、更安全。

✅ DayOfWeek 枚举

定义：DayOfWeek 包含 7 个常量：
MONDAY 到 SUNDAY。
数值范围 ：1（星期一）到 7（星期天）。
👉 比如 DayOfWeek.MONDAY.getValue() 返回 1。

这样写比我们自己定义 1=周一，2=周二 可读性强太多。

🔹 示例 1：加天数

java 复制代码

System.out.printf("%s%n", DayOfWeek.MONDAY.plus(3));

👉 输出：

java 复制代码

THURSDAY

意思就是：星期一 + 3 天 = 星期四。是不是比手算直观多了？🚀

🔹 示例 2：本地化显示

很多时候我们要把"周一"展示给用户，不能写死成英文。

DayOfWeek 提供了 getDisplayName(TextStyle, Locale) 方法，结合 TextStyle 就可以控制输出格式。

java 复制代码

import java.time.DayOfWeek;
import java.time.format.TextStyle;
import java.util.Locale;

public class DayOfWeekDemo {
    public static void main(String[] args) {
        DayOfWeek dow = DayOfWeek.MONDAY;
        Locale locale = Locale.getDefault();

        System.out.println(dow.getDisplayName(TextStyle.FULL, locale));   // Monday
        System.out.println(dow.getDisplayName(TextStyle.NARROW, locale)); // M
        System.out.println(dow.getDisplayName(TextStyle.SHORT, locale));  // Mon
    }
}

👉 在 en_US 环境下输出：

java 复制代码

Monday
M
Mon

👉 在 中文环境下输出：

java 复制代码

星期一
一
周一

是不是特别方便？不用写复杂的国际化逻辑，Java 已经帮我们准备好了 🎉

✅ Month 枚举

定义：Month 枚举包含 12 个常量：
JANUARY 到 DECEMBER。
数值范围 ：1（1月）到 12（12月）。
👉 比如 Month.SEPTEMBER.getValue() 返回 9。

同样，强类型的枚举让代码更直观，比如写 Month.SEPTEMBER 就比写 9 强太多。

🔹 示例 1：获取最大天数

二月份有时 28 天，有时 29 天（闰年）。

maxLength() 方法能告诉我们某个月最多有多少天。

java 复制代码

System.out.printf("%d%n", Month.FEBRUARY.maxLength());

👉 输出：

java 复制代码

很好理解：二月份最多有 29 天。

🔹 示例 2：本地化显示

Month 也提供了 getDisplayName(TextStyle, Locale)，和 DayOfWeek 一样。

java 复制代码

import java.time.Month;
import java.time.format.TextStyle;
import java.util.Locale;

public class MonthDemo {
    public static void main(String[] args) {
        Month month = Month.AUGUST;
        Locale locale = Locale.getDefault();

        System.out.println(month.getDisplayName(TextStyle.FULL, locale));   // August
        System.out.println(month.getDisplayName(TextStyle.NARROW, locale)); // A
        System.out.println(month.getDisplayName(TextStyle.SHORT, locale));  // Aug
    }
}

👉 在 en_US 环境下输出：

java 复制代码

August
A
Aug

👉 在 中文环境下输出：

java 复制代码

八月
八
8月

是不是很智能？😎

🎯 小结

DayOfWeek：表示星期几，支持加减天数和本地化显示。
Month：表示月份，支持获取最大天数和本地化显示。
通过枚举，代码更清晰、可读性更高，而且避免了魔法数字（magic numbers）。

比如：

java 复制代码

if (today.getDayOfWeek() == DayOfWeek.FRIDAY) {
    System.out.println("周五啦，准备周末 🎉");
}

是不是比 if (today.getDayOfWeek() == 5) 好理解多了？