JavaScript怎么将getDay()数字转换为中文星期几

作者:异步漫步

时间:2026-11-17

浏览:478

深入讲解在 JavaScript 中如何将 Date.prototype.getDay() 返回的 0~6 整数准确转换为中文星期几(如星期日、周一等)。涵盖底层规则、数组查表、字符串索引、Intl 国际化与工业级健壮函数封装。

文章目录

在 JavaScript 中,Date.prototype.getDay() 方法返回的是一个 0 到 6 的整数,分别代表星期日到星期六。将该数字转换为中文“星期几”或“周几”最简洁高效的方式是数组查表法:定义一个中文名称数组 ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'],直接通过数字作为下标索引读取;也可以使用现代浏览器内置的原生 Intl.DateTimeFormat 实现标准本地化转换。

JavaScript怎么将getDay()数字转换为中文星期几
图 1:getDay() 数字转换为中文星期几核心流程概览

一、理解 getDay():返回值机制与常见思维误区

在深入编写转换代码前,必须先厘清 Date 对象中关于日期的两个核心方法,这是很多开发者初次处理时间格式化时最容易混淆的地方:

  • getDay():返回当前日期处于一周中的第几天,结果为整数 0 ~ 6。
  • getDate():返回当前日期处于当月中的第几号,结果为整数 1 ~ 31。

除了与 getDate() 的名称混淆外,最核心的认知陷阱在于起始值的文化与历法差异。在中国的日常生活习惯中,通常认为“星期一”是一周的开始;但 ECMAScript 标准遵循西方传统历法规则,将“星期日”定为一周的第 0 天。具体对应关系如下:

  • 0 对应 星期日(周日)
  • 1 对应 星期一(周一)
  • 2 对应 星期二(周二)
  • 3 对应 星期三(周三)
  • 4 对应 星期四(周四)
  • 5 对应 星期五(周五)
  • 6 对应 星期六(周六)

因此,整个取值空间是闭区间 [0, 6],绝对不会出现返回值 7 的情况。任何假设“7 代表星期日”的逻辑都会导致运行时下标越界或返回 undefined。

JavaScript怎么将getDay()数字转换为中文星期几
图 2:JavaScript getDay() 返回值与中文星期的严谨对应关系
⚠️ 关键提醒:下标 0 必须与“日”绑定

如果你在创建映射数组时不小心将“星期一”排在第 0 位(例如 ['星期一', '星期二', ..., '星期日']),那么周日(0)会被错误映射为“星期一”,所有星期的显示都会整体向后偏移一天。

二、转换操作的标准流程

无论是开发日常组件还是封装公共日期库,将日期数字安全转换为中文星期几都需要经过一个确定性的处理管道。

JavaScript怎么将getDay()数字转换为中文星期几
图 3:数字转中文星期几的标准处理流水线

标准处理流程分为五个连贯步骤:

  1. 实例准备:获取需要判断的 Date 实例。可以是当前时刻 new Date(),也可以是从接口或用户输入解析的时间对象。
  2. 合法性防护:检查日期对象是否有效。若传入空字符串或非法格式字符串,new Date('invalid') 会生成 Invalid Date,直接调用 getTime() 为 NaN,必须在早期拦截并进行兜底。
  3. 提取索引:调用 date.getDay() 取得 0 ~ 6 的整型数值。
  4. 查表映射:利用数组常数时间复杂度 \(O(1)\) 的特性,取出对应的中文字符。
  5. 拼装输出:依据业务界面需要,与前缀(如“星期”、“周”或无需前缀)拼装为目标字符串。

三、四种转换实现方案深度解析

方案一:数组查表法(工程首选推荐)

数组查表法是 JavaScript 中将连续整数转换为映射文案的最经典、性能最高且语义最直观的模式。

// 基础完整写法
const date = new Date();
const dayIndex = date.getDay();

const weekDays = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
const chineseDay = weekDays[dayIndex];

console.log(chineseDay); // 示例输出:"星期二"

在实际开发中,我们往往需要灵活切换“周几”或“星期几”。此时更推荐解耦前缀与基础数字,只用数组存储 ['日', '一', '二', '三', '四', '五', '六']:

