npm 包 x-hijridate 使用教程

阅读时长 4 分钟读完

简介

x-hijridate 是一款基于 Hijri Calendar 的日期格式化工具,可轻松在 Node.js 和浏览器中使用。

安装

使用 npm 安装

开始使用

在 Node.js 中使用:

在浏览器中使用:

-- -------------------- ---- -------
--------- -----
----- ----------
  ------
    ----- --------------- --
    ------------------ ------------
  -------
  ------
    ---- ----------------------

    ------- ---------------------------------------------
    --------
      ----- ---- - --- ---------------------------------

      ----- --------- - --- -----------------

      ----------------------------------------------- - -----------------
        ---------------
      --
    ---------
  -------
-------

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

纠错
反馈