JS获取星期几:原生Date与day.js写法对比

作者:橙子时间:2026-11-18 22:33:03浏览:651

对比JavaScript中通过原生Date对象(getDay、toLocaleDateString)与轻量日期库day.js获取星期几的实现方式,深入剖析周序索引、国际化输出、核心差异与选型建议。

在 JavaScript 开发中,将日期转换为“星期几”或“周几”是各类排班系统、日历视图与数据报表的常见需求。解决这一问题,核心路径主要分为两类:一是利用浏览器内建的原生 Date 对象(通过 getDay() 配合数组映射,或借助现代国际化 API toLocaleDateString);二是使用社区主流的轻量级日期工具库 day.js。本文将具体对比这两种方案的实现代码、底层逻辑、国际化支持以及各自适用的业务边界。

JS获取星期几:原生Date与day.js写法对比
图 1:原生 Date 与 day.js 在语法特征与依赖开销上的直观对比

一、原生 Date 对象获取星期几

浏览器原生内置的 Date 对象无需下载或安装任何额外包,是所有网页与 Node.js 环境的基础设施。在原生环境下获取中文星期,主要有两种具体写法:利用 getDay() 获取数字索引并映射数组,或直接调用国际化格式化方法 toLocaleDateString()。

1. 经典写法:getDay() 配合数组映射

Date.prototype.getDay() 返回一个整数,取值范围是 0 到 6。需要特别注意的是:0 代表星期日,1 代表星期一,依此类推,6 代表星期六。由于该方法本身只返回纯数字,若要呈现“星期几”或“周几”,我们需要预先定义一个对应周序的字符串数组,再通过返回的数字作为数组下标读取。

// 示例 1:基础 getDay 数组映射
function getChineseWeekDay(date = new Date()) {
  // 下标 0 必须精准对应“星期日”
  const weekDays = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
  const dayIndex = date.getDay();
  return weekDays[dayIndex];
}

// 运行示例
const targetDate = new Date('2026-11-18'); // 设定特定日期
console.log(getChineseWeekDay(targetDate)); // 示例输出: "星期三"

下面这幅流程图展示了从日期实例化到最终取出目标中文字符串的完整步骤与数据流向:

JS获取星期几:原生Date与day.js写法对比
图 2:原生 Date 通过 getDay() 配合静态数组实现星期解析的完整步骤
容易混淆的地方:在日常中文语境中,通常认为周一是一周的第一天(ISO 8601 标准也将星期一定为 1,星期日为 7)。但 JavaScript 遵循了早期西方日历的传统规范,将周日排在第 0 位。如果错误地将 ['星期一', '星期二', ..., '星期日'] 作为映射数组,就会导致全量错位:周一会被误判为周二,周日更会因为索引越界导致返回 undefined。

下图详细对比了 JavaScript 原生 getDay() 的索引定义与我们日常中文/ISO 标准之间的映射对应关系:

JS获取星期几:原生Date与day.js写法对比
图 3:JavaScript getDay() 0~6 范围与 ISO 8601 标准 1~7 范围的对比

2. 现代原生 API:toLocaleDateString 与 Intl

如果不想手动声明 ['星期日', '星期一'...] 数组,现代浏览器及 Node.js 均原生支持 ECMAScript 国际化规范(ECMA-402)。我们可以直接通过 toLocaleDateString() 并配置 weekday 参数实现开箱即用的本地化星期输出:

// 示例 2:使用 toLocaleDateString 自动输出本地化星期
const today = new Date();

// 1. 输出完整形式(如:"星期三")
const fullWeek = today.toLocaleDateString('zh-CN', { weekday: 'long' });
console.log(fullWeek); // 示例输出: "星期三"

// 2. 输出缩写形式(如:"周三")
const shortWeek = today.toLocaleDateString('zh-CN', { weekday: 'short' });
console.log(shortWeek); // 示例输出: "周三"

// 3. 高性能批量场景:复用 Intl.DateTimeFormat 实例
const formatter = new Intl.DateTimeFormat('zh-CN', { weekday: 'long' });
console.log(formatter.format(today)); // 示例输出: "星期三"
优点与局限:toLocaleDateString 的优势在于无需开发者自行维护中英文或其他语言映射表,直接交由底层操作系统/运行时的区域配置。局限在于各浏览器的旧版本实现中,格式化字符串的微小标点可能存在细微差异;此外,如果需要定制前缀(例如“礼拜三”),它并不支持随意修改,仍需退回数组映射。

二、day.js 库获取星期几

day.js 是一个极轻量(仅约 2KB)且保持与 Moment.js API 高度兼容的现代化 JavaScript 日期处理库。它采用不可变数据(Immutable)设计,支持流畅的链式调用,极大简化了各类日期的解析、计算与格式化逻辑。

1. 格式化输出:format('dddd') 与 format('ddd')

在 day.js 中获取语义化的中文星期几,通常使用其强大的 format 模板符号。默认情况下,day.js 使用英文语言环境(en)。要输出中文星期,必须引入并挂载 zh-cn 语言包:

