datenum
(不推荐;请改用 datetime
或 duration
)将日期和时间转换为日期序列值
不推荐使用 datenum
。要表示时间点,请使用 datetime
数组。要表示经过的时间,请使用 duration
或 calendarDuration
数组。有关更新代码的详细信息,请参阅版本历史记录或Replace Discouraged Instances of Serial Date Numbers and Date Strings。
语法
说明
将输入数组 DateNumber
= datenum(t
)t
中的 datetime
或 duration
值转换为日期序列值。
日期序列值表示某个固定的预设日期(0000 年 1 月 0 日)以来的整个天数及其小数值,采用前 ISO 日历形式。
将表示日期时间的文本转换为日期序列值。如果已知文本中使用的格式,则将格式指定为 DateNumber
= datenum(DateString
)formatIn
。不含 formatIn
的语法的执行速度远远慢于包含此项的语法执行速度。
使用 DateNumber
= datenum(DateString
,formatIn
)formatIn
解析 DateString
所表示的日期时间。
使用 DateNumber
= datenum(DateString
,PivotYear
)PivotYear
解析以两个字符指定年份的文本。如果已知文本中使用的格式,则将格式指定为 formatIn
。不含 formatIn
的语法的执行速度远远慢于包含此项的语法执行速度。
使用 DateNumber
= datenum(DateString
,formatIn
,PivotYear
)formatIn
解析 DateString
所表示的日期时间,使用 PivotYear
解析以两个字符指定年份的文本。可以按任一顺序指定 formatIn
和 PivotYear
。
将日期向量解释为日期序列值,并返回由 DateNumber
= datenum(DateVector
)m
个日期数字构成的列向量,其中 m
是 DateVector
中日期向量的总数。
返回 DateNumber
= datenum(Y,M,D
)Y
、M
和 D
(年、月、日)数组的对应元素的日期序列值。这些数组的大小必须相同(或者,其中任一数组可以是标量)。还可以将输入参量指定为日期向量 [Y,M,D]
。
另外返回 DateNumber
= datenum(Y,M,D,H,MN,S
)H
、MN
和 S
(小时、分、秒)数组的对应元素的日期序列值。这些数组的大小必须相同(或者,其中任一数组可以是标量)。还可以将输入参量指定为日期向量 [Y,M,D,H,MN,S]
。
示例
输入参数
输出参量
提示
要创建任意形状的输出,请使用
datenum(Y,M,D)
和datenum(Y,M,D,H,MN,S)
语法。datenum(DateVector)
语法只能创建由日期数字构成的列向量。datenum(2013,[1 3; 2 4],ones(2,2))
ans = 735235 735294 735266 735325