2026a

# weekday

星期几

函数库: TyBase

# 语法

DayNumber = weekday(D)
DayNumber,DayName = weekday(D)
DayNumber,DayName = weekday(D,DayForm)
DayNumber,DayName = weekday(D,language)
DayNumber,DayName = weekday(D,DayForm,language)

# 说明

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) 按指定的格式和指定的区域设置语言返回星期几的名称。可以按任一顺序指定 DayForm 和 language。示例

# 示例

返回日期字符串的星期几

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

using TyBase
D = Date("21-Dec-2012", "dd-uuu-yyyy")
DayNumber, DayName = weekday(D)

DayNumber = 5
DayName = "Fri"

2012 年 12 月 21 日是星期五。

返回多个日期数字的完整日期名称

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

using TyBase
D = [734999; 735015];
DayForm = "long";
DayNumber, DayName = weekday(D, DayForm)

DayNumber =  
2-element Vector{Int64}:
 4
 6
DayName =  
2-element Vector{String}:
 "Thursday"
 "Saturday"

返回以本地语言表示的完整日期名称

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

using TyBase
D = 728647;
DayForm = "long";
language = "en_US";
DayNumber, DayName = weekday(D, DayForm, language)

DayNumber = 1
DayName = "Monday"

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

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

language = "local";
DayNumber, DayName = weekday(D, DayForm, language)

DayNumber = 1
DayName = "星期一"

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

返回以自定义格式表示的日期字符串的星期几

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

using TyBase
DayNumber, DayName = weekday(Date("Dec.21.2012", "uuu.dd.yyyy"))

DayNumber = 5
DayName = "Fri"

# 输入参数

D - 日期序列值或表示日期和时间的文本

向量 | 矩阵 | 字符向量 | 字符串数组 | 字符数组

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

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

日期格式	示例
dd-uuu-yyyy	01-Mar-2000
mm/dd/yyyy	03/01/2000
yyyy-mm-dd	2000-03-01

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

DayForm - 输出日期名称的格式

"short" （默认） | "long"

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

DayForm	DayName名称的格式	示例
"short"	缩写名称	Mon
"long"	完整名称	Monday

language - 日期名称的输出语言

"en_US" （默认） | "local"

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

language	说明
"en_US"	美国英语
"local"	当前区域设置的语言

# 输出参数

DayNumber - 表示星期几的值

范围 [1,7] 中的整数数组

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

DayNumber 的大小与 D 的大小相同。

DayName - 星期几的名称

字符数组

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

如果 DayForm 为 'short'，则 DayName 包含一个缩写名称（例如 Tues）。
如果 DayForm 为 'long'，则 DayName 包含星期几的完整名称（例如 Tuesday）。

DayName 的大小与 D 的大小相同。

# 另请参阅

datenum | datevec | eomday