year
日期时间输入的年份值
说明
示例
输入参数
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 数组
对行数太多而无法放入内存的数组进行计算。
此函数完全支持 tall 数组。有关详细信息,请参阅 tall 数组。
基于线程的环境
使用 MATLAB® backgroundPool
在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool
加快代码运行速度。
此函数完全支持基于线程的环境。有关详细信息,请参阅在基于线程的环境中运行 MATLAB 函数。
分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。
此函数完全支持分布式数组。有关详细信息,请参阅Run MATLAB Functions with Distributed Arrays (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
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)