npm 包 time-to-string 使用教程

简介

在前端开发过程中，我们常常需要将日期对象转换成字符串，以便在页面中进行展示或者数据交互。而 Node.js 生态圈中有一个非常强大的日期格式化工具库 moment.js，但是这个库比较庞大，如果只是单纯的日期格式化使用，显得有些过度。

而 npm 上有一个轻量级的日期格式化工具库 time-to-string，它只有 1KB 左右的大小，目的是提供一个简单、易用的日期格式化解决方案。

安装

在终端中进入项目所在目录，运行以下命令安装 time-to-string：

npm install time-to-string

使用方法

安装完成后，在需要使用日期格式化功能的文件中引入 time-to-string：

const timestr = require('time-to-string')

基本用法

在引入 time-to-string 之后，我们可以得到一个函数，该函数接受一个 Date 类型的参数，返回一个格式化后的字符串。time-to-string 使用一些特殊的字符来表示不同的时间单位，比如：

• YYYY 表示年份，如 2022
• MM 表示月份，如 10
• DD 表示日期，如 01
• hh 表示小时，如 13
• mm 表示分钟，如 30
• ss 表示秒钟，如 24

我们可以根据需要自由组合这些字符，得到想要的日期格式。

下面是一段基本用法的代码示例：

const date = new Date('2022-10-01 13:30:24')
const dateString = timestr(date, 'YYYY-MM-DD hh:mm:ss')
console.log(dateString) // => '2022-10-01 13:30:24'

在上面的代码中，我们传入了一个 Date 类型的参数和一个格式化字符串，得到了一个格式化后的字符串 '2022-10-01 13:30:24'。

语言本地化

time-to-string 还支持将日期格式化为本地化语言的字符串。我们可以通过在格式化字符串中添加语言缩写来实现这个功能。

例如，要将日期格式化为中文，可以将格式化字符串改为：

const dateString = timestr(date, 'YYYY年MM月DD日 hh:mm:ss', 'zh-CN')

在上面的代码中，我们传入了一个语言参数 'zh-CN'，将日期格式化为中文。

目前支持的语言缩写有：'en-US'（英语）、'zh-CN'（中文简体）、'zh-TW'（中文繁体）。

常用格式化字符串

以下是一些常用的日期格式化字符串：

总结

time-to-string 是一个轻量级、易用的日期格式化工具，可以帮助我们快速地将日期对象转换成需要的字符串格式，而不必使用庞大的日期处理库。它支持本地化语言，使用起来也非常简单，非常适合在前端项目中使用。

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005668181e8991b448e29ff