怎么用dayjs在JS中格式化日期字符串?对比moment.js优势

作者:安全边界时间:2026-11-18 21:51:13浏览:403

详细讲解在JavaScript中使用Day.js格式化日期字符串的具体步骤、常见格式化占位符及非标准格式解析方法,并深度对比Moment.js在包体积、不可变性、架构设计上的核心优势与迁移避坑指南。

JavaScript Day.js Moment.js 对比 前端工程化
在 JavaScript 中,格式化日期字符串最直接的方法是引入轻量库 Day.js,调用 dayjs(原始字符串).format('YYYY-MM-DD HH:mm:ss') 即可完成转换。相比曾经广泛使用的 Moment.js,Day.js 保持了几乎完全一致的 API 调用习惯,但将打包体积从 70KB+ 剧降至 2KB 左右,同时采用天然的不可变对象(Immutable)设计,根除了原地修改实例带来的状态副作用。
怎么用dayjs在JS中格式化日期字符串?对比moment.js优势
图 1:Day.js 微内核架构概览 —— 核心解析仅 2KB,复杂能力通过插件按需挂载

一、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:26:10
中文年月日: 2026年11月17日
12小时制与毫秒: 2026/11/17 12:26:10.000 PM
怎么用dayjs在JS中格式化日期字符串?对比moment.js优势
图 2:日期字符串解析与格式化数据流管道

常用格式化占位符(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('日期解析失败,格式不匹配');
}
示例运行输出
非标准解析成功: 2026-11-17 15:45:00
避坑提醒:在解析来自第三方接口或外部用户输入的非标准日期时,务必在格式化前通过 .isValid() 进行前置校验,防止因非法字符导致输出异常文本。

三、对比 Moment.js:Day.js 具备哪些核心优势?

许多维护老项目的团队都会面临是否将 Moment.js 替换为 Day.js 的技术决策。二者在 API 层面有着近乎 99% 的相似性,但在底层设计和运行时指标上存在决定性的差异。

怎么用dayjs在JS中格式化日期字符串?对比moment.js优势
图 3:Day.js 与 Moment.js 关键维度架构与运行机制深度对比

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 获得预期结果)
执行逻辑差异验证
Moment: 原地修改对象属性,如果将实例作为参数传递给外部函数或组件,极易产生难以定位的跨模块脏数据 Bug。
Day.js: 每次操作生成新快照,天然适应 React、Vue 等现代状态驱动框架。

3. API 高度兼容,平替迁移成本极低

Day.js 在立项之初就刻意对齐了 Moment.js 的公共接口风格。常见的方法链(如 .format()、.add()、.subtract()、.startOf()、.diff())在名称、参数与返回值结构上均高度重合。在绝大多数业务场景下,开发者只需全局替换引用路径,即可完成平滑迁移。

4. 维护状态与生态演进

Moment.js 官方团队早已在官方文档中明确发布了维护声明(Project Status):Moment 进入维护期,不再增添新特性,不改变现有架构,并明确建议现代项目迁移至更轻量的现代库。Day.js 拥有活跃的社区维护、完善的 TypeScript 支持与持续的性能打磨,是目前技术栈更新迭代的理想选择。

四、总结与实战选型建议

怎么用dayjs在JS中格式化日期字符串?对比moment.js优势
图 4:现代日期处理技术选型决策与实战避坑要点全景图

在现代 JavaScript 项目中,日期处理的选型可以遵循以下清晰路径:

  • 如果需求极其简单:仅需将当前时间转成本地字符串或展示简单年份,优先使用现代浏览器原生支持的 Intl.DateTimeFormat,享受零依赖开销。
  • 如果需要常用格式化、相对时间与安全运算:Day.js 是首选方案。它在拥有 2KB 极小体积的同时,提供了直观的链式语法和稳定的不可变保障。
  • 从老旧 Moment 项目重构时:首选 Day.js。迁移成本极低,能在几乎不改动业务逻辑的前提下,立竿见影缩减前端打包体积数十千字节。

在实际编码中,牢记两个核心习惯:一是遇到非 ISO 格式日期解析时显式引入 customParseFormat 插件;二是记住 Day.js 的不可变特性,对日期做增减计算后务必显式接收返回值(const next = now.add(1, 'day')),确保业务逻辑稳健可靠。

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