// 示例 3:day.js 格式化获取中文星期
import dayjs from 'dayjs';
import 'dayjs/locale/zh-cn'; // 必须显式导入中文语言包

// 全局设置语言为中文
dayjs.locale('zh-cn');

// 或针对单次调用局部生效:dayjs().locale('zh-cn')
const now = dayjs();

// 完整星期:"dddd" => "星期三"
console.log(now.format('dddd')); // 示例输出: "星期三"

// 简写星期:"ddd" => "周三"
console.log(now.format('ddd')); // 示例输出: "周三"

// 组合使用:日期与星期一次性格式化
console.log(now.format('YYYY年MM月DD日 dddd')); // 示例输出: "2026年11月18日 星期三"

2. 数字索引与 isoWeek 插件

除了直接输出格式化字符串,day.js 同样提供了数值维度的 API:

  • dayjs().day():行为与原生的 getDay() 完全一致,返回 0 到 6(0 表示周日)。支持同时作为 setter 使用,例如 dayjs().day(1) 可快速调整日期到本周一。
  • dayjs().isoWeekday():通过安装官方 isoWeek 插件,可以获取符合 ISO 8601 标准的 1 到 7 数值,非常契合按周一为第一天的周报计算业务。
// 示例 4:结合 isoWeek 插件获取 1-7 标准数字
import isoWeek from 'dayjs/plugin/isoWeek';
dayjs.extend(isoWeek);

console.log(dayjs().day());        // 基础 API: 0-6(0 为周日)
console.log(dayjs().isoWeekday()); // 插件 API: 1-7(1 为周一,7 为周日)

下图展示了 day.js 的内部核心机制以及语言包和插件在星期计算中的协作模式:

JS获取星期几:原生Date与day.js写法对比
图 4:Day.js 核心通过挂载语言包与功能插件实现高可读性的星期处理流程

三、全方位对比与技术选型

为了帮助你在实际业务开发中做出合理决策,下表将原生 Date 的两种方式与 day.js 进行了五个维度的深度横向对比:

对比维度 原生 Date (getDay + 数组) 原生 Intl (toLocaleDateString) 第三方库 (day.js)
打包体积 0 KB(内置) 0 KB(内置) 约 2 KB 核心 + ~0.5 KB 语言包
代码简洁度 需要额外维护固定映射数组 单行调用,配置项略显冗长 链式调用极简(.format('dddd'))
多语言/国际化 困难(需手工自建维护多套字典) 优秀(传入 'en-US' 等自动适配) 优秀(支持动态切换几十种语言包)
自定义前缀 极高(可自由定义“礼拜”、“周”、“星期”) 较低(受限于 ECMAScript 规范定义) 中等(依赖 format 或通过字典定制)
周边生态协作 无联动(后续做加减计算需自行编码) 无联动(仅专注于展示格式化) 极强(可与 add、diff 等无缝链式组合)

综合上述特征,面对不同的技术场景,选型逻辑可以总结如下:

  • 极简页面、小型工具库、或对打包体积要求极严(0 依赖)的场景:首选原生 getDay() + 数组映射。单次执行效率高,完全无外部引入风险。
  • 多语言国际化系统,且没有复杂日期运算:首选原生 toLocaleDateString(),利用浏览器底层语言库自动处理各国周首尾命名。
  • 中大型业务系统、企业管理后台、日历应用:果断选择 day.js。除了直接获取星期外,日期加减(.add(1, 'week'))、起止时间计算(.startOf('week'))等高频业务能保持高度一致的 API 风格。
JS获取星期几:原生Date与day.js写法对比
图 5:JavaScript 获取星期几的选型决策与适配路径总结

四、避坑指南与常见问题

在日常使用中,除了基础语法,以下三处隐蔽的边界问题往往是导致线上星期展示 bug 的主要原因:

1. 混淆 getDay() 与 getDate()

初学者容易将 getDay() 与 getDate() 搞混:

  • date.getDay():获取的是星期几(0~6)。
  • date.getDate():获取的是当前月份的几号(1~31)。

如果在写映射时误用了 getDate(),在每月 7 号以后便会直接造成数组越界(输出 undefined)。

2. 时区偏移导致的“跨天”星期偏差

当处理服务端返回的 ISO 字符串(例如 2026-11-17T23:30:00Z)时,该时间对应北京时间(UTC+8)次日凌晨 07:30。如果在客户端使用 new Date().getUTCDay(),会返回前一天的星期数;而使用 new Date().getDay() 或 dayjs() 则默认按照用户本地设备时区解析。在处理涉及不同国家/地区的航班或会议日程时,务必统一前后端使用的时区口径。

3. day.js 忘记引入语言包输出英文

在前端打包(如 Webpack / Vite)环境中,day.js 默认采用 Tree-shaking 优化,只保留 en 语言环境。如果在调用 dayjs().format('dddd') 之前未显式调用 import 'dayjs/locale/zh-cn',输出结果将是 "Wednesday" 而非 "星期三"。在大型工程中,推荐在项目的入口文件(如 main.js 或 index.ts)集中全局挂载一次,避免在各个组件内重复引用。

作者最新文章
相关文章
更多