Main Content

weekday

星期几

说明

DayNumber = weekday(D) 返回表示 D 中每个元素的星期几的数字。

示例

[DayNumber,DayName] = weekday(D) 还返回 DayName 中星期几的缩写英语名称。

示例

[DayNumber,DayName] = weekday(D,DayForm)DayForm 指定的格式返回星期几的名称(美国英语形式)。

[DayNumber,DayName] = weekday(D,language)language 中指定的区域设置语言返回星期几的缩写名称。

示例

[DayNumber,DayName] = weekday(D,DayForm,language) 按指定的格式和指定的区域设置语言返回星期几的名称。可以按任一顺序指定 DayFormlanguage

示例

全部折叠

确定 2012 年 12 月 21 日是星期几。

D = '21-Dec-2012';
[DayNumber,DayName] = weekday(D)
DayNumber = 6
DayName = 
'Fri'

2012 年 12 月 21 日是星期五。

返回一个日期序列值向量的星期几的完整名称。

D = [734999;735015];
DayForm = 'long';
[DayNumber,DayName] = weekday(D,DayForm)
DayNumber = 2×1

     5
     7

DayName = 2x8 char array
    'Thursday'
    'Saturday'

使用 language 输入参数返回以美式英语表示的日期名称。

D = 728647;
DayForm = 'long';
language = 'en_US';
[DayNumber,DayName] = weekday(D,DayForm,language)
DayNumber = 2
DayName = 
'Monday'

在美国英语中,星期几的名称为 Monday

返回以当前区域设置的语言表示的日期名称。

language = 'local';
[DayNumber,DayName] = weekday(D,DayForm,language);

DayName 的值取决于区域设置。例如,在法语区域设置中,星期几的名称为 Lundi

确定按格式 mmm.dd.yyyy 指定的日期的星期几。在 weekday 内调用 datenum 以指定表示日期的输入文本的格式。

[DayNumber,DayName] = weekday(datenum('Dec.21.2012','mmmm.dd.yyyy'))
DayNumber = 6
DayName = 
'Fri'

输入参数

全部折叠

日期序列值或表示日期时间的文本。日期数字可以指定为向量或矩阵。文本可以指定为字符向量、字符向量元胞数组、字符串数组或字符数组(其中每行表示一个日期)。如果 D 为字符向量元胞数组或字符串数组,则它必须为 1×nn×1 的大小。

如果 D 为字符向量、字符向量元胞数组、字符串数组或字符数组,则日期可以为下列格式之一。

日期格式示例
dd-mmm-yyyy01-Mar-2000
mm/dd/yyyy03/01/2000
yyyy-mm-dd2000-03-01

对于其他格式的表示日期的文本,首先使用 datenum 函数将日期转换为日期序列值,然后将其传递给 weekday

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | char | cell | string

输出日期名称的格式,指定为下列值之一。

DayFormDayName 名称的格式示例
'short'缩写名称Mon
'long'完整名称 Monday

DayName 中日期名称的输出语言,指定为下列值之一。

language描述
'en_US'美国英语
'local'当前区域设置的语言

输出参数

全部折叠

表示星期几的值,返回为范围 [1,7] 中的整数数组,其中 1 表示星期日,7 表示星期六。

  • 如果输入 D 为数值数组,则 DayNumber 的大小与 D 的大小相同。

  • 如果输入 D 为字符向量元胞数组,则 DayNumberm×1 向量,其中 mD 的长度相同。

星期几的名称,返回为字符数组。DayName 的内容取决于 DayForm

  • 如果 DayForm'short',则 DayName 包含一个缩写名称(例如 Tues)。

  • 如果 DayForm'long',则 DayName 包含星期几的完整名称(例如 Tuesday)。

DayName 是一个 m×n 矩阵,其中 mD 中表示的日期数。

扩展功能

版本历史记录

在 R2006a 之前推出

另请参阅

| |