简介
human-dates
是一个能够将日期转换为易读的、符合人类预期的格式的 npm 包。这个包可以很好地与 Node.js 和浏览器一起使用,方便开发人员进行日期显示操作。
安装
通过以下命令安装 human-dates
:
npm install human-dates
使用
Node.js
在需要使用 human-dates
的文件中,引入它并调用相应方法即可。下面是一个简单的例子,将日期格式化为字符串:
const humanDates = require('human-dates'); const date = new Date(); const formattedDate = humanDates.relativeTime(date); console.log(formattedDate);
在浏览器端使用 human-dates
也十分简单。只需要将 require('human-dates')
替换为 window.humanDates
即可。这里不再赘述,读者可自行查阅官方文档。
api
human-dates
常用的 API 如下:
relativeTime(date[, baseDate])
将日期格式化为相对时间,可以在日期被 formatted 之前传递第二个可选参数 baseDate,表示格式化相对于此日期。常见的文字表述有“1 小时前”、“昨天”、“上周二” 等等。
const humanDates = require('human-dates'); const date = new Date('2021-11-25T12:00:00Z'); const baseDate = new Date('2021-11-28T12:00:00Z'); const formattedDate = humanDates.relativeTime(date, baseDate); console.log(formattedDate); // 3 天前
strftime(date [, format])
将日期格式化为自定义格式的字符串。具体的可用格式列表详见项目的文档。
const humanDates = require('human-dates'); const date = new Date(); const formattedDate = humanDates.strftime(date, '%A, %B %e, %Y %l:%M%p'); console.log(formattedDate); // Friday, November 26, 2021 5:51AM
示例
下面给出一个完整的示例代码,将一个数组中的日期按照 relativeTime
规则转换为相对时间。
-- -------------------- ---- ------- ----- ---------- - ----------------------- ----- ----- - - --- ----------------------------- --- ----------------------------- --- ------- -- ----- -------- - --- ----------------------------- ----- -------------- - ---------------- -- ----------------------------- ----------- ---------------------------- -- --- ---- ----- -- -----展开代码
总结
human-dates
作为一个日期格式化的工具库,非常易用且定制化程度高。我们能够根据项目的不同需求,使用 relativeTime
或 strftime
等方法来实现日期的格式化。只要按照官方文档使用,我们就能更好的完成前端开发中日期的使用和操作。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/103644