JS getDay()返回值详解:为什么0代表星期日

作者:小括号时间:2026-11-19 10:16:54浏览:214

深入解析 JavaScript 中 Date.prototype.getDay() 返回值为什么是 0 到 6 以及为什么 0 代表星期日。系统梳理从 C 语言规范、Java 继承到 JavaScript 的历史沿革,并提供中文星期转换、ISO 8601 标准转换及 Date 核心方法避坑指南。

标准参考:ECMAScript Date Specification JavaScript 基础核心 阅读时长:约 7 分钟
JS getDay()返回值详解:为什么0代表星期日
在 JavaScript 中调用 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 是具有明确含义且合法的常数索引。

JS getDay()返回值详解:为什么0代表星期日
图 1:getDay() 返回值与星期全量映射体系及数组下标对应关系

二、为什么 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 引擎。

JS getDay()返回值详解:为什么0代表星期日
图 2:从 1970 年代 C 标准库到现代 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 标准数字。

JS getDay()返回值详解:为什么0代表星期日
图 3:业务实操中从 getDay() 原始值到具体交付结果的四步标准化流程

场景 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 频发的“高危地带”。以下整理三大高频混淆点:

JS getDay()返回值详解:为什么0代表星期日
图 4:JavaScript Date 核心时间获取方法对照与防呆避坑指南
高频陷阱 1:混淆 getDay() 与 getDate()
  • date.getDay():获取的是星期几(范围 0 ~ 6,0 代表星期日)。
  • date.getDate():获取的是月份中的几号(范围 1 ~ 31,自然日数)。
英文单词中“Day”在口语中容易被当成“日期几号”,但 JS 规范将几号命名为 getDate()。切勿在拼接 YYYY-MM-DD 格式时误用 getDay(),否则日期字段将变成 0~6 之间的离奇数字。
高频陷阱 2:与 getMonth() 的 0-based 混淆
getMonth() 同样源自 C 语言,返回值是 0 ~ 11(0 代表一月)。很多人因此推测“Date 的所有方法都必须加 1”,于是错误地给 getDay() 加上 1。请牢记:getDay() 返回 0 就已经代表合法的星期日,无须加 1;只有 getMonth() 在日常显示月份时才需要加 1。
高频陷阱 3:跨时区服务器上的 getDay() 与 getUTCDay()
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' }),直接返回原生格式化的中文星期名称。
作者最新文章
相关文章
更多