JS Date获取年月日注意事项:为什么月份要减1?
详细解析JavaScript Date对象月份从0开始的原因,说明构造日期时月份减1与getMonth()读取时加1的双向规则,以及getFullYear、getDate、补零和UTC时区偏移等常见注意事项。
Date 对象)
getMonth() 读取展示时加 1。在 JavaScript 中操作 Date 对象时,月份之所以经常需要“减 1”,根本原因在于 ECMAScript 规范把月份定义为从 0 开始的索引(0 代表 1 月,11 代表 12 月)。因此,当你手里拿着日常习惯的 1 到 12 月数字去构造或修改日期(例如 new Date(2026, month - 1, day))时,必须先减 1 才能对应到内部索引;而用 getMonth() 获取月份并展示给用户时,则需要反过来加 1。
把“传入减 1”和“读取加 1”弄反,是处理年月日时最常出现的错误。除此之外,获取年份、日期、补零以及本地时间与 UTC 的时区差异,同样容易导致结果偏差。下面按原理、常见注意事项、完整示例和方案对比依次说明。
一、为什么 JS Date 的月份要从 0 开始?
JavaScript 的 Date 对象并非从零独立设计。1995 年语言诞生初期,其日期接口直接参照了 Java 1.0 中的 java.util.Date,而后者又沿用了 C 语言标准库 struct tm 的字段约定。在 struct tm 中,tm_mon 的含义是“自 1 月起经过的月数”(months since January),取值范围为 0 到 11。
这种设计在编程语言里有一个直接便利:月份数字可以直接充当零基数组下标。例如定义一个月份名称数组 const months = ['一月', '二月', ..., '十二月'],读取时直接写 months[date.getMonth()] 就能取到对应文本,不必再写 - 1。但代价是,只要开发者按人类日历习惯读写数字月份,就必须在接口边界上完成 1–12 与 0–11 之间的换算。
1. 传入数值构造或设置日期(
new Date(year, monthIndex, day)、setMonth(monthIndex)):把日常月份 1–12 转为内部索引,需要 month - 1。2. 从 Date 实例读取并展示(
date.getMonth()):返回值本身就是 0–11,转为日常月份需要 getMonth() + 1。3. 传入标准日期字符串(如
'2026-04-01' 或 '2026-04-01T00:00:00'):字符串遵循 ISO 8601 格式,04 就代表 4 月,不需要减 1。
getMonth() 读取时加 1;而 ISO 字符串和数组下标查表是两个常见例外。二、获取年月日的 4 个高频注意事项
在实际项目中,仅仅记住月份的 0–11 偏移还不够。Date 的方法命名存在历史包袱,且解析规则与时区紧密绑定,以下 4 个位置最容易出错。
1. 获取年份用 getFullYear(),不要用 getYear()
Date.prototype.getYear() 返回的是“当前年份减去 1900”的整数。例如在 2026 年调用 getYear(),得到的不是 2026,也不是两位数 26,而是 126。该方法早在 ECMAScript 标准中被标记为遗留特性,获取四位年份应统一使用 getFullYear()。
2. 获取“几号”用 getDate(),不要误写成 getDay()
这是初学阶段混淆率最高的一对方法:
getDate():返回当月的第几天(1到31),即我们常说的“几号”。getDay():返回星期几(0到6,其中0表示周日,1到6表示周一到周六)。
如果把 getDay() 当作“日”去拼接 YYYY-MM-DD,代码不会报错,但周日会变成 0 号,周五会变成 5 号,极难通过语法检查发现。
3. 月份和日期不自带前导零,拼接前需补零
getMonth() + 1 和 getDate() 返回的都是纯数字(number 类型)。遇到 4 月 1 日时,分别返回 4 和 1,直接拼接字符串会得到 "2026-4-1",不符合常见的 YYYY-MM-DD 格式要求,也无法直接用于按字典序比较日期大小。通过 String(value).padStart(2, '0') 可以稳定补足两位。
4. 警惕 'YYYY-MM-DD' 引发的 UTC 时区偏移
在 ECMAScript 规范中,不带时间的纯日期字符串(如 new Date('2026-04-01'))会被按 UTC 零点(2026-04-01T00:00:00.000Z)解析,而 getFullYear()、getMonth()、getDate() 读取的却是运行环境的本地时间。
这会带来跨时区不一致的结果:在西五区(UTC-5),UTC 零点对应本地时间 2026-03-31 19:00:00,此时调用 getMonth() + 1 和 getDate() 拿到的结果是 3 月 31 日,日期直接少了一天;而在东八区(UTC+8),如果是带 Z 的夜间时间戳 '2026-03-31T20:00:00Z',本地时间会推进到 2026-04-01 04:00:00,日期又会多出一天。
要避免这类偏差,要么使用数值参数构造本地日期(new Date(2026, 3, 1)),要么在字符串中明确附带本地时间 '2026-04-01T00:00:00'(不带 Z);如果数据源本身代表 UTC 时间且需要按 UTC 展示,则成套改用 getUTCFullYear()、getUTCMonth() + 1 和 getUTCDate()。
三、完整代码示例与“日期进位”边界处理
以下代码可在任意现代浏览器开发者工具控制台(Console)或 Node.js 环境中直接运行。示例中分别演示了两个最常用的场景:一是把已有的 Date 实例格式化为本地 YYYY-MM-DD,二是根据外部传入的年、月、日数字安全构造日期。
// 1. 获取本地年月日并格式化为 YYYY-MM-DD
function formatLocalDate(date) {
if (!(date instanceof Date) || Number.isNaN(date.getTime())) {
throw new TypeError('请传入有效的 Date 实例');
}
const year = date.getFullYear();
const month = String(date.getMonth() + 1).padStart(2, '0');
const day = String(date.getDate()).padStart(2, '0');
return `${year}-${month}-${day}`;
}
// 2. 根据人类习惯的年、月(1-12)、日构造 Date,并拦截非法进位
function createSafeDate(year, month, day) {
// 构造时必须将月份减 1
const date = new Date(year, month - 1, day);
// 回读校验:防止如 2026-02-30 被自动进位成 2026-03-02
if (
date.getFullYear() !== year ||
date.getMonth() + 1 !== month ||
date.getDate() !== day
) {
throw new RangeError(`无效日期: ${year}-${month}-${day}`);
}
return date;
}
const springDay = createSafeDate(2026, 4, 1);
console.log('内部 getMonth() 值:', springDay.getMonth());
console.log('格式化结果:', formatLocalDate(springDay));
示例输出
内部 getMonth() 值: 3
格式化结果: 2026-04-01
上面 createSafeDate 中的回读校验解决了一个和“月份减 1”密切相关的隐蔽问题——日期溢出自动顺延。JS Date 在接收到超出当月天数的参数时不会抛出错误,而是向后进位。例如,某人误把 2 月当成 2 传入 new Date(2026, 2, 31),原本想找 2 月末尾,实际传的是 3 月 31 日;而即便记得减 1 传入 new Date(2026, 1, 30),2026 年 2 月只有 28 天,Date 会默默顺延成 2026-03-02。通过构造后立即用 getFullYear()、getMonth() + 1、getDate() 与原值核对,就能在第一时间拦截越界输入。
四、实际开发中的取舍:原生 Date、toISOString() 还是日期库?
有些开发者嫌 getMonth() + 1 和 padStart 繁琐,会采用 date.toISOString().slice(0, 10) 来一行获取 YYYY-MM-DD。这是一个典型的“看似简洁、实际有条件限制”的反例:toISOString() 永远输出 UTC 时间。在中国标准时间(UTC+8)的早上 07:30 调用它,例如本地时间 2026-04-01 07:30:00,对应的 UTC 时间仍是前一天的 2026-03-31 23:30:00,截取结果就会变成 "2026-03-31"。
因此,是否继续手写 Date 年月日处理,取决于具体场景:
- 只需获取或展示本地
YYYY-MM-DD:用上面十几行的原生formatLocalDate函数即可,零依赖、逻辑透明;如果只做界面格式化展示,也可以使用内置的Intl.DateTimeFormat指定格式与时区。 - 涉及加减月份、跨时区调度或严格日历计算:例如“在 1 月 31 日基础上加 1 个月”,原生
setMonth(date.getMonth() + 1)会因 2 月没有 31 日而跳到 3 月。这类业务更适合使用dayjs、date-fns等成熟库,或在目标运行环境确认支持后采用新的TemporalAPI(其中Temporal.PlainDate的月份已改为从1开始)。
五、总结与核心方法速查
理解 JS Date 获取与构造年月日的重点,本质上是记住“月份内部从 0 计起”这一条源头规则:从日历数字进入 Date 要减 1,从 Date 回到日历展示要加 1;同时避开 getYear()、getDay()、缺前导零和纯日期字符串 UTC 解析这四个高频陷阱。下方速查图和对照表可作为日常编码时的核对清单。
| 操作目标 | 推荐写法 | 返回值 / 参数范围 | 关键注意事项 |
|---|---|---|---|
| 用数值构造本地日期 | new Date(year, month - 1, day) |
month - 1 为 0–11 |
必须减 1,且建议回读校验防月末进位 |
| 获取四位年份 | date.getFullYear() |
如 2026 |
不要使用已废弃的 getYear() |
| 获取日常月份 | date.getMonth() + 1 |
原值 0–11,加 1 后为 1–12 |
仅做数组下标查表时才不需要加 1 |
| 获取当月几号 | date.getDate() |
1–31 |
不要与返回星期 0–6 的 getDay() 混淆 |
| 获取 UTC 年月日 | getUTCFullYear() / getUTCMonth() + 1 / getUTCDate() |
月份仍为 0–11 |
用于解析带 Z 或纯 YYYY-MM-DD 的 UTC 时间 |
JS类数组对象与普通对象转数组的方法有何不同
2026-11-22 18:46:59
浏览器前端怎么用Fetch API加载JSON文件
2026-11-22 17:10:10
ES5环境下怎么实现JS动态参数兼容
2026-11-22 16:56:30
为什么JS filter筛选结果不符合预期?常见陷阱与调试方法
2026-11-22 16:34:17
JavaScript中判断null、undefined及空值的最佳实践
2026-11-22 15:43:07








