incrementDate¶
将日期/时间增加指定的时间量。
参数¶
输入参数为一个 JSON 结构体。
参数 | 必需/可选 | 数据类型 | 描述 |
---|---|---|---|
startDate | 必需 | String | 指定的日期/时间。其格式必须于 startDatePattern 的格式相匹配。 |
startDatePattern | 必需 | String | startDate 的字符串格式(例如:yyyyMMdd HH:mm:ss.SSS)。 |
endDatePattern | 可选 | String | 增加时间量后返回的字符串格式(例如:yyyyMMdd HH:mm:ss.SSS)。如果未指定或将空格指定为值,则将以 startDatePattern 的格式返回。 |
addYears | 可选 | String | 添加到 startDate 的年数,范围从 -2147483648 至 2147483647。如果未指定、指定的值不合法或超过这个范围,则默认为 0。 |
addMonths | 可选 | String | 添加到 startDate 的月数,范围从 -2147483648 至 2147483647。如果未指定、指定的值不合法或超过这个范围,则默认为 0。 |
addDays | 可选 | String | 添加到 startDate 的天数,范围从 -2147483648 至 2147483647。如果未指定、指定的值不合法或超过这个范围,则默认为 0。 |
addHours | 可选 | String | 添加到 startDate 的小时数,范围从 -2147483648 至 2147483647。如果未指定、指定的值不合法或超过这个范围,则默认为 0。 |
addMinutes | 可选 | String | 添加到 startDate 的分钟数,范围从 -2147483648 至 2147483647。如果未指定、指定的值不合法或超过这个范围,则默认为 0。 |
addSeconds | 可选 | String | 添加到 startDate 的秒数,范围从 -2147483648 至 2147483647。如果未指定、指定的值不合法或超过这个范围,则默认为 0。 |
addMilliSeconds | 可选 | String | 添加到 startDate 的毫秒数,范围从 -2147483648 至 2147483647。如果未指定、指定的值不合法或超过这个范围,则默认为 0。 |
timezone | 可选 | String | 输出日期和时间的时区。指定一个时区代码,如格林尼治标准时间的 GMT。如果未指定 timezone ,则使用 GMT。 |
locale | 可选 | String |
|
注解
如果仅指定 startDate
,startDatePattern
和 endDatePattern
,并且未指定任何其他可选的参数添加到 startDate
,则将 startDate
的格式从``startDatePattern`` 转换为 endDatePattern
,并将其返回为 endDate
。
返回值¶
值 | 数据类型 | 描述 |
---|---|---|
endDate | String | 增加时间量到 startDate 后,以 endDatePattern 的格式返回的日期/时间。 |
示例¶
var format = tools.DateUtil.incrementDate({"startDate":"2021-04-13 10:23:55","startDatePattern":"yyyy-MM-dd hh:mm:ss","endDatePattern":"EEE yyyy年MM月dd日 hh:mm:ss","addYears":"1","addMonths":"1","addDays":"1","addHours":"1","addMinutes":"1","addSeconds":"1","addMilliSeconds":"111","timezone":"AGT","locale":"CH"});
return tools.resultBuilder.build(true, JSON.stringify(format));
输出
"星期六 2022年05月14日 08:24:56"