Day.js 轻量级日期处理库全面解析-优快云博客

Day.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 日期处理库，它提供了与 Moment.js 高度兼容的 API，但体积仅有 2KB 左右。这个库专注于现代浏览器中的日期时间处理，包括解析、验证、操作和格式化等功能。

核心特性

轻量高效：仅 2KB 大小，比 Moment.js 小很多
Moment.js 兼容：API 设计与 Moment.js 高度一致，学习成本低
不可变对象：所有操作都返回新的实例，避免副作用
链式调用：支持流畅的链式方法调用
国际化支持：内置多语言支持
插件系统：可通过插件扩展功能

快速入门

安装方式

使用 npm 或 yarn 安装：

npm install dayjs
# 或
yarn add dayjs

基础用法

import dayjs from 'dayjs'

// 创建当前时间实例
const now = dayjs()

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

// 日期操作
const tomorrow = dayjs().add(1, 'day')
const lastMonth = dayjs().subtract(1, 'month')

// 日期比较
const isBefore = dayjs('2020-01-01').isBefore('2020-01-02')

核心功能详解

日期解析

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

dayjs() // 当前时间
dayjs('2023-05-20') // ISO 8601 格式
dayjs(1684569600000) // Unix 时间戳(毫秒)
dayjs(new Date(2023, 4, 20)) // JavaScript Date 对象

日期格式化

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

dayjs().format('YYYY年MM月DD日') // 2023年05月20日
dayjs().format('hh:mm:ss A') // 03:45:30 PM
dayjs().format('YYYY-MM-DD[T]HH:mm:ssZ[Z]') // 2023-05-20T15:45:30+08:00Z

日期操作

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

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

// 设置特定单位
dayjs().set('month', 5) // 设置为6月(0-11)
dayjs().set('date', 15) // 设置为当月15日

// 获取时间段的开始/结束
dayjs().startOf('week') // 本周开始(周日)
dayjs().endOf('month') // 本月最后一天23:59:59

日期查询

// 比较日期
dayjs().isBefore(anotherDate)
dayjs().isAfter(anotherDate)
dayjs().isSame(anotherDate)

// 获取日期差异
dayjs('2023-12-31').diff(dayjs(), 'day') // 距离年底还有多少天

// 验证日期有效性
dayjs('2023-02-30').isValid() // false (2月没有30日)

国际化支持

Day.js 支持多语言环境，可按需加载：

// 加载韩语语言包
import 'dayjs/locale/ko'

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

// 特定实例使用不同语言
dayjs()
  .locale('zh-cn')
  .format('YYYY年 MMMM') // 2023年 五月

插件系统

Day.js 通过插件扩展功能，常见插件包括：

AdvancedFormat：扩展格式化选项
RelativeTime：相对时间显示(如"2天前")
Calendar：日历式时间显示
Timezone：时区支持

插件使用示例：

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

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

// 使用扩展功能
dayjs().format('Qo [季度]') // "2nd 季度"
dayjs('2023-05-01').fromNow() // "3周前"