Day.js和Moment.js的常用方法

项目中经常会使用 Day.js 和 Moment.js 来操作日期时间，但老是忘记常用方法，去官网查 API，有时候官网打不开或者卡的要死，所以写了个简单的笔记。

安装和引入

# Day.js
npm install dayjs

// Day.js
let dayjs = require("dayjs");

# Moment.js
npm install moment

// Moment.js
let moment = require("moment");

解析

所谓解析，就是一众不是 Day.js/Moment.js 对象的数据，通过 Day.js/Moment.js 解析成 Day.js/Moment.js 对象。

// Day.js
dayjs(); // 当前时间
dayjs("2018-04-04T16:00:00.000Z"); // ISO 8601格式字符串
dayjs("2018-04-04"); // ISO 8601格式字符串
dayjs.extend(customParseFormat);
dayjs("1995-12-25 12:29:03.329", "YYYY-MM-DD HH:mm:ss.SSS"); // 自定义格式字符串：年-月-日 时:分:秒.毫秒
dayjs(new Date()); // Date对象

// Moment.js
moment(); // 当前时间
moment("2018-04-04T16:00:00.000Z"); // ISO 8601格式字符串
moment("2018-04-04");
moment("1995-12-25 12:29:03.329", "YYYY-MM-DD HH:mm:ss.SSS"); // 自定义格式字符串：年-月-日 时:分:秒.毫秒
moment(new Date()); // Date对象

展示

所谓展示，就是 Day.js/Moment.js 对象，通过 Day.js/Moment.js 转换成格式化的日期时间字符串。

// Day.js
dayjs().format("YYYY-MM-DD HH:mm:ss.SSS d"); // 输出：2024-07-19 15:16:26.000 3（最后这个3代表周几，周日为0，周六为6）

// Moment.js
moment().format("YYYY-MM-DD HH:mm:ss.SSS d"); // 输出：2024-07-19 15:16:26.000 3（最后这个3代表周几，周日为0，周六为6）

获取月天数

获取一个月有多少天

// Day.js
dayjs("2019-01-25").daysInMonth(); // 31

// Moment.js
moment("2019-01-25").daysInMonth(); // 31

格式化秒数

常见业务，需要把秒数/分钟数转换为“xx 小时 xx 分钟 xx 秒”的形式。

// Day.js
const seconds = 123456789;
const utc = require("dayjs/plugin/utc");
dayjs.extend(utc);
dayjs.utc(seconds * 1000).format("H 小时 m 分钟 s 秒"); // “21 小时 33 分钟 9 秒”。中国时区需要使用utc来防止多出8个小时。

// Moment.js
const seconds = 123456789;
moment.utc(seconds * 1000).format("H 小时 m 分钟 s 秒"); // “21 小时 33 分钟 9 秒”。中国时区需要使用utc来防止多出8个小时。

获取原生 Date 对象

// Day.js
dayjs("2019-01-25").toDate();

// Moment.js
moment("2019-01-25").toDate();

计算

所谓计算，就是 Day.js/Moment.js 对象，通过 Day.js/Moment.js 计算得到新的 Day.js/Moment.js 对象。

// Day.js
dayjs().add(1, "day"); // 加1天
dayjs().add(1, "week"); // 加1周
dayjs().add(1, "month"); // 加1月（注意月份的范围是0-11）
dayjs().add(1, "year"); // 加1年
dayjs().add(1, "hour"); // 加1小时
dayjs().add(1, "minute"); // 加1分钟
dayjs().add(1, "second"); // 加1秒
dayjs().add(1, "millisecond"); // 加1毫秒

dayjs().subtract(1, "day"); // 减1天
dayjs().subtract(1, "week"); // 减1周
dayjs().subtract(1, "month"); // 减1月（注意月份的范围是0-11）
dayjs().subtract(1, "year"); // 减1年
dayjs().subtract(1, "hour"); // 减1小时
dayjs().subtract(1, "minute"); // 减1分钟
dayjs().subtract(1, "second"); // 减1秒
dayjs().subtract(1, "millisecond"); // 减1毫秒

// Moment.js
moment().add(1, "days"); // 加1天
moment().add(1, "weeks"); // 加1周
moment().add(1, "months"); // 加1月（注意月份的范围是0-11）
moment().add(1, "years"); // 加1年
moment().add(1, "hours"); // 加1小时
moment().add(1, "minutes"); // 加1分钟
moment().add(1, "seconds"); // 加1秒
moment().add(1, "milliseconds"); // 加1毫秒