function getChineseWeekDay(date, prefix = '星期') {
  const days = ['日', '一', '二', '三', '四', '五', '六'];
  return prefix + days[date.getDay()];
}

console.log(getChineseWeekDay(new Date(), '周'));   // 示例输出:"周二"
console.log(getChineseWeekDay(new Date(), '星期')); // 示例输出:"星期二"

方案二:字符串 charAt 索引法(极简轻量级)

在 JavaScript 中,字符串可以直接通过下标或 charAt() 访问单个字符。因为中文星期数字均为单字(日、一、二、三、四、五、六),可以直接利用紧凑字符串充当映射字典:

const date = new Date();
const chineseChar = '日一二三四五六'.charAt(date.getDay());
const result = `星期${chineseChar}`;

console.log(result); // 示例输出:"星期二"

这种写法的优势在于语法极短、打包后体积微小且不需要分配数组对象。缺点是如果需求变更为需要返回多字(如带定制样式或英文全拼),则无法直接扩展。

方案三:原生 Intl.DateTimeFormat 国际化方案

ECMAScript 国际化 API(Intl)为现代前端提供了内置的本地化格式化支持,免去了手动维护映射字典的工作。

const date = new Date();

// 方式 A:直接使用 toLocaleDateString
const strLong = date.toLocaleDateString('zh-CN', { weekday: 'long' });  // 示例输出:"星期二"
const strShort = date.toLocaleDateString('zh-CN', { weekday: 'short' }); // 示例输出:"周二"

// 方式 B:高频调用场景复用 Intl 格式化器实例
const formatter = new Intl.DateTimeFormat('zh-CN', { weekday: 'long' });
console.log(formatter.format(date)); // 示例输出:"星期二"

适用边界:Intl 方案在跨语言、多国多地区项目中优势极为明显。但需要注意:如果系统只需要一个单纯的中文数字(例如日历网格头部仅需“日”、“一”),Intl 提供的选项受限于 Unicode CLDR 标准,不能像数组那样由开发者完全自定义任意字符。

方案四:switch / if 多分支结构(反面示例与对比)

初学者容易采用 switch(day) 分别判断 0 到 6 的做法。虽然逻辑直观,但极不推荐在实际项目中使用:

// 不推荐的冗长写法
function getWeekDayBySwitch(day) {
  switch (day) {
    case 0: return '星期日';
    case 1: return '星期一';
    case 2: return '星期二';
    case 3: return '星期三';
    case 4: return '星期四';
    case 5: return '星期五';
    case 6: return '星期六';
    default: return '';
  }
}

相比于一行数组查表,switch 产生了 20 多行重复样板代码,不仅增加了打包体积,且一旦格式需要从“星期”改为“周”,需要逐行手动更改 7 处,极大增加了代码维护负担。

JavaScript怎么将getDay()数字转换为中文星期几
图 4:四种常见星期转换方案多维对比矩阵

四、工业级工具函数封装与边界防护

在真实的生产环境中,工具函数面临的输入往往是复杂的:有的地方传入 Date 对象,有的地方传入时间戳或日期字符串,还有的地方已经提前调用了 getDay() 直接传入数字。

一个合格的工业级转换函数,应当具备以下特性:

  • 多态入参兼容:支持 Date 对象、时间戳/字符串以及 0~6 纯数字。
  • 边界防护校验:严格拦截 Invalid Date、越界整数及非数值类型。
  • 灵活格式控制:自由指定前缀(“周”、“星期”、“礼拜”或空前缀)。
  • 优雅降级兜底:遇到异常输入时返回指定的 fallback 字符串,而非直接抛出异常或泄露 undefined。
JavaScript怎么将getDay()数字转换为中文星期几
图 5:工业级星期转换函数整体架构与防御决策树

下面是经过生产验证的完整工具函数实现:

/**
 * 将 Date 对象或 getDay() 返回的数字转换为中文星期
 * @param {Date|number|string} input - 日期对象、时间戳、ISO日期串或 0~6 数字
 * @param {Object} options - 配置项
 * @param {string} [options.prefix='星期'] - 前缀,例如 '星期'、'周'、'礼拜'、''
 * @param {string} [options.fallback='--'] - 输入无效时的兜底文本
 * @returns {string} 中文星期结果
 */
