WeekdayName 函数 (Visual Basic)
更新: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 |
星期六 |
异常
异常类型 |
错误号 |
条件 |
---|---|---|
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".
要求
**模块:**DateAndTime
**程序集:**Visual Basic 运行库(在 Microsoft.VisualBasic.dll 中)