Day.js 技术解析：轻量级日期处理库的全面指南

虞怀灏Larina

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

阅读量301

点赞数

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00548/article/details/148324849

Day.js 技术解析：轻量级日期处理库的全面指南

dayjs 项目地址: https://gitcode.com/gh_mirrors/day/dayjs

什么是 Day.js

Day.js 是一个轻量级的 JavaScript 日期处理库，它提供了与 Moment.js 相似的 API，但体积仅有 2kB，是现代前端开发中处理日期和时间的理想选择。作为 Moment.js 的轻量级替代方案，Day.js 保留了 Moment.js 的核心功能，同时解决了 Moment.js 体积过大、性能不佳的问题。

核心特性

极简体积：仅 2kB 大小，比 Moment.js 小很多
API 兼容性：与 Moment.js 高度兼容，学习成本低
不可变性：所有操作都返回新的实例，避免副作用
链式调用：支持流畅的链式操作语法
国际化支持：内置多语言支持，可按需加载
浏览器兼容：支持所有现代浏览器

安装与使用

安装方式

通过 npm 或 yarn 安装：

npm install dayjs --save
# 或
yarn add dayjs

基础用法

import dayjs from 'dayjs'

// 解析日期
const date = dayjs('2023-05-15')

// 格式化输出
console.log(date.format('YYYY-MM-DD')) // 输出: 2023-05-15

// 日期操作
const nextMonth = date.add(1, 'month').format('YYYY-MM-DD')
console.log(nextMonth) // 输出: 2023-06-15

核心 API 详解

日期解析

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

dayjs() // 当前时间
dayjs('2023-05-15') // ISO 8601 格式
dayjs(1684147200000) // 时间戳
dayjs(new Date(2023, 4, 15)) // JavaScript Date 对象

日期格式化

使用 .format() 方法可以灵活地格式化日期：

dayjs().format('YYYY年MM月DD日') // 2023年05月15日
dayjs().format('HH:mm:ss') // 14:30:45
dayjs().format('YYYY-MM-DD HH:mm:ss') // 2023-05-15 14:30:45

日期操作

Day.js 提供了丰富的日期操作方法：

// 加减操作
dayjs().add(7, 'day') // 加7天
dayjs().subtract(1, 'year') // 减1年

// 设置日期部分
dayjs().set('month', 5) // 设置为6月(0-11)
dayjs().set('date', 1) // 设置为当月1号

日期比较

const date1 = dayjs('2023-05-15')
const date2 = dayjs('2023-06-20')

date1.isBefore(date2) // true
date1.isAfter(date2) // false
date1.isSame(date2, 'month') // 比较是否为同月

国际化支持

Day.js 的国际化支持是其强大功能之一：

// 加载西班牙语语言包
import 'dayjs/locale/es'

// 全局设置语言
dayjs.locale('es')

// 或者在特定实例中使用
dayjs('2023-05-15').locale('es').format('MMMM') // mayo

插件系统

Day.js 通过插件机制扩展功能，以下是一些常用插件：

AdvancedFormat：扩展格式化选项
RelativeTime：相对时间显示(如"2天前")
WeekOfYear：获取一年中的周数
TimeZone：时区支持

import advancedFormat from 'dayjs/plugin/advancedFormat'
import relativeTime from 'dayjs/plugin/relativeTime'

dayjs.extend(advancedFormat)
dayjs.extend(relativeTime)

dayjs().format('Q Do k kk') // 使用扩展的格式化选项
dayjs('2023-05-10').fromNow() // "3天前"