1.0.0 • Published 2 years ago

noctjs-datetime v1.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

NOCTJS-DATETIME

noctjs云函数dateTime模块,主要作用为日期时间处理。

dateTime 日期时间操作

now(formatString, timezone)

获取当前时间

参数类型必填说明
formatStringString日期格式化,yyyy表示年份,MM表示月份,dd表示日期,HH表示时,mm表示分,ss表示秒,fff表示毫秒。不填则返回为时间戳
timezoneNumberformatString存在时有效,格式化为指定时区的时间,默认8

format(timestamp, formatString, timezone)

日期格式化

参数类型必填说明
timestampNumber/String要格式化的时间戳
formatStringString日期格式化,yyyy表示年份,MM表示月份,dd表示日期,HH表示时,mm表示分,ss表示秒,fff表示毫秒
timezoneNumber时区,默认8

addYears(timestamp, value)

添加年份

参数类型必填说明
timestampNumber/String时间戳
valueNumber要添加的年份数值

addMonths(timestamp, value)

添加月份

参数类型必填说明
timestampNumber/String时间戳
valueNumber要添加的月份数值

addDays(timestamp, value)

添加日期

参数类型必填说明
timestampNumber/String时间戳
valueNumber要添加的日期数值

addHours(timestamp, value)

添加时

参数类型必填说明
timestampNumber/String时间戳
valueNumber要添加的时数值

addMinutes(timestamp, value)

添加分

参数类型必填说明
timestampNumber/String时间戳
valueNumber要添加的分数值

addSeconds(timestamp, value)

添加秒

参数类型必填说明
timestampNumber/String时间戳
valueNumber要添加的秒数值

addMilliseconds(timestamp, value)

添加毫秒

参数类型必填说明
timestampNumber/String时间戳
valueNumber要添加的毫秒数值

使用示例

const dateTime = require("noctjs-datetime");

dateTime.now("yyyy-MM-dd HH:mm:ss"); // 得到格式为2020-11-11 00:00:00的当前时间
dateTime.format(1605024000000, "yyyy年MM月dd日HH时mm分ss秒"); // 格式化时间为2020年11月11日00时00分00秒
dateTime.addYears(1605024000000, 2); // 原始日期为2020年11月11日,年份增加2年,结果为2022年11月11日
dateTime.addMonths(1605024000000, 13); // 原始日期为2020年11月,增加13个月,结果为2021年12月
dateTime.addHours(1605024000000, -1); // 原始日期为2020年11月11日00时,增加-1时,结果为2020年11月10日23时