moment().subtract(1, "days"); // 减1天
moment().subtract(1, "weeks"); // 减1周
moment().subtract(1, "months"); // 减1月（注意月份的范围是0-11）
moment().subtract(1, "years"); // 减1年
moment().subtract(1, "hours"); // 减1小时
moment().subtract(1, "minutes"); // 减1分钟
moment().subtract(1, "seconds"); // 减1秒
moment().subtract(1, "milliseconds"); // 减1毫秒

差异（Diff）

计算两个日期之间相差多少个年/月/日/周等单位

// Day.js
// 参考：https://dayjs.fenxianglu.cn/category/display.html#%E5%B7%AE%E5%BC%82-diff
const date1 = dayjs("2019-01-25");
const date2 = dayjs("2018-06-05");
/*
第一个参数可以是Day.js/String/Date/Number/Array类型
第二个参数是单位，默认是毫秒
第三个参数表示是否【保留】小数
*/
date1.diff(date2, 'month'，false);

// Moment.js
// 参考：https://momentjs.com/docs/#/displaying/difference/
const date1 = moment("2019-01-25");
const date2 = moment("2018-06-05");
/*
第一个参数可以是Moment.js/String/Date/Number/Array类型
第二个参数是单位，默认是毫秒
第三个参数表示是否【舍去】小数
*/
date1.diff(date2, 'months', true);

时间的开始和结束

获取一个日期的年/月/周等单位的开始和结束日期

// Day.js
dayjs().startOf("month"); // 当月第一天
dayjs().endOf("month"); // 当月最后一天

// Moment.js
moment().startOf("months"); // 当月第一天
moment().endOf("month"); // 当月最后一天

取值/赋值

所谓取值/赋值，就是 Day.js/Moment.js 对象，通过 Day.js/Moment.js 设置/获取属性。

// Day.js
dayjs().year(); // 获取年(参数为空时取值，参数不为空时赋值)
dayjs().month(); // 获取月(参数为空时取值，参数不为空时赋值)，传入0到11的 number。 如果超出这个范围，它会进位到年份。
dayjs().date(); // 获取日(参数为空时取值，参数不为空时赋值)，接受1到31的数字。 如果超出这个范围，它会进位到月份。
dayjs().day(); // 获取周(参数为空时取值，参数不为空时赋值)，传入0到6的 number。 如果超出这个范围，它会进位到其他周。
dayjs().hour(); // 获取时(参数为空时取值，参数不为空时赋值)，传入0到23的数字。 如果超出这个范围，它会进位到天数。
dayjs().minute(); // 获取分(参数为空时取值，参数不为空时赋值)，传入0到59的数字。 如果超出这个范围，它会进位到小时。
dayjs().second(); // 获取秒(参数为空时取值，参数不为空时赋值)，传入0到59的数字。 如果超出这个范围，它会进位到分钟。
dayjs().millisecond(); // 获取毫秒(参数为空时取值，参数不为空时赋值)，传入0到999的数字。 如果超出这个范围，它会进位到秒。

// Moment.js
moment().year(); // 获取年(参数为空时取值，参数不为空时赋值)
moment().month(); // 获取月(参数为空时取值，参数不为空时赋值)，传入0到11的 number。 如果超出这个范围，它会进位到年份。
moment().date(); // 获取日(参数为空时取值，参数不为空时赋值)，接受1到31的数字。 如果超出这个范围，它会进位到月份。
moment().day(); // 获取周(参数为空时取值，参数不为空时赋值)，传入0到6的 number。 如果超出这个范围，它会进位到其他周。
moment().hour(); // 获取时(参数为空时取值，参数不为空时赋值)，传入0到23的数字。 如果超出这个范围，它会进位到天数。
moment().minute(); // 获取分(参数为空时取值，参数不为空时赋值)，传入0到59的数字。 如果超出这个范围，它会进位到小时。
moment().second(); // 获取秒(参数为空时取值，参数不为空时赋值)，传入0到59的数字。 如果超出这个范围，它会进位到分钟。
moment().millisecond(); // 获取毫秒(参数为空时取值，参数不为空时赋值)，传入0到999的数字。 如果超出这个范围，它会进位到秒。

克隆

所有的 Day.js/Moment.js 对象都是不可变的。 但如果有必要，使用 dayjs#clone 可以复制出一个当前对象。

// Day.js
dayjs().clone();

// Moment.js
moment().clone();

参考

Day.js
Moment.js