Day.js极简轻易快速2kB的JavaScript库-替代Moment.js

18 阅读6分钟

Dayjs介绍

dayjs是一个极简快速2kB的JavaScript库,可以为浏览器处理解析、验证、操作和显示日期和时间,它的设计目标是提供一个简单、快速且功能强大的日期处理工具,同时保持极小的体积(仅 2KB 左右)。 Day.js 的 API 与 Moment.js 高度相似,因此对于熟悉 Moment.js 的开发者来说,迁移到 Day.js 非常容易。 在这里插入图片描述

Dayjs文档

最早找到的一个算是中文的dayjs中文官网

dayjs.uihtm.com

使用场景

Day.js 适用于各种需要处理日期和时间的场景,例如:

  • 在 Web 应用中显示和格式化日期
  • 处理用户输入的日期
  • 计算倒计时或时间间隔
  • 在日历应用中管理事件日期
  • 在数据可视化中处理时间序列数据

安装 Day.js 可以通过 npm 或 yarn 安装 Day.js:

安装 Day.js
可以通过 npm 或 yarn 安装 Day.js:

或者

yarn add dayjs

你也可以通过 CDN 直接在 HTML 文件中引入 Day.js:

<script src="https://unpkg.com/dayjs"></script>

如何使用 Day.js

基本用法

首先,引入 Day.js:

import dayjs from 'dayjs';

然后,你可以使用 Day.js 来解析和格式化日期:

const now = dayjs();
console.log(now.format('YYYY-MM-DD')); // 输出当前日期,例如:2023-10-01

解析日期

Day.js 可以解析多种格式的日期:

const date = dayjs('2023-10-01');
console.log(date.format('MMMM D, YYYY')); // 输出:October 1, 2023

操作日期

你可以轻松地添加或减去时间:

const tomorrow = dayjs().add(1, 'day');
console.log(tomorrow.format('YYYY-MM-DD')); // 输出明天的日期

const lastWeek = dayjs().subtract(1, 'week');
console.log(lastWeek.format('YYYY-MM-DD')); // 输出一周前的日期

比较日期

Day.js 提供了多种方法来比较日期:

const date1 = dayjs('2023-10-01');
const date2 = dayjs('2023-10-02');

console.log(date1.isBefore(date2)); // true
console.log(date1.isAfter(date2)); // false
console.log(date1.isSame(date2, 'day')); // false

本地化支持

Day.js 支持多种语言的本地化:

import 'dayjs/locale/zh-cn'; // 引入中文本地化

dayjs.locale('zh-cn'); // 设置为中文
console.log(dayjs().format('MMMM D, YYYY')); // 输出:十月 1, 2023

在 Vue.js 中使用 Day.js

在 Vue.js 项目中,Day.js 可以很方便地用于处理日期和时间的格式化、计算和显示。以下是一些常见的用法示例。

1. 在 Vue 组件中直接使用 Day.js

首先,在 Vue 组件中引入 Day.js:

<template>
  <div>
    <p>当前日期:{{ formattedDate }}</p>
    <p>一周后的日期:{{ nextWeekDate }}</p>
  </div>
</template>

<script>
import dayjs from 'dayjs';

export default {
  data() {
    return {
      currentDate: dayjs(), // 获取当前日期
    };
  },
  computed: {
    // 格式化当前日期
    formattedDate() {
      return this.currentDate.format('YYYY-MM-DD');
    },
    // 计算一周后的日期
    nextWeekDate() {
      return this.currentDate.add(1, 'week').format('YYYY-MM-DD');
    },
  },
};
</script>

2. 在 Vue 过滤器中使用 Day.js

Vue 2.x 支持过滤器(Filters),可以方便地格式化日期。虽然 Vue 3.x 移除了过滤器,但你仍然可以通过方法或计算属性实现类似功能。

Vue 2.x 中使用过滤器
import Vue from 'vue';
import dayjs from 'dayjs';

// 定义全局过滤器
Vue.filter('formatDate', function(value, format = 'YYYY-MM-DD') {
  return dayjs(value).format(format);
});

在模板中使用过滤器:

<template>
  <div>
    <p>当前日期:{{ currentDate | formatDate('YYYY年MM月DD日') }}</p>
  </div>
