Java初学者项目实战:实现简单的日历应用

应使用 GregorianCalendar 而非 Calendar.getInstance(),因其类型明确、行为确定;月份索引需±1转换;避免循环中重复创建实例,推荐复用并用 add() 推算日期。

为什么用 GregorianCalendar 而不是 Calendar.getInstance()

初学者常直接写 Calendar cal = Calendar.getInstance(),以为能直接操作年月日——但这样拿到的是抽象基类引用,setget 行为在不同 JVM 或时区下可能不一致。实际开发中必须明确使用子类:GregorianCalendar 是 Java 默认公历实现,兼容性好、行为确定。

关键点:

  • Calendar.getInstance() 返回的确实是 GregorianCalendar(JDK 8+),但类型擦除后无法调用其特有方法,比如 setFirstDayOfWeek()
  • 显式声明 GregorianCalendar cal = new GregorianCalendar(2025, Calendar.JANUARY, 1),可避免隐式转型风险
  • 构造时传入年、月、日比先 getInstance()set() 更安全——后者容易漏掉 clear() 导致残留字段干扰

如何正确处理月份索引(Calendar.JANUARY == 0

这是 Java 日历最常踩的坑:所有月份从 0 开始计数,但用户输入和显示都是 1–12。不转换会直接导致“显示 1 月却跳到 2 月”或“13 日变 14 日”。

实操建议:

  • 用户输入月份(如 “3”)存入 GregorianCalendar 前,务必减 1:cal.set(year, month - 1, day)
  • cal.get(Calendar.MONTH) 取值显示时,必须加 1:int displayMonth = cal.get(Calendar.MONTH) + 1
  • 遍历当月每一天时,起始日用 cal.getActualMinimum(Calendar.DAY_OF_MONTH)(总是 1),结束日用 cal.getActualMaximum(Calendar.DAY_OF_MONTH)(自动适配大小月/闰年)

打印日历表格时,怎么对齐星期和日期

核心是算出当月 1 号是星期几,再补空格。别用固定空格数硬凑——Calendar.DAY_OF_WEEK 返回的是 1(周日)到 7(周六),而多数日历以周一为第一天。

示例逻辑(关键步骤):

GregorianCalendar cal = new GregorianCalendar(2025, Calendar.FEBRUARY, 1);
int firstDayOfWeek = cal.get(Calendar.DAY_OF_WEEK); // 返回 2(2025-02-01 是周四)
int startOffset = (firstDayOfWeek - cal.getFirstDayOfWeek() + 7) % 7; // 若设周一为第一天,则 cal.getFirstDayOfWeek() == 2 → offset = 0

// 打印表头(周一到周日) System.out.println("Mon Tue Wed Thu Fri Sat Sun");

// 补空白 for (int i = 0; i < startOffset; i++) { System.out.print(" "); }

// 打印日期 int daysInMonth = cal.getActualMaxim

um(Calendar.DAY_OF_MONTH); for (int day = 1; day <= daysInMonth; day++) { System.out.printf("%3d ", day); if ((startOffset + day) % 7 == 0) System.out.println(); } if ((startOffset + daysInMonth) % 7 != 0) System.out.println(); // 换行收尾

为什么不要在循环里反复 new GregorianCalendar

初学者常写“每打印一天就 new 一个 Calendar”,性能差且易出错。每个 GregorianCalendar 实例含完整时区、Locale、字段缓存,频繁创建浪费内存,还可能因默认时区导致跨天计算偏差。

更稳妥的做法:

  • 只创建一个实例,用 cal.set(year, month, 1) 定位到当月首日,再用 cal.add(Calendar.DATE, n) 向后推算
  • 需要获取某天星期几?直接 cal.get(Calendar.DAY_OF_WEEK),别另建对象
  • 如果要支持多线程(比如后台刷新),才考虑用 ThreadLocal 隔离实例

真正麻烦的不是写法,而是忘记 add() 会修改原实例状态——下次循环前得 cal.set(...) 重置,否则日期会越滚越大。