详细讲解在JavaScript中将当前月份转换为中文格式(一月、二月至十二月)的核心方法,涵盖数组查表映射法与现代Intl.DateTimeFormat原生API,提供完整代码示例、原理图解及避坑指南。
JS将当前月份转换为中文格式(一月、二月)的方法
时间:2026-11-20
浏览:373
文章目录
在前端界面展示与报表渲染中,将系统当前月份直接转化为符合中文习惯的“一月”、“二月”等格式是非常常见的需求。在 JavaScript 中,最常用且成熟的实现路径主要有两种:一种是基于 Date.prototype.getMonth() 的数组查表法,另一种则是使用现代 ECMAScript 提供的 Intl.DateTimeFormat 国际化 API。本文将针对这两种方法的实现步骤、技术原理、差异对比及常见踩坑点展开完整讲解。
一、为什么不能直接输出中文月份?理解 getMonth() 的索引机制
在 JavaScript 中,获取时间的内置对象是 Date。想要获取当前月份,开发者通常会调用其实例方法 date.getMonth()。但初学者往往会遇到两个明显的直觉落差:
- 返回的是纯数字而非文本:
getMonth()只会返回数值,不会自动翻译为中文或英文名称。 - 零基索引(Zero-based):其返回值的范围是
0 ~ 11,其中0代表 1 月,1代表 2 月,以此类推,11代表 12 月。
这种设计起源于 early C 语言标准库中的 struct tm 规范。在将数字月份显示为“1月、2月”时,我们需要执行 getMonth() + 1。然而在转换为中文“一月、二月”时,刚好数组的下标也是从 0 开始,这使得数组映射具备了天然的契合优势。
now.getMonth() + 1);但在使用预设数组转换中文月份时,千万不要加 1,否则会导致月份向后偏移一个月,并在 12 月时产生数组越界错误(索引 12 超出数组范围)。
二、方法一:基于数组查表法(高效、直观且零依赖)
数组查表映射法是前端开发中最经典且推荐的方案。其原理是预先定义一个包含 12 个中文月份名称的常量数组,然后直接使用 date.getMonth() 返回的数字作为下标来提取对应的中文字符串。
1. 核心操作步骤流程
整个操作流程分为四步:实例化日期对象、提取月份索引、准备中文名称字典、依据索引查表获取结果。
2. 完整代码示例
// 1. 基础单次调用实现
const now = new Date();
const chineseMonths = [
"一月", "二月", "三月", "四月",
"五月", "六月", "七月", "八月",
"九月", "十月", "十一月", "十二月"
];
// 利用 0-11 的返回值直接作为数组下标访问
const currentMonthCN = chineseMonths[now.getMonth()];
// 示例输出:若当前为11月,则输出 "十一月"
console.log(currentMonthCN);
3. 封装为可复用的通用函数
为了避免每次使用都重复创建数组对象,建议将月份字典声明在模块或闭包中,并提供默认参数支持:
// 将字典提至外部常驻内存,提升函数复用性能
const CHINESE_MONTH_NAMES = Object.freeze([
"一月", "二月", "三月", "四月",
"五月", "六月", "七月", "八月",
"九月", "十月", "十一月", "十二月"
]);
/**
* 获取指定日期或当前日期的中文月份全称
* @param {Date|number|string} targetDate - 可选入参,默认当前系统时间
* @returns {string} 中文月份,例如 "三月"
*/
function getChineseMonth(targetDate = new Date()) {
const dateObj = targetDate instanceof Date ? targetDate : new Date(targetDate);
// 处理无效日期情况
if (isNaN(dateObj.getTime())) {
throw new Error("Invalid Date provided to getChineseMonth.");
}
return CHINESE_MONTH_NAMES[dateObj.getMonth()];
}
// 调用示例
console.log(getChineseMonth()); // 示例输出:当前月份中文名
console.log(getChineseMonth("2026-05-20")); // 示例输出:"五月"
三、方法二:使用现代原生国际化 API(Intl.DateTimeFormat)
ECMAScript 国际化 API(Intl)为 JavaScript 提供了开箱即用的多语言本地化格式化能力。无需手动编写中文对照列表,即可利用宿主环境内建的本地化规则自动输出中文月份。
1. 完整代码示例
// 方式 A:使用 Intl.DateTimeFormat (推荐在批量处理或高频格式化时使用)
const formatter = new Intl.DateTimeFormat("zh-Hans-CN", { month: "long" });
const monthFromIntl = formatter.format(new Date());
console.log(monthFromIntl); // 示例输出:"十一月"
// 方式 B:使用 Date 实例的 toLocaleString 快捷方式
const monthFromLocale = new Date().toLocaleString("zh-Hans-CN", { month: "long" });
console.log(monthFromLocale); // 示例输出:"十一月"
2. 参数说明与输出选项
"zh-Hans-CN":代表简体中文、中国大陆区域的 BCP 47 语言标识符。month: "long":表示输出月份的全称,在简体中文环境下即为“一月”、“二月”等带有“月”后缀的汉字名称。- 若设置为
month: "short"或month: "narrow",不同运行时可能会输出数字加月(如“1月”)或纯数字,因此生成标准中文“一月、二月”必须显式指定为long。
四、两类方案的技术对比与选型考量
为了帮助开发者在实际工程中做出合理的架构决策,下表与图示梳理了两种方案在核心指标上的差异:
| 对比维度 | 数组查表法(Array Indexing) | 原生国际化法(Intl.DateTimeFormat) |
|---|---|---|
| 运行时性能 | 极高。数组下标寻址时间复杂度为 O(1),开销微乎其微。 | 中等。实例化需加载区域语言环境表,建议复用 formatter 实例。 |
| 定制灵活性 | 极高。可随意修改为纯汉字(“一、二”)、大写(“壹、贰”)或古风别称(“孟春、仲春”)。 | 固定。严格遵循 Unicode CLDR 标准规则,无法任意定制字符内容。 |
| 环境依赖与兼容性 | 极好。全量兼容所有浏览器(IE5.5+)及所有轻量级 JavaScript 运行环境。 | 良好。需现代浏览器或 Node.js 环境(极精简定制版 Node 可能缺少完整 ICU 数据)。 |
| 多语言扩展成本 | 高。每增加一种语言均需手工维护一组对应名称的数组。 | 极低。仅需改变语言标签(如 en-US、ja-JP)即可自动本地化。 |
五、常见问题排查与避坑指南
1. 误写 +1 导致的“月份后移”与“越界”
这是刚接触该转换时最普遍的错误。由于开发者在习惯上常写 date.getMonth() + 1 来获取自然月份,如果在数组查表时写成 months[date.getMonth() + 1],在 1 月时会错误输出“二月”,而在 12 月(getMonth() 返回 11,加 1 后为 12)则会命中 undefined 导致页面崩溃或显示异常。
2. 日期字符串格式解析的时区偏差
如果传入特定日期字符串(例如 "2026-05-01"),在不同浏览器解析 new Date("2026-05-01") 时,若被当做 UTC 时间零点解析,在东八区(UTC+8)转成本地时间后正常;但如果是月末临界点或特定跨时区环境,可能出现前推一天的现象。对于精确日期操作,推荐使用具体的年月日传参:new Date(2026, 4, 1)(注意第二个参数 4 代表 5 月)。
六、总结
将当前月份转换为中文“一月、二月”等格式,核心在于解决数值月份到中文字符的映射对应关系:
- 对于绝大多数中文网站、后台管理系统、移动端 H5 界面,推荐使用数组查表映射法。代码量极少、没有兼容性顾虑、性能最高,且支持任意定制显示格式。
- 对于跨国业务或需要多语言自动切换的企业级大型应用,推荐使用
Intl.DateTimeFormat("zh-Hans-CN", { month: "long" }),能有效减少多语言词典的维护负担。
只要明确 getMonth() 的 0 基索引特性,就能在开发中轻松、准确地实现中文月份的高效转换。
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。