Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

day

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

说明

示例

d = day(t) 返回在 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 = 3x1 datetime
   18-Aug-2023
   19-Aug-2023
   20-Aug-2023

d = day(t)
d = 3×1

    18
    19
    20

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

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

d = day(t,'name')
d = 1x1 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 返回以指定语言显示的日期名称,该语言通过预设项窗口中的日期时间格式部分中的区域设置选项指定。要更改默认的日期时间区域设置,请参阅设置命令行窗口预设项

仅当 tdatetime 数组时,此参数才有效。

输出参数

全部折叠

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

扩展功能

版本历史记录

在 R2014b 中推出

全部展开

另请参阅

| | | | | |