function formatChineseWeekday(input, options = {}) {
  const { prefix = '星期', fallback = '--' } = options;
  const WEEK_NAMES = ['日', '一', '二', '三', '四', '五', '六'];

  let dayIndex;

  // 分支 1:直接传入数字(0~6)
  if (typeof input === 'number' && Number.isInteger(input) && input >= 0 && input <= 6) {
    dayIndex = input;
  }
  // 分支 2:传入 Date 实例
  else if (input instanceof Date) {
    if (Number.isNaN(input.getTime())) {
      return fallback; // 拦截 Invalid Date
    }
    dayIndex = input.getDay();
  }
  // 分支 3:尝试将字符串或时间戳解析为 Date
  else if (typeof input === 'string' || (typeof input === 'number' && !Number.isNaN(input))) {
    const parsed = new Date(input);
    if (Number.isNaN(parsed.getTime())) {
      return fallback;
    }
    dayIndex = parsed.getDay();
  }
  // 分支 4:非法类型直接兜底
  else {
    return fallback;
  }

  return `${prefix}${WEEK_NAMES[dayIndex]}`;
}

完整示例与运行验证

针对不同场景与边界条件的运行结果如下:

// 1. 传入当前 Date 对象
formatChineseWeekday(new Date()); 
// 示例输出:"星期二"

// 2. 指定前缀为 "周"
formatChineseWeekday(new Date(), { prefix: '周' }); 
// 示例输出:"周二"

// 3. 直接传入 getDay() 返回的数字
formatChineseWeekday(0); 
// 示例输出:"星期日"(0 准确映射为日)

// 4. 传入日期字符串
formatChineseWeekday('2026-11-17', { prefix: '周' }); 
// 示例输出:"周二"

// 5. 异常输入边界测试
formatChineseWeekday('invalid-date-string'); 
// 示例输出:"--"(安全降级,不崩盘)

formatChineseWeekday(7); 
// 示例输出:"--"(超出 0~6 范围,安全拦截)

五、开发中的高频踩坑点与避坑指南

在日常业务开发中,围绕 getDay() 转换中文星期的典型错误主要有以下三类:

1. 日期字符串解析时的时区偏移导致星期偏移一天

在前端直接调用 new Date('2026-11-17') 时,ECMAScript 会将其视作 UTC 时间(2026-11-17T00:00:00.000Z)。在中国标准时间(UTC+8)环境下,该时间解析为本地时间的上午 8 点,日期依然是 17 号;但在西五区(如美国东部时间 UTC-5),本地时间则是前一天的晚上 19 点,导致 getDay() 得出周一而不是周二。

💡 建议解决方案

如果需要转换纯日期字符串而不希望受时区解析差异影响,建议使用斜杠格式(如 '2026/11/17')让浏览器按本地时间解析,或显式拆分年月日传入构造函数:new Date(2026, 10, 17)。

2. 将 getDay() 当成一星期中的第几天下意识做加减

部分开发者由于习惯了“周一是 1,周日是 7”,试图通过 day === 0 ? 7 : day 将其转换为 1 到 7 的范围。这种转换在配合自定义数字字典时徒增转换复杂度,而且容易导致索引越界。实际上,只要让字典数组从第 0 项对应“日”,就完全不需要做任何偏移计算。

3. 忽略 undefined 处理导致页面出现“星期undefined”

如果页面数据异步加载,时间尚未返回时就直接执行 ['日','一',..][date?.getDay()],在 date 为 null 或加载失败时,表达式会计算为 undefined,最终拼装成 "星期undefined" 展示在 UI 界面上。务必在模板渲染层加入空值判断(如可选链与空值合并运算符 ??)。

六、总结

将 JavaScript 中 getDay() 的数字转换为中文星期几,本质是一个小而核心的映射问题。掌握以下三点即可游刃有余:

  • 牢记底层基准:getDay() 返回 0 ~ 6,其中 0 必须且永远对应 星期日。
  • 首选方案明确:标准中文业务优先使用数组查表法(['日','一',..][day]),兼具最高的执行性能与灵活性。
  • 工程化防护:封装时对输入进行非空与有效性校验,杜绝 Invalid Date 和 undefined 渗透到用户界面。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章