日期格式化是前端开发中必不可少的功能,而 js-dateformat 是一个通用日期格式化库,既适用于浏览器环境也适用于 Node.js 环境。本文将详细讲解如何使用这个库。
安装
使用 npm 安装 js-dateformat:
npm install --save js-dateformat
安装完毕后,可以在代码中引入:
const dateFormat = require('js-dateformat');
或者使用 ES6 模块导入:
import dateFormat from 'js-dateformat';
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 的示例:
// 格式化 UTC 时间 const now = new Date(); const str = dateFormat(now, 'yyyy-MM-dd HH:mm:ss', { UTC: true }); console.log(str); // 输出 2021-08-19 06:45:27,与本地时间相差 8 个小时 // 格式化中国时间 const str2 = dateFormat(now, 'yyyy-MM-dd HH:mm:ss', { offset: '+0800' }); console.log(str2); // 例如,输出 2021-08-19 14:45:27
总结
使用 js-dateformat 可以轻松地实现日期格式化功能。除了常见的格式化字符外,还可以使用一些复杂的格式化字符,例如 E
表示星期几。同时,通过 options 参数还可以设置时区等选项。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005524a81e8991b448cfd1e