Moment.js moment().calendar() 函数介绍

简介

Moment.js 是一个流行的 JavaScript 库，用于处理日期和时间。它可以帮助开发者解决通过处理日期和时间创建更可读和友好的用户体验的问题。其中，moment().calendar() 函数是 Moment.js 中的一个日期格式化工具，可以使日期时间转化为类似“昨天 15:00”、“上周五 12:00”、“下午3:15”等易于阅读的形式。

该函数返回的日期格式取决于当前日期与给定日期的时间差，可以显示未来、过去、今天、昨天等不同的日期格式。

语法

moment().calendar();
moment().calendar(referenceTime);

参数说明

• referenceTime：表示要格式化的日期时间，可以是一个 Moment.js 对象、Date 对象、时间戳（毫秒）或任何能被 JavaScript Date 转换的值。如果未提供该参数，则默认为当前日期时间。

返回值

• 当 referenceTime 将来时，返回值格式为“今天 HH:mm”、“明天 HH:mm”、“下星期几 HH:mm”等形式。
• 当 referenceTime 过去时，返回值格式为“今天 HH:mm”、“昨天 HH:mm”、“上星期几 HH:mm”等形式。
• 当 referenceTime 为当前日期时，返回值格式为“今天 HH:mm”。
• 当 referenceTime 与当前日期相差一周内时，返回值格式为“星期几 HH:mm”。

示例代码

const hour = moment().hour(15);
const referenceTime = hour.subtract(2, 'days');
console.log(moment().calendar()); // "今天 下午3:15"
console.log(moment(referenceTime).calendar()); // "上周五 下午3:15"
console.log(moment(referenceTime).calendar(hour)); // "18/08/2021 下午3:15"

总结

Moment.js moment().calendar() 函数是 Moment.js 中的一个日期格式化工具，它能根据日期差异来返回易于阅读的日期格式。该函数常常与其他 Moment.js 函数搭配使用，如 moment().diff() 函数来计算日期之间的时间差等。对于开发者来说，Moment.js moment().calendar() 函数是十分有用的，可以帮助有效地解决日期和时间处理的问题，提高了代码的可读性和可维护性。