Java Calendar类实现万年历打印教程

本文详解Java中Calendar类实现万年历打印的核心技巧，直击初学者常踩的三大坑：必须先set(Calendar.DAY_OF_MONTH, 1)再获取该月1号星期几，而非直接调用get；需将Calendar默认周日为1的星期序号（1–7）转换为符合中国习惯的“周一为第1天”格式，即`(value-1)%7+1`；同时强调月份从0开始、空格占位逻辑（首行空格数=1号星期序号减1）、以及月底必须手动换行等关键细节，助你写出逻辑严谨、格式规范的万年历程序。

用 Calendar 计算某月第一天是星期几，别直接调 get(Calendar.DAY_OF_WEEK)

很多人写万年历时卡在“1号那天是星期几”，以为 get(Calendar.DAY_OF_WEEK) 返回 1–7 就能直接用。其实它返回的是当前日期的星期值（比如今天是周三就返 4），不是该月 1 号的——你得先 set 到当月 1 号再取。

• 必须先 cal.set(Calendar.DAY_OF_MONTH, 1)，再 cal.get(Calendar.DAY_OF_WEEK)
• Calendar.SUNDAY 是 1，Calendar.MONDAY 是 2……但中国习惯周一是第一天，所以要转换：结果减 1 后对 7 取模，再加 1，才能得到「从周一算第几天」的序号
• 注意 Calendar 的月份是 0 起始（0=January），别传错参数，比如想设 2024 年 3 月，得写 cal.set(2024, 2, 1)

打印日历表格时，空格补位逻辑容易错在边界和换行

日历每行 7 天，开头空格数 = 该月 1 号是星期几（按周一为第 1 天）减 1；结尾不用补，但循环到月底后必须手动换行，否则下个月数据会粘在一行。

• 空格数计算示例：若 1 号是周三（即序号 3），前面打 2 个空格（" "，每个日期占 4 字符）
• 用 for (int i = 1; i 打印日期，每次输出后检查 (startOffset + i) % 7 == 0 是否换行，其中 startOffset 是 1 号对应的列偏移（0～6）
• 别用 System.out.print(" " + i) 然后靠 \n 控制——控制台宽度固定，空格数不对会导致错位，建议统一用 String.format("%4d", i)

Calendar 获取当月天数要用 getActualMaximum(Calendar.DAY_OF_MONTH)

直接写 31 或用 if 判 2 月？不行。闰年、大小月、甚至某些 Locale 下的历法差异都会影响结果，getActualMaximum 才是唯一可靠方式。

• 错误写法：if (month == 1) days = isLeapYear(year) ? 29 : 28; ——漏了 Calendar 可能被设为其他时区或 locale，且 isLeapYear 得自己实现
• 正确写法：int daysInMonth = cal.getActualMaximum(Calendar.DAY_OF_MONTH)，它内部已处理所有规则
• 注意：这个方法依赖当前 Calendar 实例的 YEAR 和 MONTH 值，必须先 set 好年份和月份再调

控制台输出对齐混乱，本质是字符宽度没统一

中文环境运行时，“1” 和 “10” 看起来占位不同，其实是字体渲染问题；但更常见的是混用了全角/半角空格，或没考虑负数（虽然万年历没负数）、一位数和两位数的宽度差。

• 所有日期统一用 String.format("%4d", day)，确保占 4 字符宽度（右对齐）
• 不要手拼空格字符串，比如 " " + day，这样 1 和 10 前空格数不一致
• 如果用 IDE 控制台看效果异常，试试改终端字体为等宽字体（如 Consolas、Monaco、Fira Code）
• 别用 \t 对齐——制表符宽度不可控，不同终端表现不一

最麻烦的不是算闰年，而是月份偏移、星期起始、空格计数这三者嵌套在一起时，一个变量名写错或初始化漏掉，整张日历就偏一列。调试时建议先固定年月（比如 2024 年 1 月），把 1 号星期几、当月天数、首行空格数三个值单独打印出来核对。

今天关于《Java Calendar类实现万年历打印教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！