npm 包 @beisen/date-time 使用教程-JavaScript中文网-JavaScript教程资源分享门户

简介

@beisen/date-time 是一款适用于前端开发的 JavaScript 工具包，用于日期和时间格式的处理。它提供了诸如日期格式化、日期加减、日期比较等常用功能，并且具有较高的性能和易用性。

安装

你可以使用 npm 命令来安装 @beisen/date-time：

npm install @beisen/date-time

使用

基本使用

安装完成之后，就可以在代码中使用 @beisen/date-time 了。例如，下面的代码演示了如何将当前时间格式化为 yyyy-MM-dd HH:mm:ss 的形式：

import { format } from '@beisen/date-time';

const date = new Date();
const formatted = format(date, 'yyyy-MM-dd HH:mm:ss');

console.log(formatted);
// 输出：2022-01-01 12:00:00

方法列表

@beisen/date-time 提供了以下方法：

format(date, pattern)：将 Date 对象格式化为指定的日期和时间格式的字符串，例如 format(new Date(), 'yyyy-MM-dd HH:mm:ss')。
parse(string, pattern)：将指定的字符串解析为 Date 对象，例如 parse('2022-01-01 12:00:00', 'yyyy-MM-dd HH:mm:ss')。
add(date, amount, unit)：在指定的日期上添加指定的时间量，并返回新的 Date 对象，例如 add(new Date(), 1, 'day') 表示在当前时间上加 1 天。
subtract(date, amount, unit)：在指定的日期上减去指定的时间量，并返回新的 Date 对象，例如 subtract(new Date(), 1, 'day') 表示在当前时间上减 1 天。
compare(date1, date2)：比较两个日期对象的大小，如果 date1 大于 date2，则返回 1，如果 date1 等于 date2，则返回 0，如果 date1 小于 date2，则返回 -1。

日期格式

@beisen/date-time 支持多种日期和时间格式的字符串，下面是常见的日期和时间格式：

yyyy：表示 4 位数的年份，例如 2022。
yy：表示 2 位数的年份，例如 22。
MM：表示月份，例如 01 表示 1 月。
M：表示月份，例如 1 表示 1 月。
dd：表示日期，例如 01 表示 1 日。
d：表示日期，例如 1 表示 1 日。
HH：表示 24 小时制的小时数，例如 13 表示下午 1 点。
H：表示 24 小时制的小时数，例如 1 表示上午 1 点。
hh：表示 12 小时制的小时数，例如 01 表示上午 1 点。
h：表示 12 小时制的小时数，例如 1 表示上午 1 点。
mm：表示分钟数，例如 01 表示 1 分钟。
m：表示分钟数，例如 1 表示 1 分钟。
ss：表示秒数，例如 01 表示 1 秒。
s：表示秒数，例如 1 表示 1 秒。
SSS：表示毫秒数，例如 001 表示 1 毫秒。
a：表示上午或下午，例如 AM 或 PM。

示例代码

格式化日期

import { format } from '@beisen/date-time';

const date = new Date();
const formatted = format(date, 'yyyy-MM-dd HH:mm:ss');

console.log(formatted);
// 输出：2022-01-01 12:00:00

解析日期

import { parse } from '@beisen/date-time';

const dateString = '2022-01-01 12:00:00';
const date = parse(dateString, 'yyyy-MM-dd HH:mm:ss');

console.log(date.getTime());
// 输出：1641033600000

添加或减少时间量

import { add, subtract } from '@beisen/date-time';

const date = new Date();
const tomorrow = add(date, 1, 'day');
const yesterday = subtract(date, 1, 'day');

console.log(tomorrow);
console.log(yesterday);

比较日期

import { compare } from '@beisen/date-time';

const date1 = new Date('2022-01-01 12:00:00');
const date2 = new Date('2022-01-02 12:00:00');

console.log(compare(date1, date2));
// 输出：-1

结论

使用 @beisen/date-time 可以轻松地处理各种日期和时间格式，这在实际开发中是非常实用的。希望本文提供的使用教程可以帮助你更好地使用这个工具包。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/beisen-date-time