quarter

日期和时间输入的季度值

全页折叠

语法

q = quarter(t)

说明

q = quarter(t) 返回在 t 中指定的每个日期和时间的季度值。

q 输出是 double 数组，包含从 1 到 4 的整数值。

示例

全部折叠

求出日期的季度值

打开实时脚本

t = datetime(2013,05,31):calmonths(3):datetime(2014,05,31)

t = 1×5 datetime
   31-May-2013   31-Aug-2013   30-Nov-2013   28-Feb-2014   31-May-2014

q = quarter(t)

q = 1×5

     2     3     4     1     2

输入参数

全部折叠

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

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

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

扩展功能

全部展开

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

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

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

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

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

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

版本历史记录

在 R2014b 中推出

全部展开

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

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

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

t = datetime(738427.656845093,"ConvertFrom","datenum");
q = quarter(t)

q =

     3

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

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

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

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

q = quarter(738427.656845093)

q =

     3

q = quarter("28-Sep-2021")

q =

     3

非标准日历和日期格式

此外，当第一个输入不是 datetime 数组时，quarter 还接受另外两个输入。您可以将第二个输入指定为所用财务日历的第一个月 (month1)。您还可以指定表示日期格式的第三个输入 (F)。

q = quarter(t,month1)
q = quarter(t,month1,F)

要基于不同于常规的财务日历确定 t 的季度，请将 month1 指定为 1 - 12 之间的一个整数（对应于从 1 月到 12 月的月份）。例如，如果日历的财年是从 10 月 1 日开始，请将 month1 指定为 10。

q = quarter("2021/28/09",10)

q =

     4

要使用特定的日期格式解释 t，请使用 datestr 函数文档中的有效日期格式指定 F，但尚不支持 'Q' 格式设定符。例如：

q = quarter("2021/28/09",1,"yyyy/dd/mm")

q =

     3

另请参阅

year | month | week | day