在Web应用程序开发中,时间戳(timestamp)是非常重要的东西。在JavaScript中,我们获得时间戳信息的最常见方式是使用Date
对象。但是,我们必须去了解JavaScriptDate
对象的API,才能够自定义时间戳显示格式。这时候,就可以通过ttime这个NPM包,来简化我们的时间戳操作。
ttime是什么
ttime 是一个将时间戳转化为易读格式的开源JavaScript库。它有以下特点:
- 轻量级(仅1.1kb)。
- 依赖性低,可以方便地与其他包合作。
- 支持各种时间戳显示格式。
- 支持浏览器和Node.js环境。
如何安装ttime
使用npm安装ttime,只需要在控制台运行下面的命令即可:
npm install ttime --save
如何使用ttime
在浏览器端使用ttime
在你的HTML文件中加入脚本链接,然后就可以在JavaScript代码中引入ttime
了:
<script src="https://unpkg.com/ttime"></script>
var ttime = window.ttime; console.log(ttime(1612721270173, "yyyy年MM月dd日 hh点mm分ss秒")); // 输出:2021年02月08日 09点41分10秒
在Node.js环境中使用ttime
在Node.js中使用ttime很简单,只需要在代码中引入ttime
模块,就可以开始使用了:
const ttime = require('ttime'); console.log(ttime(1612721270173, "yyyy年MM月dd日 hh点mm分ss秒")); // 输出:2021年02月08日 09点41分10秒
注意:如果你在Node.js中使用你需要先安装ttime
包。
ttime API
ttime的API非常简单。它有两个参数:
ttime(timestamp, format)
timestamp
:必填参数,时间戳或日期,可以是JavaScript原生的时间戳或可以转换为时间戳的日期,例如'2021-01-01'。如果不填,则默认为当前时间。format
:可选参数,字符串类型,用于指定时间戳的输出格式。默认格式为"yyyy-MM-dd hh:mm:ss"。
一个简单的例子:
const babyDueDate = ttime(new Date('2022-02-14T00:00:00.000+08:00')); console.log(babyDueDate); // 输出: 2022-02-14 00:00:00
下面是一些常用的日期格式字符串:
- "yyyy":年
- "MM":月
- "dd":日
- "hh":小时(12小时制)
- "HH":小时(24小时制)
- "mm":分钟
- "ss":秒
- "zzz":毫秒
ttime 测试
我们来实现一个简单的测试,先安装Jest:
npm install --save-dev jest
然后在项目中创建一个index.test.js
文件:
const ttime = require('./index'); test('ttime was required and is a function', () => { expect(ttime).toBeInstanceOf(Function); });
最后在控制台中输入npx jest
即可运行测试。
总结
ttime是一个简单实用的JavaScript库,可以用于将时间戳转换为易读的格式。使用ttime,我们可以避免直接操作原生Date对象,减少出错的可能性,而且它的API设计也相当简单,方便开发者使用。
如果你在自己的项目中有时间戳格式的需求,那么ttime是一个不错的选择。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60055cb381e8991b448da1af