在 Web 开发或移动端应用开发中,经常需要对时间进行格式化以达到更好的展示效果。npm 包 format-duration 就是一个很好的工具,它可以快速帮助我们将时间以指定的格式进行展示。接下来让我们一起来学习如何使用它。
安装
在终端命令行中输入以下命令即可在你的项目中安装 format-duration:
npm install format-duration
使用方法
- 引入 format-duration
在你的项目中引入 format-duration:
const formatDuration = require('format-duration');
- 格式化时间
调用 formatDuration
方法并传入需要格式化的时间(毫秒数)和展示格式即可:
const duration = 86400000; // 一天的时间 console.log(formatDuration(duration)); // 输出:1d
此时,输出的时间格式为一个部分写法的天数,即 d
。
- 自定义展示格式
默认情况下,format-duration 只提供常见的时间格式,例如 1 秒
, 3 分钟 22 秒
, 2 小时 15 分钟 34 秒
等。如果你想自定义展示格式,可以传入 format
参数:
const duration = 2000; // 2 秒 console.log(formatDuration(duration, { format: ['h', ':', 'm', ':', 's', '.', 'x'] })); // 输出:0:00.2x
这里的 format
是一个数组,指定了展示格式中各部分的顺序。每个字符代表一部分展示格式,具体含义可以参考官方文档。
- 指定精度
有时候我们只需要展示到分钟或秒,并且不需要展示小数部分,可以使用 precision
参数。
const duration = 76000; // 76 秒 console.log(formatDuration(duration, { precision: 2 })); // 输出:1 分钟 16 秒
这里的 precision
指定了展示精度,即展示到秒后面的一位小数。
示例代码
const formatDuration = require('format-duration'); console.log(formatDuration(86400000)); // 输出:1d console.log(formatDuration(2000, { format: ['h', ':', 'm', ':', 's', '.', 'x'] })); // 输出:0:00.2x console.log(formatDuration(76000, { precision: 2 })); // 输出:1 分钟 16 秒
总结
format-duration 是一个非常实用的时间格式化工具,通过学习和使用它,我们可以更加便捷地处理时间格式化操作,提高了我们的开发效率。希望本文能够对你有所帮助。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/5eedb483b5cbfe1ea06112cb