NOCTJS-DATETIME

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

dateTime 日期时间操作

now(formatString, timezone)

获取当前时间

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

format(timestamp, formatString, timezone)

日期格式化

参数	类型	必填	说明
timestamp	Number/String	是	要格式化的时间戳
formatString	String	是	日期格式化，yyyy表示年份，MM表示月份，dd表示日期，HH表示时，mm表示分，ss表示秒，fff表示毫秒
timezone	Number	否	时区，默认8

addYears(timestamp, value)

添加年份

参数	类型	必填	说明
timestamp	Number/String	是	时间戳
value	Number	是	要添加的年份数值

addMonths(timestamp, value)

添加月份

参数	类型	必填	说明
timestamp	Number/String	是	时间戳
value	Number	是	要添加的月份数值

addDays(timestamp, value)

添加日期

参数	类型	必填	说明
timestamp	Number/String	是	时间戳
value	Number	是	要添加的日期数值

addHours(timestamp, value)

添加时

参数	类型	必填	说明
timestamp	Number/String	是	时间戳
value	Number	是	要添加的时数值

addMinutes(timestamp, value)

添加分

参数	类型	必填	说明
timestamp	Number/String	是	时间戳
value	Number	是	要添加的分数值

addSeconds(timestamp, value)

添加秒

参数	类型	必填	说明
timestamp	Number/String	是	时间戳
value	Number	是	要添加的秒数值

addMilliseconds(timestamp, value)

添加毫秒

参数	类型	必填	说明
timestamp	Number/String	是	时间戳
value	Number	是	要添加的毫秒数值

使用示例

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时