years

持续时间（以年为单位）

语法

Y = years(X)

说明

Y = years(X) 返回等同于 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 = 2x3 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 = 1x4 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

输入参数

X — 输入数组

数值数组 | 持续时间数组 | 逻辑数组

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

扩展功能

tall 数组

对行数太多而无法放入内存的数组进行计算。

此函数完全支持 tall 数组。有关详细信息，请参阅 tall 数组。

C/C++ 代码生成

使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

此函数完全支持代码生成。有关详细信息，请参阅持续时间数组的代码生成 (MATLAB Coder)。

基于线程的环境

使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

分布式数组

使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

此函数完全支持分布式数组。有关详细信息，请参阅Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox)。

版本历史记录

在 R2014b 中推出

另请参阅

calyears