Main Content

addtodate

(不推荐;请改用 durationcalendarDuration)为日期序列值增加时间

不推荐使用 addtodate。使用 datetime 数据类型表示时间点,并为 datetime 值增加以 durationcalendarDuration 值表示的时间。有关更新代码的详细信息,请参阅版本历史记录Replace Discouraged Instances of Serial Date Numbers and Date Strings

说明

示例

dt = addtodate(d,t,timeUnit) 将时间长度 t 与日期序列值 d 相加,并将结果作为另一个日期序列值 dt 返回。输入参数 timeUnit 指定 t 的时间单位。例如,addtodate(d,12,"hours") 会在 d 表示的日期和时间上再加上 12 小时。

示例

全部折叠

创建一个表示 2022 年 1 月 1 日的日期序列值。

d = datenum("2022-01-01")
d = 738522

d 加上 14 天。将日期值转换为 datetime 值以进行显示。

dt = addtodate(d,14,"day")
dt = 738536
datetime(dt,"ConvertFrom","datenum")
ans = datetime
   15-Jan-2022

通过将第二个输入参数指定为负数,从 dt 中减去 12 小时。

dt = addtodate(dt,-12,"hour")
dt = 7.3854e+05
datetime(dt,"ConvertFrom","datenum")
ans = datetime
   14-Jan-2022 12:00:00

如果增加的时间长度足够长,则 dt 可以向前或向后转进到任何适当的时间段。例如,将 dt 增加 30 天,日期就会变为二月。

dt = addtodate(dt,30,"day");
datetime(dt,"ConvertFrom","datenum")
ans = datetime
   13-Feb-2022 12:00:00

输入参数

全部折叠

输入日期和时间,指定为日期序列值。

d 增加的时间长度,指定为 -1016 和 1016 之间的整数,包括这两个值。

t 的时间单位,指定为列出的值之一。

版本历史记录

在 R2006a 之前推出

全部展开