years

持续时间（以年为单位）

全页折叠

语法

Y = years(X)

说明

Y = years(X) 返回等同于输入数组中的值的固定长度年份的数组。

  • 如果 X 是数值数组，则 Y 是以固定长度年数为单位的 duration 数组。固定长度的一年等于 365.2425 天。

  • 如果 X 为 duration 数组，则 Y 为 double 数组，其中每个元素与 X 的对应元素中的固定长度年数相等。

years 函数在 duration 与 double 值之间转换。要以年为单位显示持续时间，请将其 Format 属性设置为 'y'。

闰年还有额外的一天。要创建一个在用于日历计算中时考虑闰年的日历年数组，请使用 calyears 函数。

示例

示例

全部折叠

打开实时脚本
X = [1 3 5; 10 12 15]
X = 2×3

     1     3     5
    10    12    15


Y = years(X)
Y = 2×3 duration
     1 yr    3 yrs    5 yrs
   10 yrs   12 yrs   15 yrs
打开实时脚本

求出两个日期数组的差分。输出是一个 duration 数组。

t1 = datetime(2007:2010,10,1);
t2 = datetime(2014,05,1);
dt = t2 - t1
dt = 1×4 duration
   57696:00:00   48912:00:00   40152:00:00   31392:00:00

将 dt 中的每个持续时间转换为固定长度的年数。

Y = years(dt)
Y = 1×4

    6.5819    5.5799    4.5805    3.5812

输入参数

全部折叠

输入数组，指定为数值数组、持续时间数组或逻辑数组。

扩展功能

全部展开

版本历史记录

在 R2014b 中推出

另请参阅