详细讲解在JavaScript中使用Day.js格式化日期字符串的具体步骤、常见格式化占位符及非标准格式解析方法,并深度对比Moment.js在包体积、不可变性、架构设计上的核心优势与迁移避坑指南。
怎么用dayjs在JS中格式化日期字符串?对比moment.js优势
时间:2026-11-18
浏览:404
文章目录
dayjs(原始字符串).format('YYYY-MM-DD HH:mm:ss') 即可完成转换。相比曾经广泛使用的 Moment.js,Day.js 保持了几乎完全一致的 API 调用习惯,但将打包体积从 70KB+ 剧降至 2KB 左右,同时采用天然的不可变对象(Immutable)设计,根除了原地修改实例带来的状态副作用。
一、Day.js 格式化日期字符串的标准步骤
在实际业务中,我们通常需要将后端返回的 ISO 字符串(如 2026-11-17T04:26:10Z)或时间戳转换为前端页面展示的标准中文日期格式。以下是在项目中完整落地该操作的具体流程。
步骤 1:安装与模块导入
在现代前端工程(Vite、Webpack、Node.js 等环境)中,通过包管理器安装依赖:
# 使用 npm 安装
npm install dayjs
# 或使用 yarn
yarn add dayjs
# 或使用 pnpm
pnpm add dayjs
在代码文件中按需引入 Day.js:
// ES Module 规范(Vue 3 / React / Vite)
import dayjs from 'dayjs';
// CommonJS 规范(Node.js / 老旧打包环境)
// const dayjs = require('dayjs');
步骤 2:调用 format 方法完成基础格式化
将待处理的日期字符串传入 dayjs() 包装函数,随后链式调用 .format() 方法,并传入指定的模板标记(Tokens):
import dayjs from 'dayjs';
// 1. 标准 ISO 8601 格式字符串
const isoString = '2026-11-17T04:26:10.000Z';
const formattedDefault = dayjs(isoString).format('YYYY-MM-DD HH:mm:ss');
console.log('格式化结果:', formattedDefault);
// 2. 自定义日期展示格式(例如只展示年月日)
const dateOnly = dayjs(isoString).format('YYYY年MM月DD日');
console.log('中文年月日:', dateOnly);
// 3. 毫秒级与 12 小时制展示
const fullDetail = dayjs(isoString).format('YYYY/MM/DD hh:mm:ss.SSS A');
console.log('12小时制与毫秒:', fullDetail);
中文年月日: 2026年11月17日
12小时制与毫秒: 2026/11/17 12:26:10.000 PM
常用格式化占位符(Tokens)对照表
在编写 .format() 模板时,大小写代表完全不同的语义。下表汇总了开发中最常用的占位符:
| 占位符 | 输出示例 | 具体含义说明 |
|---|---|---|
YYYY |
2026 | 四位完整年份 |
YY |
26 | 两位年份简写 |
MM |
04, 11 | 两位月份(不足两位前面补零) |
M |
4, 11 | 一位或两位月份(不补零) |
DD |
08, 17 | 两位日期(月份中的第几天,补零) |
D |
8, 17 | 一位或两位日期(不补零) |
HH |
04, 14 | 24 小时制小时(00 到 23,补零) |
hh |
02, 11 | 12 小时制小时(01 到 12,补零) |
mm |
05, 30 | 两位分钟数(补零) |
ss |
09, 45 | 两位秒数(补零) |
SSS |
042, 800 | 三位毫秒数 |
A / a |
AM / pm | 大写或小写上下午标记 |
二、处理非标准日期格式:使用 customParseFormat 插件
Day.js 默认核心仅内置了解析标准 ISO-8601 与 RFC2822 字符串的能力。如果遇到非标准结构(例如 "17-11-2026 14:30" 或 "2026/11/17 04:30"),直接调用 dayjs(str) 可能会回退到原生 new Date(str),导致在不同浏览器或系统环境下产生不同的解析结果甚至报错 Invalid Date。
遇到这种情况,需要显式加载官方提供的 customParseFormat 插件:
import dayjs from 'dayjs';
import customParseFormat from 'dayjs/plugin/customParseFormat';
// 1. 显式注册插件
dayjs.extend(customParseFormat);
// 2. 传入原始非标准字符串,并在第二个参数中明确指定输入模板
const customStr = '17/11/2026 15:45';
const parsedDate = dayjs(customStr, 'DD/MM/YYYY HH:mm');
// 3. 校验并重新格式化为目标标准字符串
if (parsedDate.isValid()) {
const output = parsedDate.format('YYYY-MM-DD HH:mm:ss');
console.log('非标准解析成功:', output);
} else {
console.error('日期解析失败,格式不匹配');
}
.isValid() 进行前置校验,防止因非法字符导致输出异常文本。
三、对比 Moment.js:Day.js 具备哪些核心优势?
许多维护老项目的团队都会面临是否将 Moment.js 替换为 Day.js 的技术决策。二者在 API 层面有着近乎 99% 的相似性,但在底层设计和运行时指标上存在决定性的差异。
1. 包体积缩减超过 97%(2KB vs 70KB+)
Moment.js 诞生于早期的前端开发时代,采用单体式架构,默认把所有功能与全球多语言资源捆绑在一起。即便通过构建配置排除未使用的语言包,其 Minified + Gzipped 体积依然高达 70KB 左右。
而 Day.js 采用微内核设计,核心仅约 2KB,几乎不对应用的首屏加载时间与带宽构成额外负担,在对加载速度敏感的移动端 H5、小程序与大型单页应用中优势尤为显著。
2. 原生不可变性(Immutable),根除数据隐式污染
这是开发实践中最关键的代码质量分水岭。Moment.js 的实例是可变的(Mutable),调用计算方法会直接改变原对象本身;而 Day.js 严格遵循不可变(Immutable)设计,任何修改操作都会返回一个全新的 Dayjs 实例。
通过下方对比代码可以直观看到二者的行为差异:
// ==================== Moment.js 的原地修改陷阱 ====================
// const moment = require('moment');
// const m1 = moment('2026-11-17');
// const m2 = m1.add(7, 'days'); // 原意是基于 m1 计算 7 天后的新日期
// console.log(m1.format('YYYY-MM-DD')); // 输出: '2026-11-24' (m1 本身被意外修改了!)
// console.log(m2.format('YYYY-MM-DD')); // 输出: '2026-11-24'
// ==================== Day.js 的不可变纯净设计 ====================
import dayjs from 'dayjs';
const d1 = dayjs('2026-11-17');
const d2 = d1.add(7, 'day'); // d1 保持只读不可变,返回全新 d2 实例
console.log(d1.format('YYYY-MM-DD')); // 输出: '2026-11-17' (d1 保持不变,安全可控)
console.log(d2.format('YYYY-MM-DD')); // 输出: '2026-11-24' (d2 获得预期结果)
Day.js: 每次操作生成新快照,天然适应 React、Vue 等现代状态驱动框架。
3. API 高度兼容,平替迁移成本极低
Day.js 在立项之初就刻意对齐了 Moment.js 的公共接口风格。常见的方法链(如 .format()、.add()、.subtract()、.startOf()、.diff())在名称、参数与返回值结构上均高度重合。在绝大多数业务场景下,开发者只需全局替换引用路径,即可完成平滑迁移。
4. 维护状态与生态演进
Moment.js 官方团队早已在官方文档中明确发布了维护声明(Project Status):Moment 进入维护期,不再增添新特性,不改变现有架构,并明确建议现代项目迁移至更轻量的现代库。Day.js 拥有活跃的社区维护、完善的 TypeScript 支持与持续的性能打磨,是目前技术栈更新迭代的理想选择。
四、总结与实战选型建议
在现代 JavaScript 项目中,日期处理的选型可以遵循以下清晰路径:
- 如果需求极其简单:仅需将当前时间转成本地字符串或展示简单年份,优先使用现代浏览器原生支持的
Intl.DateTimeFormat,享受零依赖开销。 - 如果需要常用格式化、相对时间与安全运算:Day.js 是首选方案。它在拥有 2KB 极小体积的同时,提供了直观的链式语法和稳定的不可变保障。
- 从老旧 Moment 项目重构时:首选 Day.js。迁移成本极低,能在几乎不改动业务逻辑的前提下,立竿见影缩减前端打包体积数十千字节。
在实际编码中,牢记两个核心习惯:一是遇到非 ISO 格式日期解析时显式引入 customParseFormat 插件;二是记住 Day.js 的不可变特性,对日期做增减计算后务必显式接收返回值(const next = now.add(1, 'day')),确保业务逻辑稳健可靠。
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。