项目
在 GitHub 查看
iamkun/dayjs
iamkun/dayjs has 48,655 GitHub stars and 3,503 forks. GitHot measured +3 stars in 24 hours and -2 in 7 days. Last checked 2026-11-09 01:14 UTC. Last push 2026-09-15.
⏰ Day.js 是一款 2kB 的不可变日期时间库，可作为 Moment.js 的替代品，并提供相同的现代 API。
实测星标增长
- 24小时
- +3
- 7天
- -2
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化，周期相互重叠，并非每日新增。缺失的测量保持空白。星标代表关注度，不代表软件质量。
docs/zh-cn/README.zh-CN.md
原文简体中文 | English | 日本語 | Português Brasileiro | 한국어 | Español (España) | Русский
Moment.js 的 2kB 轻量化方案，拥有同样强大的 API
Day.js 是一个轻量的处理时间和日期的 JavaScript 库，和 Moment.js 的 API 设计保持完全一样. 如果您曾经用过 Moment.js, 那么您已经知道如何使用 Day.js
dayjs()
.startOf('month')
.add(1, 'day')
.set('year', 2018)
.format('YYYY-MM-DD HH:mm:ss')
- 🕒 和 Moment.js 相同的 API 和用法
- 💪 不可变数据 (Immutable)
- 🔥 支持链式操作 (Chainable)
- 🌐 国际化 I18n
- 📦 仅 2kb 大小的微型库
- 👫 全浏览器兼容
快速开始
文档
访问 day.js.org 网站查看更详细的文档
安装
npm install dayjs --save
📚安装指南
API
Day.js 有很多 API 来解析、处理、校验、增减、展示时间和日期
dayjs('2018-08-08') // 解析
dayjs().format('{YYYY} MM-DDTHH:mm:ss SSS [Z] A') // 展示
dayjs()
.set('month', 3)
.month() // 获取
dayjs().add(1, 'year') // 处理
dayjs().isBefore(dayjs()) // 查询
国际化 I18n
Day.js 支持国际化
但除非手动加载，多国语言默认是不会被打包到工程里的
import 'dayjs/locale/es' // 按需加载
dayjs.locale('es') // 全局使用西班牙语
dayjs('2018-05-05')
.locale('zh-cn')
.format() // 在这个实例上使用简体中文
插件
插件是一些独立的程序，可以给 Day.js 增加新功能和扩展已有功能
import advancedFormat from 'dayjs/plugin/advancedFormat' // 按需加载插件
dayjs.extend(advancedFormat) // 使用插件
dayjs().format('Q Do k kk X x') // 使用扩展后的API
📚插件列表
开源协议
Day.js 遵循 MIT 开源协议.