Calendar需用getInstance()创建并显式指定时区,通过add()安全增减日期,避免set()直接设字段;Date与SimpleDateFormat协作时须注意线程安全和格式化流程,转换以Instant为中间标准。

Java中用Calendar处理旧版日期,核心是避免直接操作毫秒或字符串,而是通过它提供的字段增减、时区适配和日历系统抽象来安全操作。虽然java.time(Java 8+)已成主流,但维护老项目或对接遗留接口时,仍需熟练使用Calendar及其配套类(如Date、SimpleDateFormat)。
Calendar基础创建与时间获取
Calendar是抽象类,不能直接new,必须用Calendar.getInstance()获取实例——它默认使用系统时区和本地化规则(如中国用公历,周首日为周一)。获取后可用getTime()转为Date,或用get(Calendar.YEAR)等方法读取字段:
- 推荐用
Calendar.getInstance(TimeZone.getTimeZone("Asia/Shanghai"))显式指定时区,避免服务器环境差异导致的偏差 - 不要依赖
Date.toString()输出,它隐含时区且格式固定;应配合SimpleDateFormat格式化 -
Calendar.get(Calendar.DAY_OF_MONTH)返回1~31,而Calendar.DAY_OF_WEEK返回1(周日)~7(周六),注意地区差异(可通过setFirstDayOfWeek()调整)
安全地增减日期与跨月处理
用add(int field, int amount)比手动计算毫秒更可靠,它会自动处理月份天数不同、闰年、时区夏令时切换等问题:
- 例如:
cal.add(Calendar.MONTH, 1)添加一个月,若当前是1月31日,结果会是2月28日(或29日),不会溢出到3月 - 若需“滚动”而非“累加”(如31日+1天=1日,不进月),用
roll(Calendar.DATE, 1) - 慎用
set()直接设字段:它不触发重计算,可能造成逻辑矛盾(如先设MONTH=1再设DATE=31,实际变成3月3日);设完应调用cal.getTime()或cal.complete()强制校正
与Date和SimpleDateFormat协作要点
Date本质是毫秒容器,无日历含义;SimpleDateFormat负责格式化/解析,三者需协同:
立即学习“Java免费学习笔记(深入)”;
- 从字符串转日期:先用
SDF.parse(str)得Date,再用cal.setTime(date)载入日历对象 - 输出字符串:先
cal.getTime()得Date,再用SDF.format(date);切勿用SDF.format(cal)(会报错) -
SimpleDateFormat非线程安全!多线程场景必须每次新建,或用ThreadLocal封装,或改用DateTimeFormatter(新API)
兼容新旧API的桥接方式
在混合代码中,可借助工具方法双向转换,降低迁移成本:
-
Date → Instant:
date.toInstant()(JDK 1.8+) -
Calendar → ZonedDateTime:
cal.toInstant().atZone(cal.getTimeZone().toZoneId()) -
LocalDateTime → Calendar:
GregorianCalendar.from(localDateTime.atZone(ZoneId.systemDefault())) - 关键原则:所有转换都以
Instant(UTC毫秒)为中间标准,避免时区丢失
基本上就这些。Calendar虽旧,但设计上考虑了历法复杂性,用对方法比硬算更稳。只要避开set()陷阱、管好时区、隔离SimpleDateFormat,老代码也能健壮运行。










