calyears

日历持续时间（以年为单位）

全页折叠

语法

Y = calyears(X)

说明

calyears 函数返回表示日历年的数组。当您在日历计算中使用具有 calendarDuration 数据类型的数组时，计算会考虑闰年、夏令时变化和不同长度的日历月。要创建精确固定长度年份，请使用 years 函数。固定长度的一年是 365.2425 天。

Y = calyears(X) 返回一个数组，该数组表示等效于 X 中的值的日历年。

  • 如果 X 为数值数组，则 Y 为 calendarDuration 数组，其中每个元素与 X 的对应元素中的日历年数相等。

  • 如果 X 为 calendarDuration 数组，则 calyears 返回的整年数与 X 中的每个日历持续时间等效。

示例

示例

全部折叠

打开实时脚本
X = magic(4);
Y = calyears(X)
Y = 4×4 calendarDuration
   16y    2y    3y   13y
    5y   11y   10y    8y
    9y    7y    6y   12y
    4y   14y   15y    1y
打开实时脚本

创建一个日历持续时间数组。然后，将每个值转换为等效的整数日历年数。

X = calmonths(21:25) + caldays(8)
X = 1×5 calendarDuration
    1y 9mo 8d   1y 10mo 8d   1y 11mo 8d        2y 8d    2y 1mo 8d


Y = calyears(X)
Y = 1×5

     1     1     1     2     2

输入参数

全部折叠

输入数组，指定为数值数组、日历持续时间数组或逻辑数组。如果 X 是数值数组，则它必须仅包含整数值。即，您不能创建带小数的日历单位。

输出参量

全部折叠

日历年，以标量、向量、矩阵或多维数组形式返回。Y 的大小与 X 相同。Y 的数据类型取决于 X。

  • 如果 X 为数值数组，则 Y 是一个日历持续时间数组并且以等效的灵活长度日历年为单位。

  • 如果 X 为 calendarDuration 数组，则 Y 是一个包含表示整数日历年的整数值的 double 数组。

提示

  • 在用于日历计算中时，calyears 会考虑闰日来创建年份。要创建精确固定长度（365.2425 天）的年份，请使用 years 函数。

扩展功能

全部展开

基于线程的环境
使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

版本历史记录

在 R2014b 中推出

另请参阅

| |