year

日期和时间输入的年份数

全页折叠

语法

y = year(t)

y = year(t,yearType)

说明

y = year(t) 返回输入数组中每个日期和时间的年份数。默认情况下，year 返回 ISO 年份数，其中包括零年并使用负值表示 BCE 年。

输出 y 是一个 double 数组。要向 datetime 数组 t 分配 ISO 年值，请使用 t.Year 并修改 Year 属性。

示例

y = year(t,yearType) 返回 datetime 数组 t 的年份数的类型，指定为 "iso" 或 "gregorian"。

示例

全部折叠

从日期中提取年份数

打开实时脚本

从日期数组中提取年份数。

t = datetime(2010,05,31):calyears(1):datetime(2015,02,28)

t = 1×5 datetime
   31-May-2010   31-May-2011   31-May-2012   31-May-2013   31-May-2014

y = year(t)

y = 1×5

        2010        2011        2012        2013        2014

输入参数

全部折叠

`t` — 日期和时间输入
`datetime` 数组

日期和时间输入，指定为 datetime 数组。

为了支持过去需要 Financial Toolbox™ 才能使用的一些代码，year 还接受序列日期值和文本作为输入，但不推荐使用它们。有关详细信息，请参阅版本历史记录。

`yearType` — 年值的类型
`'iso'` (默认) | `'gregorian'`

年值的类型，指定为 'iso' 或 'gregorian'。仅当 t 是 datetime 数组时，此参量才有效。

如果 yearType 为 'iso'，则 year 返回 ISO 年份数，该数字包括零年并使用负值表示 BCE 年。
如果 yearType 为 'gregorian'，则 year 返回格里历年份数，这是一个无符号整数。例如，在这两种情况下，5 CE 和 5 BCE 的格里历年份数均为 5。格里历年份数没有第零年。

仅当 t 是 datetime 数组时，此参量才有效。

扩展功能

全部展开

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

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

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

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

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

此函数完全支持分布式数组。有关详细信息，请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。

版本历史记录

在 R2014b 中推出

全部展开

R2022a: 不推荐使用序列日期值和文本输入

尽管 year 支持序列日期值和文本输入，但还是推荐使用 datetime 值。datetime 数据类型提供灵活的日期和时间格式、纳秒精度的存储，以及考虑时区和夏令时的属性。

要将序列日期值或文本转换为 datetime 值，请使用 datetime 函数。例如：

t = datetime(738427.656845093,"ConvertFrom","datenum");
y = year(t)

y =

        2021

目前没有停止支持序列日期值或文本输入的计划。

R2022a: Financial Toolbox 和 MATLAB 中的 `year` 函数已合并

在以前的版本中，有两个 year 函数：一个在 MATLAB^® 中，接受 datetime 值；另一个在 Financial Toolbox 中，接受序列日期值或文本值。从 R2022a 开始，您可以在没有 Financial Toolbox 的情况下调用 year。当您在 MATLAB 中调用 year 时，它接受所有以前的输入类型。

例如，您可以在 MATLAB 中使用序列日期值和文本进行以下调用：

y = year(738427.656845093)

y =

        2021

y = year("28-Sep-2021")

y =

        2021

此外，当第一个输入不是 datetime 数组时，year 还接受表示日期格式的第二个输入：

y = year(t,F)

在此语法中，可以使用 datestr 函数文档中的有效日期格式指定 F，但尚不支持 'Q' 格式设定符。例如：

y = year("2021/28/09","yyyy/dd/mm")

y =

        2021

另请参阅

year

语法

说明

示例

从日期中提取年份数

输入参数

t — 日期和时间输入 datetime 数组

yearType — 年值的类型 'iso' (默认) | 'gregorian'