Day.js 教程与指南

2026-01-16 09:29:16作者：董宙帆

1. 项目介绍

Day.js 是一个轻量级的 JavaScript 日期库，大小仅 2kb，但它提供了与 Moment.js 兼容的现代API，用于解析、验证、操作和显示日期及时间。Day.js 的设计目标是快速、简洁且易于使用，通过保持代码最小化，它允许你的应用程序更高效地运行。

主要特性

小巧快速: 低体积，提高页面加载速度。
不可变对象: 所有改变 Day.js 对象的操作都会返回新的实例，避免意外的副作用。
国际化支持: 提供丰富的本地化插件，按需引入，不增加额外负担。

2. 项目快速启动

首先，你需要安装 Day.js。如果你的项目使用 npm，可以运行以下命令：

npm install dayjs

或，如果你使用 yarn：

yarn add dayjs

然后在你的代码中导入并使用 Day.js：

import dayjs from 'dayjs';

const now = dayjs();
console.log(now.format('YYYY-MM-DD HH:mm:ss')); // 输出当前日期和时间，如 "2023-03-0.jpg 15:30:00"

你可以根据需要调整 format 方法中的字符串参数来改变日期和时间的显示格式。

3. 应用案例和最佳实践

格式化日期

const dateStr = '2022-12-25';
const parsedDate = dayjs(dateStr).format('MM/DD/YYYY');
console.log(parsedDate); // 输出 "12/25/2022"

比较日期

const date1 = dayjs('2022-12-25');
const date2 = dayjs('2023-01-01');

if (date1.isBefore(date2)) {
  console.log('Date 1 comes before Date 2.');
} else if (date1.isAfter(date2)) {
  console.log('Date 1 comes after Date 2.');
} else {
  console.log('Both dates are equal.');
}

时间间隔

const then = dayjs().subtract(1, 'year');
const duration = dayjs.duration(dayjs().diff(then), 'seconds');
console.log(`Time difference in seconds: ${duration.asSeconds()}`);