Day.js 2kb日期时间处理javascript库

Day.js

Day.js 是一个仅 2kb 大小的轻量级 JavaScript 时间日期处理库，和 Moment.js 的 API 设计保持完全一样。如果你曾经用过 Moment.js ，那么你已经知道如何使用 Day.js 。

优点

• 体积小：Day.js 的体积仅为 2KB 左右，而 Moment.js 的体积约为 67KB。
• API 相似：Day.js 的 API 与 Moment.js 高度相似，迁移成本低。
• 不可变性：Day.js 的日期对象是不可变的，这意味着每次操作都会返回一个新的日期对象，避免了意外的副作用。

缺点

• 功能较少：Day.js 的功能相对 Moment.js 较少，特别是在处理时区和复杂日期操作时。
• 插件依赖：一些高级功能（如时区支持）需要通过插件实现，增加了额外的依赖。

定位与设计理念

• 老牌时间处理库，2012 年发布，曾是 JavaScript 时间处理的事实标准，功能全面且语法直观。
• 设计目标：覆盖几乎所有时间处理需求，包括复杂的时区、本地化、格式化、操作等。
• 现状：2020 年进入 维护模式（不再新增功能，仅修复严重 bug），官方推荐迁移至更现代的库（如 Day.js、Luxon 等）。

Day.js

• 轻量替代方案，2018 年发布，设计灵感直接来源于 Moment.js，语法高度相似，但更简洁轻量。
• 设计目标：通过最小化核心功能 + 插件机制，提供常用时间操作能力，避免过度设计。
• 现状：持续活跃更新，由单一开发者维护，社区支持度快速增长。

核心差异对比

Dayjs中文文档

https://dayjs.uihtm.com

如何将 Moment.js 替换为 Day.js

1. 安装 Day.js

首先，安装 Day.js：

npm install dayjs

2. 替换导入语句

将项目中的 Moment.js 导入语句替换为 Day.js：

// 将
import moment from 'moment';

// 替换为
import dayjs from 'dayjs';

3. 替换 API 调用

将 Moment.js 的 API 调用替换为 Day.js 的等效调用。由于两者的 API 非常相似，大多数情况下只需简单替换即可：

// Moment.js
const date = moment('2023-10-01');
console.log(date.format('YYYY-MM-DD'));

// Day.js
const date = dayjs('2023-10-01');
console.log(date.format('YYYY-MM-DD'));

4. 处理差异

在某些情况下，Day.js 和 Moment.js 的行为可能略有不同。你需要根据具体情况调整代码。例如，Day.js 的 diff 方法返回的是毫秒数，而 Moment.js 返回的是天数：

// Moment.js
const diff = moment('2023-10-02').diff('2023-10-01', 'days'); // 1

// Day.js
const diff = dayjs('2023-10-02').diff('2023-10-01', 'day'); // 1

5. 引入插件（可选）

如果你需要使用 Day.js 的高级功能（如时区支持），可以引入相应的插件：

5. 总结：如何选择？

• 选 Moment.js：如果项目依赖其成熟生态、需要兼容旧浏览器，或时间逻辑极其复杂且不愿配置插件。
• 选 Day.js：如果追求轻量、高性能、简洁 API，且能接受通过插件扩展功能（推荐新项目使用）。

import utc from 'dayjs/plugin/utc';
import timezone from 'dayjs/plugin/timezone';

dayjs.extend(utc);
dayjs.extend(timezone);

const date = dayjs().tz('America/New_York');
console.log(date.format('YYYY-MM-DD HH:mm:ss'));

总结：

两者语法高度相似，迁移成本低。若项目对体积和性能敏感，Day.js 是更优解；若功能全面性和旧项目兼容更重要，Moment.js 仍可短期使用，但长期建议迁移至活跃库（如 Day.js 或 Luxon）。