npm 包 js-dateformat 使用教程

阅读时长 4 分钟读完

日期格式化是前端开发中必不可少的功能,而 js-dateformat 是一个通用日期格式化库,既适用于浏览器环境也适用于 Node.js 环境。本文将详细讲解如何使用这个库。

安装

使用 npm 安装 js-dateformat:

安装完毕后,可以在代码中引入:

或者使用 ES6 模块导入:

API

js-dateformat 的 API 非常简单,只有一个函数:

dateFormat(date, format, options?)

参数说明:

  • date:要格式化的日期。可以是 Date 对象,也可以是一个时间戳(number 类型)。
  • format:格式化字符串。具体用法见下文。
  • options:可选参数,用来设置一些选项。具体用法见下文。

格式化字符串

format 参数是一个字符串,用来指定日期格式。以下是常用的格式化字符:

  • yyyy:四位数的年份表示。
  • yy:两位数的年份表示。
  • MM:月份,如果小于 10,则前面加上 0。
  • M:月份。
  • dd:日期,如果小于 10,则前面加上 0。
  • d:日期。
  • hh:小时,使用 12 小时制,如果小于 10,则前面加上 0。
  • h:小时,使用 12 小时制。
  • HH:小时,使用 24 小时制,如果小于 10,则前面加上 0。
  • H:小时,使用 24 小时制。
  • mm:分钟,如果小于 10,则前面加上 0。
  • m:分钟。
  • ss:秒,如果小于 10,则前面加上 0。
  • s:秒。
  • S:毫秒。

如果要使用其他的格式化字符,可以参考 这个网站 上的文档。

示例

以下是一些使用示例:

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

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

options

options 参数用来设置一些选项,它有以下几个属性:

  • UTC:如果为 true,则表示以 UTC 时间格式化日期,默认为 false。
  • offset:设置时区偏移量。例如,如果要设置为中国时区,可以写 offset: '+0800'

以下是一个使用 options 的示例:

总结

使用 js-dateformat 可以轻松地实现日期格式化功能。除了常见的格式化字符外,还可以使用一些复杂的格式化字符,例如 E 表示星期几。同时,通过 options 参数还可以设置时区等选项。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005524a81e8991b448cfd1e

纠错
反馈