java LocalDate.getYear/getMonth/getMonthValue返回年份,月份

方法定义

getYear()

public int getYear()

• 返回值：返回年份，如 2025
• 类型：int

getMonth()

public Month getMonth()

• 返回值：返回一个 Month 枚举对象，表示月份（如 JANUARY, FEBRUARY 等）
• 类型：java.time.Month（枚举）

getMonthValue()

public int getMonthValue()

• 返回值：返回月份的数值（1-12），1 表示一月，12 表示十二月
• 类型：int

功能说明

这三个方法用于从 LocalDate 对象中提取年份和月份信息，是处理日期解析、格式化、条件判断等场景的常用方法。

示例代码

基本用法

import java.time.LocalDate;
import java.time.Month;

public class LocalDateGetExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2025, 8, 15); // 2025年8月15日
        
        // 获取年份
        int year = date.getYear();
        System.out.println("年份: " + year); // 输出: 2025
        
        // 获取月份（枚举）
        Month month = date.getMonth();
        System.out.println("月份（枚举）: " + month); // 输出: AUGUST
        System.out.println("月份名称: " + month.name()); // AUGUST
        System.out.println("本地化名称: " + month.getDisplayName(TextStyle.FULL, Locale.CHINESE)); // 八月
        
        // 获取月份数值
        int monthValue = date.getMonthValue();
        System.out.println("月份（数值）: " + monthValue); // 输出: 8
    }
}

实际应用场景

场景 1：判断是否为当前年份

LocalDate today = LocalDate.now();
LocalDate birthDate = LocalDate.of(2000, 5, 20);

if (birthDate.getYear() == today.getYear()) {
    System.out.println("生日在今年");
} else {
    System.out.println("生日不在今年");
}

场景 2：根据月份执行不同逻辑（使用枚举）

Month currentMonth = LocalDate.now().getMonth();

switch (currentMonth) {
    case DECEMBER:
    case JANUARY:
    case FEBRUARY:
        System.out.println("冬季");
        break;
    case MARCH:
    case APRIL:
    case MAY:
        System.out.println("春季");
        break;
    // 其他季节...
    default:
        System.out.println("夏季");
}

场景 3：月份比较与计算

LocalDate date1 = LocalDate.of(2025, 3, 10);
LocalDate date2 = LocalDate.of(2025, 8, 15);

if (date1.getMonthValue() < date2.getMonthValue()) {
    System.out.println("date1 的月份更早");
}

// 计算相差几个月（简化示例）
int diff = date2.getMonthValue() - date1.getMonthValue();
System.out.println("相差 " + diff + " 个月");

使用技巧

技巧 1：结合 Month 枚举的丰富方法

Month month = LocalDate.now().getMonth();

// 获取下一个月
Month next = month.plus(1); // SEPTEMBER

// 获取该月的天数（需结合年份）
int length = month.length(Year.isLeap(2025)); // 是否闰年影响2月

// 获取英文全称、缩写等
System.out.println(month.name()); // AUGUST
System.out.println(month.toString()); // AUG

技巧 2：格式化输出月份

LocalDate date = LocalDate.now();
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy年M月");
System.out.println(date.format(formatter)); // 2025年8月

技巧 3：用于分组或索引

// 例如：按年月分组数据
String yearMonthKey = date.getYear() + "-" + String.format("%02d", date.getMonthValue());
// 结果: 2025-08

常见错误

// 错误示例
LocalDate date = null;
int m = date.getMonthValue(); // 抛出 NullPointerException

注意事项

1. ⚠️ getMonthValue() 返回 1-12：不是 0-11（与旧的 Calendar 不同）。
2. ⚠️ getMonth() 返回枚举：不能直接用于数学计算，需调用 .getValue()。
3. ⚠️ 不可变性：这些方法不修改原 LocalDate，返回的是提取的值。
4. ⚠️ 时区无关：LocalDate 不含时区，这些方法也不受时区影响。
5. ⚠️ 性能：这些方法是轻量级的，可频繁调用。

最佳实践与性能优化

✅ 最佳实践

⚙️ 性能优化

• 这些方法均为 O(1) 时间复杂度，性能极高，无需特别优化。
• 在循环中可放心使用，不会成为性能瓶颈。
• 如果需频繁提取多个字段，可一次性获取并缓存：

  int year = date.getYear();
  int month = date.getMonthValue();
  int day = date.getDayOfMonth();
  

总结