month

日期时间输入的月份值或名称

全页折叠

语法

m = month(t)

m = month(t,monthType)

说明

示例

m = month(t) 返回在 t 中指定的每个日期时间的月份值。

m 输出是 double 数组，包含从 1 到 12 的整数值。要将月份值赋给 datetime 数组 t，可使用 t.Month 并修改 Month 属性。

示例

m = month(t,monthType) 返回 datetime 数组 t 的月份值类型或名称，指定为 "monthofyear"、"name" 或 "shortname"。

示例

全部折叠

从日期中提取月份值

打开实时脚本

从日期数组中提取月份值。

t = datetime(2014,05,31):caldays(35):datetime(2014,10,15)

t = 1x4 datetime
   31-May-2014   05-Jul-2014   09-Aug-2014   13-Sep-2014

m = month(t)

m = 1×4

     5     7     8     9

查找日期的月份名称

打开实时脚本

从日期数组中获取月份名称。

t = datetime(2013,01,01):calweeks(12):datetime(2013,12,31)

t = 1x5 datetime
   01-Jan-2013   26-Mar-2013   18-Jun-2013   10-Sep-2013   03-Dec-2013

m = month(t,'name')

m = 1x5 cell
    {'January'}    {'March'}    {'June'}    {'September'}    {'December'}

输入参数

全部折叠

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

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

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

`monthType` — 月份值的类型
`'monthofyear'` （默认） | `'name'` | `'shortname'`

月份值的类型，指定为下表中的某个值。

`monthType` 的值	描述
`'monthofyear'`	年中月份值
`'name'`	完整月份名称，例如 `August` 或 `September`。对于 `NaT` 日期时间值，月份的名称为空字符向量 `''`。
`'shortname'`	缩写的月份名称，例如 `Aug` 或 `Sep`。对于 `NaT` 日期时间值，月份的名称为空字符向量 `''`。

注意

month 返回以指定语言显示的月份名称，该语言通过预设项窗口中的日期时间格式部分的区域设置选项指定。要更改默认的日期时间区域设置，请参阅设置命令行窗口预设项。

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

输出参数

全部折叠

`m` — 月份值或名称
`double` 数组 | 字符向量元胞数组

月份值或名称，以 double 类型的数值数组或字符向量元胞数组形式返回。m 的大小与 t 相同。

扩展功能

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

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

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

此函数完全支持基于线程的环境。有关详细信息，请参阅Run MATLAB Functions in Thread-Based Environment。

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

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

版本历史记录

在 R2014b 中推出

全部展开

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

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

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

t = datetime(738427.656845093,"ConvertFrom","datenum");
m = month(t)

m =

     9

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

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

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

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

m = month(738427.656845093)

m =

     9

m = month("28-Sep-2021")

m =

     9

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

m = month(t,F)

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

m = month("2021/28/09","yyyy/dd/mm")

m =

     9

另请参阅

month

语法

说明

示例

从日期中提取月份值

查找日期的月份名称

输入参数

t — 日期时间输入 datetime 数组

monthType — 月份值的类型 'monthofyear' （默认） | 'name' | 'shortname'

输出参数

m — 月份值或名称 double 数组 | 字符向量元胞数组

扩展功能

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

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

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

版本历史记录

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

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

另请参阅

WeChat

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

`monthType` — 月份值的类型
`'monthofyear'` （默认） | `'name'` | `'shortname'`

`m` — 月份值或名称
`double` 数组 | 字符向量元胞数组

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

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

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

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