addtodate

（不推荐；请改用 duration 或 calendarDuration）为序列日期值增加时间

全页折叠

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

语法

dt = addtodate(d,t,timeUnit)

说明

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 之前推出

全部展开

另请参阅

| | | | |

主题