WeekdayName 函数 (Visual Basic)

项目
08/18/2008

更新：2007 年 11 月

返回一个 String 值，该值包含指定工作日的名称。

Public Function WeekdayName( _
   ByVal Weekday As Integer, _
   Optional ByVal Abbreviate As Boolean = False, _
   Optional ByVal FirstDayOfWeekValue As FirstDayOfWeek = FirstDayOfWeek.System _
) As String

参数

Weekday
必选。数据类型为 Integer。星期几的数字表示形式，范围是 1 到 7；1 表示某周的第一天，7 表示某周的最后一天。第一天和最后一天指的是哪一天取决于 FirstDayOfWeekValue 的设置。
Abbreviate
可选。Boolean 值，表示是否缩写星期几的名称。如果省略，则默认为 False，表示星期几的名称不缩写。
FirstDayOfWeekValue
可选。选自 FirstDayOfWeek 枚举的值，用于指定一周的第一天。如果未指定，则使用 FirstDayOfWeek.System。

设置

FirstDayOfWeekValue 参数可以有以下设置之一。

枚举值	值	说明
FirstDayOfWeek.System	0	系统设置中指定的周的第一天（默认）
FirstDayOfWeek.Sunday	1	星期日
FirstDayOfWeek.Monday	2	星期一（依照 ISO 8601 标准第 3.17 节）
FirstDayOfWeek.Tuesday	3	星期二
FirstDayOfWeek.Wednesday	4	星期三
FirstDayOfWeek.Thursday	5	星期四
FirstDayOfWeek.Friday	6	星期五
FirstDayOfWeek.Saturday	7	星期六

异常

异常类型	错误号	条件
ArgumentException	5	Weekday 小于 1 或大于 7，或 FirstDayOfWeekValue 小于 0 或大于 7。

如果正在升级使用非结构化错误处理方式的 Visual Basic 6.0 应用程序，请参见“错误号”一列。（您可以根据 Number 属性（Err 对象）比较错误号。）然而，如果可能，应当考虑用 Visual Basic 的结构化异常处理概述替换这种错误控制。

备注

WeekdayName 所返回的字符串不仅取决于输入参数，也取决于 Windows“控制面板”中指定的“区域选项”设置。

说明：
WeekdayName 使用 System.Globalization 命名空间中的 CultureInfo 类的 CurrentCulture 属性的当前日历设置。默认 CurrentCulture 值由“控制面板”设置决定。

示例

下面的示例使用 Weekday 函数获得指定的日期是星期几，然后使用 WeekDayName 函数根据其序号获得星期几的名称。

Dim oldDate As Date
Dim oldWeekDayName As String
oldDate = #2/12/1969#
oldWeekDayName = WeekdayName(Weekday(oldDate))
' oldWeekDayName now contains "Wednesday".