Day.js 日期处理库全面解析：轻量高效的 Moment.js 替代方案

吴年前Myrtle

于 2025-05-30 09:07:16 发布

阅读量368

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00201/article/details/148324886

Day.js 日期处理库全面解析：轻量高效的 Moment.js 替代方案

dayjs ⏰ Day.js 2kB immutable date-time library alternative to Moment.js with the same modern API 项目地址: https://gitcode.com/gh_mirrors/da/dayjs

一、Day.js 核心优势

Day.js 是一个轻量级的 JavaScript 日期处理库，具有以下显著特点：

极简体积：仅 2KB 大小，比 Moment.js 小很多
完全兼容 Moment.js API：学习成本极低，已有 Moment.js 经验的开发者可无缝切换
不可变设计：所有操作都返回新的实例，避免意外修改原始数据
链式调用：支持流畅的链式操作语法
国际化支持：内置多语言环境支持
浏览器兼容性：支持所有现代浏览器

二、快速入门指南

安装方式

通过 npm 安装：

npm install dayjs --save

或者直接在 HTML 中引入：

<script src="path/to/dayjs.min.js"></script>

基础使用示例

// 创建实例
const now = dayjs()

// 格式化输出
console.log(now.format('YYYY-MM-DD HH:mm:ss'))

// 日期运算
const nextMonth = now.add(1, 'month')

// 日期比较
console.log(now.isBefore(nextMonth))

三、核心功能详解

1. 日期解析与格式化

Day.js 支持多种日期解析方式：

dayjs() // 当前时间
dayjs('2023-01-01') // ISO 8601 字符串
dayjs(1672531200000) // Unix 时间戳

格式化输出支持丰富的占位符：

dayjs().format('YYYY年MM月DD日 dddd') // 2023年01月01日 星期日

2. 日期操作

提供完整的日期操作方法：

// 加减运算
dayjs().add(7, 'day').subtract(1, 'month')

// 设置特定单位
dayjs().set('year', 2025).set('month', 5)

// 获取开始/结束时间
dayjs().startOf('week').endOf('month')

3. 日期查询与比较

// 比较操作
dayjs('2023-01-01').isAfter(dayjs())
dayjs().isSame(dayjs(), 'year')

// 查询方法
dayjs().daysInMonth() // 当月天数
dayjs().isLeapYear()  // 是否闰年

四、高级功能

国际化支持

Day.js 的国际化设计非常灵活：

// 加载语言包
import 'dayjs/locale/zh-cn'

// 全局设置
dayjs.locale('zh-cn')

// 实例级别设置
dayjs().locale('pt-br').format()

插件系统

Day.js 通过插件扩展功能：

// 安装插件
import advancedFormat from 'dayjs/plugin/advancedFormat'
dayjs.extend(advancedFormat)

// 使用插件功能
dayjs().format('Qo [季度]') // 1季度

常用插件包括：

相对时间显示（RelativeTime）
时区支持（Timezone）
日历显示（Calendar）
日期持续时间（Duration）

五、性能优化建议

按需加载语言包：避免打包所有语言文件
谨慎使用插件：只引入必要的插件
复用实例：避免频繁创建新实例
使用不可变特性：减少深拷贝开销

六、与 Moment.js 的对比

| 特性 | Day.js | Moment.js | |----------------|--------|-----------| | 体积 | ~2KB | ~20KB | | 不可变性 | 支持 | 不支持 | | API 兼容性 | 完全兼容 | - | | 性能 | 更优 | 一般 | | 插件系统 | 支持 | 有限支持 |