# DateAdd

从日期-时间值中添加或减去时间.

    Result := DateAdd(DateTime, Time, TimeUnits)

## 参数

DateTime

  类型: 字符串

  YYYYMMDDHH24MISS 格式的日期-时间戳.

Time

  类型: 整数或浮点数

  要添加的时间, 以整数或浮点数表示. 指定一个负数以执行减法.

TimeUnits

  类型: 字符串

  Time 参数的单位. TimeUnits 可以是下列字符串之一(也可以是其第一个字母): Seconds(秒), Minutes(分), Hours(小时) 或 Days(天).

## 返回值

类型: 字符串

此函数返回一个 YYYYMMDDHH24MISS 格式的数字字符串. 此字符串不应视为数字(不应对其进行数学运算或进行数字比较).

## 备注

内置变量 A_Now 包含了 YYYYMMDDHH24MISS 格式的当前本地时间.

要计算两个时间戳之间的时间量, 请使用 DateDiff.

如果 DateTime 包含无效的时间戳或 1601 年之前的年份, 则抛出 ValueError.

## 相关

DateDiff, FileGetTime, FormatTime

## 示例

计算从现在起 31 天后的日期时间.

    later := DateAdd(A_Now, 31, "days")
    MsgBox FormatTime(later)

dftg