函数参考


_DateAdd

计算一个指定的日期和间隔后的新日期.

#Include <Date.au3>
_DateAdd($sType, $iValToAdd, $sDate)

参数

$sType 下方的一个值:
D - 以天为单位添加到指定的日期
M - 以月为单位添加到指定的日期
Y - 以年为单位添加到指定的日期
w - 以周为单位添加到指定的日期
h - 以小时为单位添加到指定的日期
n - 以分钟为单位添加到指定的日期
s - 以秒钟为单位添加到指定的日期
$iValToAdd 要添加的数量
$sDate 输入一个格式为 YYYY/MM/DD[ HH:MM:SS] 的日期

返回值

成功: 返回计算出的新日期.
失败: 返回 0 并设置 @ERROR 为:
@error: 0 - 没有错误
1 - 无效 $sType
2 - 无效 $iValToAdd
3 - 无效 $sDate

注意/说明

这个函数不会返回一个无效的日期.
当添加三个月到 '2004/1/31' 将返回 2004/04/30

相关

_DateDiff, _DateTimeSplit, _DateToDayOfWeek, _DateToDayOfWeekISO, _DateToDayValue, _DayValueToDate

示例/演示


#include <Date.au3>

; 今天+5天
Local $sNewDate = _DateAdd('d', 5, _NowCalcDate())
MsgBox( 4096, "", "今天 + 5 天:" & $sNewDate )

; 今天减去两周
$sNewDate = _DateAdd('w', -2, _NowCalcDate())
MsgBox( 4096, "", "今天减去两周: " & $sNewDate )

; 当前时间 +15 分钟
$sNewDate = _DateAdd('n', 15, _NowCalc())
MsgBox( 4096, "", "当前时间 +15 分钟: " & $sNewDate )

; 计算从 1970/01/01 00:00:00 开始 经过 1087497645 秒后的时间
$sNewDate = _DateAdd('s', 1087497645, "1970/01/01 00:00:00")
MsgBox( 4096, "", "计算时间: " & $sNewDate )