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
返回日期的语言。例如，如果 locale 为 CH （中文），pattern 为 EEE yyyy-MM-dd hh:mm:ss 会产生 星期四 2000-04-13 07:23:55。如果未指定 locale，则使用 EN。目前支持：

  • CH：中文

  • EN：英文


备注

如果仅指定 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"