简介
x-hijridate 是一款基于 Hijri Calendar 的日期格式化工具,可轻松在 Node.js 和浏览器中使用。
安装
使用 npm 安装
npm install x-hijridate
开始使用
在 Node.js 中使用:
const HijriDate = require('x-hijridate'); const date = new Date('2019-05-07T01:23:45.678Z'); const hijriDate = new HijriDate(date); console.log(hijriDate.format('iDD/iMM/iYYYY')); // 03/08/1440
在浏览器中使用:
-- -------------------- ---- ------- --------- ----- ----- ---------- ------ ----- --------------- -- ------------------ ------------ ------- ------ ---- ---------------------- ------- --------------------------------------------- -------- ----- ---- - --- --------------------------------- ----- --------- - --- ----------------- ----------------------------------------------- - ----------------- --------------- -- --------- ------- -------
API
new HijriDate(dateString)
该静态方法返回一个 HijriDate
实例,dateString
可以是一个 Date 对象或一个 ISO 8601 兼容的日期字符串。
format(formatString)
该方法将 HijriDate
格式化为指定格式,并返回格式化后的字符串。formatString
特定字段的占位符使用 i
替代 d
。
支持的格式
格式化字符串 | 描述 |
---|---|
iYYYY |
四位数的年份 |
iYY |
两位数的年份 |
iM |
十进制表示的 Hijri 月份 |
iMM |
十进制补零的 Hijri 月份 |
iMMM |
缩写的 Hijri 月份 |
iMMMM |
完整的 Hijri 月份名称 |
iD |
Hijri 月中的天数 |
iDD |
十进制补零的 Hijri 月中的天数 |
iDDD |
十进制表示的 Hijri 年中的天数 |
iDh |
十进制补零的 Hijri 日,使用 24 小时格式 |
iDhh |
十进制补零的 Hijri 日,使用 12 小时格式 |
iH |
十进制表示的 Hijri 小时,使用 24 小时格式 |
iHH |
十进制补零的 Hijri 小时,使用 24 小时格式 |
iAh |
十进制补零的 Hijri 小时,使用 12 小时格式 |
iA |
大写字母的 Hijri 标志,使用 12 小时格式 |
iAm |
无前导零的 Hijri 分钟,使用 12 小时格式 |
iAmm |
十进制补零的 Hijri 分钟,使用 12 小时格式 |
iB |
标准时间的时区偏移量 |
iZ |
ISO 8601 格式,使用时区偏移量 |
示例
-- -------------------- ---- ------- ----- --------- - ----------------------- ----- ---- - --- --------------------------------- ----- --------- - --- ---------------- ----------------------------------------------- -- ---------- -------------------------------------------- ------- ----- -- ------------- ------- -----
结论
使用 x-hijridate 包不仅能帮助我们快速处理日期格式,还可以避免我们所有的日期计算问题。同时,如果你需要在你的网站上实现按 Hijri 日期格式显示日期,那么这个库是非常好的选择。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600671198dd3466f61ffe7c1