深入解析 JavaScript 中 Date.prototype.getDay() 返回值为什么是 0 到 6 以及为什么 0 代表星期日。系统梳理从 C 语言规范、Java 继承到 JavaScript 的历史沿革,并提供中文星期转换、ISO 8601 标准转换及 Date 核心方法避坑指南。
JS getDay()返回值详解:为什么0代表星期日
时间:2026-11-19
浏览:213
文章目录
date.getDay() 时,返回的是一个 0 到 6 之间的整数,其中 0 始终固定代表星期日,1 到 6 依次对应星期一到星期六。这一设定常常让习惯“以星期一为一周开始”的初学者产生困惑。本文将直接拆解 getDay() 的数值映射规律,追溯其从 C 语言规范、Java 继承到 JavaScript 的设计始末,并提供在业务中将数字转换成中文星期、ISO 8601 标准以及避开常见日期 API 陷阱的具体方案。
一、getDay() 返回值基础定义与数字对照
Date.prototype.getDay() 是 JavaScript 原生 Date 对象实例上的标准读取方法。它的唯一职责是返回给定日期所处的那一天是星期几。
需要明确的是,getDay() 遵循“0 基准”(0-indexed)的数值序列,总共产生 7 种离散的整数输出:
| 返回值 (Number) | 对应星期 (中文) | 英文全称 | 英文缩写 | 日常场景属性 |
|---|---|---|---|---|
| 0 | 星期日 | Sunday | Sun | 传统首日 / 周末公休日 |
1 |
星期一 | Monday | Mon | 商务工作日 |
2 |
星期二 | Tuesday | Tue | 商务工作日 |
3 |
星期三 | Wednesday | Wed | 商务工作日 |
4 |
星期四 | Thursday | Thu | 商务工作日 |
5 |
星期五 | Friday | Fri | 商务工作日 |
6 |
星期六 | Saturday | Sat | 周末公休日 |
很多开发者在刚刚接触该方法时,最容易主观推测“1 代表周一,那 7 就代表周日”,甚至误以为 0 是某种空值或异常值。但在规范中,0 是具有明确含义且合法的常数索引。
二、为什么 0 代表星期日?历史设计溯源与规范演进
为什么当时没有将 1 作为周一、7 作为周日?这并非前端社区在 1995 年的心血来潮,而是一段层层继承的计算机工程历史。
1. 溯源 UNIX 与 C 语言标准库
早在 20 世纪 70 年代,UNIX 系统与 C 语言标准库(time.h)在定义时间结构体 struct tm 时,就设定了成员字段 int tm_wday。C 标准库中对 tm_wday 的定义明确写道:表示自星期日以来的天数,范围为 0 至 6(0 代表 Sunday)。
这一规定既符合当时美国日历将周日(Sunday,太阳日)排在日历最左侧的传统社会习俗,也符合计算机在底层做基准位移偏置(offset from base day)时的 0 基准整数设计。
2. Java 1.0 的直接封装
1995 年 5 月 Sun 公司推出 Java 语言时,其初版 java.util.Date 类的底层实现大量参考并近乎镜像复制了 C 语言的 struct tm 结构。Java 同样提供了 public int getDay() 方法,且返回值完全沿用了 0 = Sunday 的约定。
3. Brendan Eich 在 10 天内的设计约束
1995 年 12 月,网景公司(Netscape)工程师 Brendan Eich 奉命在短短 10 天内为 Netscape Navigator 浏览器研发出一套轻量脚本语言(Mocha,即后来的 JavaScript)。为了抢占市场先机,并且服从网景管理层“语法和外貌向 Java 靠拢”的商业指令,Brendan Eich 在实现 JavaScript 的 Date 对象时,直接将 Java 1.0 的 java.util.Date API 原样移植进了 JavaScript 引擎。
4. 为什么后续没有被推翻重构?
随着全球化协作的深入,国际标准化组织推出了 ISO 8601 日期标准,明确规定星期一为一周的第一天,编号为 1;星期日为一周的最后一天,编号为 7。
尽管 ISO 8601 与生活工作节奏更加匹配,但 Web 遵循一条铁律:“不破坏现有 Web(Don't break the web)”。全球已有无数运行中的网站和业务逻辑依赖 getDay() === 0 来判断星期日。若在 ECMAScript 引擎中擅自改变 getDay() 的返回值语义,将导致全球数以亿计的日历、排班和计时系统发生静默故障。因此,这一设计被永久固化在 ECMAScript 标准中。
三、实战操作:业务中如何高效转换 getDay() 返回值
在实际的前端与 Node.js 业务开发中,我们通常需要根据具体业务场景,将 getDay() 产生的 0~6 转换为符合中国人习惯的汉字表达,或转换为符合后端接口要求的 ISO 8601 标准数字。
场景 1:转换为中文“星期几”或“周几”(最优雅的查表法)
由于 getDay() 返回的是非负整数 0~6,它天然就是 JavaScript 数组的理想索引。利用静态数组查表法(Lookup Table),可以用一行代码消除所有的 switch-case 或复杂的 if-else 分支:
// 完整示例:格式化当前日期的星期文本
function formatChineseWeekday(date = new Date()) {
// 索引 0 恰好对应数组首项 '星期日'
const weekDays = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
return weekDays[date.getDay()];
}
// 运行示例说明:
// 假设当前日期为 2026年11月15日(周日)
console.log(formatChineseWeekday(new Date('2026-11-15T10:00:00')));
// 输出示例: "星期日"
场景 2:转换为 ISO 8601 标准数值(周一为1,周日为7)
当业务接口遵循 ISO 8601 国际标准(例如与后端数据库对齐排班序号)时,需要将星期日从 0 映射为 7,其余 1~6 保持不变:
// 方法 A:三元运算符(直观明了)
function getIsoDayOfWeek(date = new Date()) {
const day = date.getDay();
return day === 0 ? 7 : day;
}
// 方法 B:模运算数学归一化公式
// (day + 6) % 7 + 1
// 当 day=0: (0 + 6) % 7 + 1 = 6 + 1 = 7
// 当 day=1: (1 + 6) % 7 + 1 = 0 + 1 = 1
const toIsoDay = (day) => ((day + 6) % 7) + 1;
场景 3:判断是否为周末(公休日)
在许多业务系统中,需要对周末做特殊标记或禁用排班。根据 getDay() 的定义,周末对应两端数值 0(周日)和 6(周六):
function isWeekend(date = new Date()) {
const day = date.getDay();
return day === 0 || day === 6;
}
四、常见误区与避坑指南
在处理 JavaScript 原生日期时,getDay() 往往因为名称相似和时区问题成为 Bug 频发的“高危地带”。以下整理三大高频混淆点:
date.getDay():获取的是星期几(范围 0 ~ 6,0 代表星期日)。date.getDate():获取的是月份中的几号(范围 1 ~ 31,自然日数)。
getDate()。切勿在拼接 YYYY-MM-DD 格式时误用 getDay(),否则日期字段将变成 0~6 之间的离奇数字。
getMonth() 同样源自 C 语言,返回值是 0 ~ 11(0 代表一月)。很多人因此推测“Date 的所有方法都必须加 1”,于是错误地给 getDay() 加上 1。请牢记:getDay() 返回 0 就已经代表合法的星期日,无须加 1;只有 getMonth() 在日常显示月份时才需要加 1。
getDay() 计算的是客户端运行环境的本地时区时间。如果 Node.js 服务器部署在格林威治标准时间(UTC 0),而中国国内用户在北京时间(UTC+8)周一早上 05:00 访问系统,此时本地时间是周一(getDay() === 1),但在 UTC 视角下依然是周日深夜 21:00(getUTCDay() === 0)。跨时区服务计算日期边界时,务必统一选用本地方法或 getUTCDay()。
五、最佳实践总结与核心自查表
为了在日常编码中快速排查与准确编写星期逻辑,可参考以下自查清单:
- 牢记 0 代表星期日:
0 = 周日,1 = 周一,6 = 周六。 - 善用数组查表:
['日','一','二','三','四','五','六'][day]是处理中文星期的最佳实践。 - 区分三大方法:周几用
getDay()(0~6),几号用getDate()(1~31),月份用getMonth()(0~11)。 - 涉及国际标准:与后端交互要求 1~7(周一至周日)时,使用
day === 0 ? 7 : day转换。 - 现代替代方案:如需进行复杂的本地化国际化文案输出,现代浏览器还支持
date.toLocaleDateString('zh-CN', { weekday: 'long' }),直接返回原生格式化的中文星期名称。
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。