Java中Calendar处理时间的核心是其可变性、字段操作机制和时区敏感性,需通过getInstance()获取实例,注意月份从0开始、add()支持进位而roll()仅局部循环,推荐迁移到java.time包。

Java中使用Calendar处理时间,核心在于理解它的可变性、字段操作机制和时区敏感性。它不是“加减天数”那么简单,而是通过add()和roll()方法按字段(如年、月、日)进行逻辑计算,并自动处理进位与边界(比如1月31日加1个月会变成2月28/29日,而非3月31日)。
Calendar的基本获取与初始化
Calendar是抽象类,不能直接new,需通过Calendar.getInstance()获取实例——该方法返回当前默认时区和语言环境下的GregorianCalendar对象:
- 不传参:使用系统默认时区(如CST)
- 指定时区:
Calendar.getInstance(TimeZone.getTimeZone("UTC")) - 注意:每次调用都新建实例,不是单例,也不线程安全
设置和读取时间字段
用set(int field, int value)设置年、月、日等字段;用get(int field)读取。关键细节:
- 月份从0开始(
Calendar.JANUARY = 0),set(Calendar.MONTH, 5)表示6月 - 星期默认周日为第一天(
Calendar.SUNDAY = 1),可通过setFirstDayOfWeek()调整 - 设置后不会立即触发计算,需调用
getTime()或get()才会完成内部归一化(如把2月30日转为3月2日)
add()与roll()的区别:进位 vs 局部循环
两者都用于时间增减,但逻辑不同:
立即学习“Java免费学习笔记(深入)”;
-
add(Calendar.MONTH, 1):支持进位。例如“2023-01-31”加1个月 → “2023-02-28”(自动适配2月天数);再加1个月 → “2023-03-28” -
roll(Calendar.DATE, 1):只在当前月内滚动,不改变月/年。例如“2023-01-31”滚+1日 → “2023-01-01”(跳回当月1号),年月不变 - 一般业务中优先用
add(),roll()适合UI选择器等局部微调场景
转换为Date和毫秒值
Calendar本质是时间字段的容器,需显式转为标准类型才便于存储或传输:
-
calendar.getTime()→ 返回Date对象(注意Date已过时,仅作兼容) -
calendar.getTimeInMillis()→ 返回自1970-01-01 00:00:00 UTC起的毫秒数,推荐用于比较或持久化 - 反向操作:
calendar.setTime(new Date())或calendar.setTimeInMillis(1717027200000L)
Calendar虽能完成基本时间运算,但设计复杂、易出错,JDK 8起强烈建议迁移到java.time包(如LocalDateTime、ZonedDateTime)。若维护旧代码,务必注意时区、月份偏移和线程安全问题。