</template>

<script>
export default {
  data() {
    return {
      currentDate: dayjs(), // 获取当前日期
    };
  },
};
</script>

Vue 3.x 中使用方法

Vue 3.x 中可以通过方法实现日期格式化:

<template>
  <div>
    <p>当前日期:{{ formatDate(currentDate, 'YYYY年MM月DD日') }}</p>
  </div>
</template>

<script>
import dayjs from 'dayjs';

export default {
  data() {
    return {
      currentDate: dayjs(), // 获取当前日期
    };
  },
  methods: {
    formatDate(date, format = 'YYYY-MM-DD') {
      return dayjs(date).format(format);
    },
  },
};
</script>

3. 在 Vuex 中使用 Day.js

如果你的 Vue 项目使用了 Vuex 进行状态管理,可以在 Vuex 的 getters 或 actions 中使用 Day.js 处理日期。

示例:在 Vuex 中格式化日期
import Vue from 'vue';
import Vuex from 'vuex';
import dayjs from 'dayjs';

Vue.use(Vuex);

const store = new Vuex.Store({
  state: {
    currentDate: dayjs(), // 存储当前日期
  },
  getters: {
    formattedDate: (state) => (format = 'YYYY-MM-DD') => {
      return dayjs(state.currentDate).format(format);
    },
  },
  actions: {
    updateDate({ commit }) {
      const newDate = dayjs().add(1, 'day'); // 计算明天的日期
      commit('SET_DATE', newDate);
    },
  },
  mutations: {
    SET_DATE(state, date) {
      state.currentDate = date;
    },
  },
});

export default store;

在组件中使用 Vuex 的日期:

<template>
  <div>
    <p>当前日期:{{ formattedDate('YYYY年MM月DD日') }}</p>
    <button @click="updateDate">更新日期</button>
  </div>
</template>

<script>
import { mapGetters, mapActions } from 'vuex';

export default {
  computed: {
    ...mapGetters(['formattedDate']),
  },
  methods: {
    ...mapActions(['updateDate']),
  },
};
</script>

4. 在 Vue 中使用 Day.js 插件

Day.js 支持通过插件扩展功能。例如,使用 relativeTime 插件可以显示相对时间(如“2 天前”)。

安装和使用 relativeTime 插件
npm install dayjs
npm install dayjs/plugin/relativeTime

在 Vue 项目中使用插件:

<template>
  <div>
    <p>发布时间:{{ relativeTime(publishedDate) }}</p>
  </div>
</template>

<script>
import dayjs from 'dayjs';
import relativeTime from 'dayjs/plugin/relativeTime';
import 'dayjs/locale/zh-cn'; // 引入中文本地化

dayjs.extend(relativeTime);
dayjs.locale('zh-cn'); // 设置为中文

export default {
  data() {
    return {
      publishedDate: dayjs().subtract(2, 'day'), // 假设发布时间是 2 天前
    };
  },
  methods: {
    relativeTime(date) {
      return dayjs(date).fromNow(); // 输出:2 天前
    },
  },
};
</script>

在 React 中使用 Day.js

在 React 组件中,你可以使用 Day.js 来处理和显示日期:

import React from 'react';
import dayjs from 'dayjs';

const DateComponent = ({ date }) => {
  const formattedDate = dayjs(date).format('MMMM D, YYYY');
  return <div>{formattedDate}</div>;
};

export default DateComponent;

在 Node.js 中使用 Day.js

在 Node.js 中,你可以使用 Day.js 来处理服务器端的日期和时间:

const dayjs = require('dayjs');

const now = dayjs();
console.log(now.format('YYYY-MM-DD')); // 输出当前日期

Day.js极简轻易快速2kB的JavaScript库-替代Moment.js

优点

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

缺点

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

如何将 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 的高级功能(如时区支持),可以引入相应的插件:

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 是一个轻量级且功能强大的日期处理库,适用于大多数常见的日期和时间操作。它的 API 与 Moment.js 高度相似,使得从 Moment.js 迁移到 Day.js 非常容易。尽管 Day.js 的功能相对较少,但其体积小、性能高,非常适合现代 Web开发!