day

日期和时间输入的日期值或日期名称

全页折叠

语法

d = day(t)
d = day(t,dayType)

说明

d = day(t) 返回与输入数组中每个日期和时间对应的日期值。默认情况下，day 返回一个月中某天的日期数字，该数字与输入 datetime 数组 t 的元素相对应。

输出 d 是一个 double 数组，其中包含从 1 到 31 的整数值，具体取决于月和年。要将日期值赋给 datetime 数组 t，可使用 t.Day 并修改 Day 属性。

示例

d = day(t,dayType) 返回 datetime 数组 t 的日期值类型或名称，指定为 "dayofmonth"、"dayofweek"、"dayofyear"、"name" 或 "shortname"。

示例

示例

全部折叠

打开实时脚本

从日期数组中提取一个月中日期值。

t = [datetime('yesterday');datetime('today');datetime('tomorrow')]
t = 3×1 datetime
   12-Jul-2025
   13-Jul-2025
   14-Jul-2025


d = day(t)
d = 3×1

    12
    13
    14
打开实时脚本

通过将 'name' 指定为 day 函数的第二个输入确定任意日期是星期几。

t = datetime(2014,05,16)
t = datetime
   16-May-2014


d = day(t,'name')
d = 1×1 cell array
    {'Friday'}

或者，指定 'dayofweek' 以数值形式返回星期几。

d = day(t,'dayofweek')
d = 
6

输入参数

全部折叠

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

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

日期值的类型，指定为表中的某个值。

dayType 的值

描述

'dayofmonth'（默认值）

月中日期值，从 1 到 28、29、30 或 31。范围取决于月。

'dayofweek'

周中日期值，从 1 到 7，其中一周的第 1 天是周日。

'iso-dayofweek' (自 R2023a 起)

周中日期值，从 1 到 7，根据 ISO 8601 标准，其中一周的第 1 天是星期一。

'dayofyear'

年中日期值，从 1 到 365 或 366，具体取决于年。

'name'

完整日期名称，例如 Sunday。对于 NaT 日期时间值，其名称为空字符向量 ''。

'shortname'

缩写的星期几名称，例如 Sun。对于 NaT 日期时间值，其名称为空字符向量 ''。

注意

day 返回以指定语言显示的日期名称，该语言通过“设置”窗口中的日期时间格式部分中的区域设置选项指定。要更改默认的日期时间区域设置，请参阅Modify Command Window Settings。

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

输出参量

全部折叠

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

扩展功能

全部展开

版本历史记录

在 R2014b 中推出

全部展开

另请参阅

| | | | | |