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"