Day.js

当需要在浏览器或 Node.js 中解析、验证、操作和显示日期，又不想引入 Moment.js 那 67KB 的体积时，Day.js 以 2KB（gzipped）的体积提供兼容 Moment.js 的 API，并支持插件按需加载与 100+ 语言环境。

核心特性

Day.js 体积仅 2KB，所有 API 操作都返回新的 Dayjs 实例（不可变设计），避免因直接修改原对象引发的 bug。它采用插件化架构，国际化、时区、高级格式化等功能均以插件形式按需引入，不占用基础包体积。

• 2KB 体积: 比 Moment.js 小 97%，下载、解析和执行开销更低
• API 兼容: 与 Moment.js 高度一致的 API，迁移时只需替换引用
• 不可变对象: 每次操作返回新实例，如 dayjs().add(7, 'day') 不改变原对象
• 插件化: 支持 AdvancedFormat、RelativeTime、UTC、Timezone 等 30+ 官方插件
• 国际化: 默认仅打包英文，通过 dayjs/locale/zh-cn 等路径按需加载语言包
• 零依赖: 无外部运行时依赖，降低安全风险

安装与运行环境

Day.js 被设计为在浏览器和 Node.js 中均可运行，同一份代码在两个环境下通过单元测试。浏览器支持 IE9+、Chrome、Firefox、Safari、Edge；Node.js 要求 8.0+。安装方式包括 npm、yarn、pnpm 以及 CDN 引入。

• npm 安装: npm install dayjs
• 浏览器 CI: 覆盖 Windows XP Chrome、IE 8/9/10/11、Linux Firefox、OSX Safari
• TypeScript: 提供完整的 .d.ts 类型定义
• 框架兼容: 与 React、Vue、Angular 等主流框架配合使用

常用功能速览

Day.js 覆盖日期处理的常见场景：解析多种格式（ISO 8601、Unix 时间戳、数组、对象等），格式化输出（YYYY-MM-DD HH:mm:ss 等），日期加减（add/subtract），时间差计算（diff），以及查询（isBefore、isAfter、isLeapYear 等）。

• 解析: dayjs('2025-05-12')、dayjs(1686873600000)、dayjs(new Date()) 等均返回 Dayjs 对象
• 格式化: .format('YYYY年MM月DD日') 输出中文日期，.format('dd') 输出数字星期
• 操作: .add(7, 'day')、.subtract(1, 'month')、.startOf('month') 返回新实例
• 显示: .fromNow()（需 RelativeTime 插件）输出“3 天前”类相对时间
• 时区: 通过 UTC 插件和 Timezone 插件解析和转换时区

与 Moment.js 的差异

Day.js 是 Moment.js 的轻量替代，API 设计高度兼容，但体积仅为后者的 3%。Moment.js 已进入维护状态（官方建议新项目使用其他库），Day.js 则保持活跃维护（最新 v1.11.18，GitHub Stars 48.2k+）。Day.js 的不可变设计和插件化架构使其更适合现代前端构建。

• 体积: Day.js 2KB vs Moment.js 67KB（gzipped）
• 维护: Moment.js 已停止功能开发，Day.js 持续更新
• 设计: Day.js 默认不可变，Moment.js 默认可变
• 加载: Day.js 插件按需引入，Moment.js 全量打包

常见问题

Q1：Day.js 如何加载中文语言包？

A1：在代码中引入 'dayjs/locale/zh-cn'，然后调用 dayjs.locale('zh-cn') 即可全局切换为中文。局部切换可通过 .locale('zh-cn') 方法在单个实例上生效。

Q2：Day.js 的插件必须全部加载吗？

A2：不需要。插件按需加载，例如使用相对时间功能时，只需引入 'dayjs/plugin/relativeTime' 并调用 dayjs.extend(relativeTime)。未使用的插件不会打包进最终构建。

Q3：Day.js 在 IE8 上能用吗？

A3：官方 CI 覆盖了 IE8/9/10/11，但 IE8 需注意部分插件可能依赖较新的 ES 特性。基础解析和格式化功能在 IE8 上经过测试可用。

更多同类工具与网站,可在前端库分类继续挑选。

信息核实于 2026年7月,具体以官网为准。