hour

日期时间输入的小时分量

语法

h = hour(t)

说明

h = hour(t) 返回在 t 中指定的每个日期时间的小时分量。

h 输出是 double 数组，并且包含从 0 到 23 的整数值。要对 t 中各值的小时分量赋值，请使用 t.Hour 并修改 Hour 属性。

示例

求日期时间值的小时数

t = datetime('today'):hours(8):datetime('tomorrow');
t.Format = 'MMM dd, HH:mm'

t = 1x4 datetime
   Feb 13, 00:00   Feb 13, 08:00   Feb 13, 16:00   Feb 14, 00:00

h = hour(t)

h = 1×4

     0     8    16     0

输入参数

t — 日期时间输入

datetime 数组

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

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

扩展功能

tall 数组

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

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

C/C++ 代码生成

使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

• 在生成的代码中，此函数仅支持 datetime 数组作为输入。您不能在生成的代码中指定日期序列值或文本作为输入。

基于线程的环境

使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

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

分布式数组

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

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

版本历史记录

在 R2014b 中推出

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

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

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

t = datetime(738427.656845093,"ConvertFrom","datenum");
h = hour(t)

h =

    15

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

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

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

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

h = hour(738427.656845093)

h =

    15

h = hour("2021/09/28 15:45:51.4160")

h =

    15

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

h = hour(t,F)

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

h = hour("2021/09/28 15:45:51.4160","yyyy/dd/mm hh:MM:ss.fff")

h =

    15

另请参阅

minute | second | timeofday | hms