npm 包 utils.time 使用教程-JavaScript中文网-JavaScript教程资源分享门户

在前端开发中，时间转换和日期格式化是常见的操作。为了方便开发者处理这些任务，JavaScript 社区开发了许多常用的时间处理库，其中 utils.time 是一款常用的 npm 包。

本文将介绍如何使用 utils.time 进行时间转换和日期格式化，以及其详细的 API 和示例代码。

安装

使用 npm 安装 utils.time：

npm install utils.time

引入

在 JavaScript 代码中引入 utils.time：

const time = require('utils.time')

API

时间戳操作

`time.getUnix()`

获取当前时间的时间戳。

time.getUnix() // 1584826869

`time.getDays(timeStamp)`

根据时间戳计算时间差，返回相应的天数。

time.getDays(1584826869) // 18442

日期格式化

`time.format(timeString, format)`

根据格式字符串将时间字符串格式化。

以下是 format 可以使用的格式化字符串参数：

YYYY 年份四位数
YY 年份两位数
MM 月份（01-12）
M 月份（1-12）
DD 日期（01-31）
D 日期（1-31）
hh 小时（00-23）
h 小时（0-23）
mm 分钟（00-59）
m 分钟（0-59）
ss 秒钟（00-59）
s 秒钟（0-59）
W 星期几（例如：'日'、'一'、'二'、'三'、'四'、'五'、'六'）

// 格式化当前时间
time.format(new Date(), 'YYYY-MM-DD hh:mm:ss') // "2020-03-22 21:47:49"

// 格式化指定时间字符串
time.format('2020-03-22 21:47:49', 'YYYY年MM月DD日 hh:mm:ss W') // "2020年03月22日 21:47:49 日"

时间转化

`time.fromNow(targetTime)`

计算一个时间距离现在的时间差，并返回一个类似 5分钟前 的字符串。

time.fromNow(new Date('2020-03-22T12:22:48.000Z')) // "8 hours ago"

`time.toTimeStamp(arg)`

将一个时间参数转换为时间戳。

参数可以是一个时间字符串或一个 Date 对象。

time.toTimeStamp('2020-03-22 21:47:49') // 1584905269000
time.toTimeStamp(new Date('2020-03-22T12:22:48.000Z')) // 1584864168000

`time.toYYYYMMDD(time)`

将时间字符串转换为年月日格式的字符串。

time.toYYYYMMDD('2020-03-22 21:47:49') // "2020-03-22"

`time.toHHmmSS(time)`

将时间字符串转换为时分秒格式的字符串。

time.toHHmmSS('2020-03-22 21:47:49') // "21:47:49"

示例代码

格式化时间字符串

const time = require('utils.time')

const datetime = '2020-03-19T05:30:00.000Z'
const date = datetime.split('T')[0]
const timeString = datetime.split('T')[1].slice(0, 5)

const formattedTime = time.format(`${date} ${timeString}`, 'YYYY年MM月DD日 hh:mm:ss W') // "2020年03月19日 05:30:00 Thu"

时间差计算

const time = require('utils.time')

const now = time.getUnix()
const target = new Date('2021-01-01').getTime() / 1000 // 时间戳
const diff = time.getDays(target - now) // 相差的天数

时间转化

const time = require('utils.time')

const targetDate = '2020-03-22T12:22:48.000Z'
const timeStamp = time.toTimeStamp(targetDate)
const formattedDate = time.format(new Date(targetDate), 'YYYY年MM月DD日')
const timeFromNow = time.fromNow(targetDate)

使用 utils.time 函数库，可以轻松地实现时间格式化、时间差计算和时间转化等操作。本文所列的 API 远不完整，开发者可以在该库的官方文档中了解其它 API 的使用方法。

感谢您的阅读，希望这篇文章对您的前端开发有所帮助！

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