Функция WeekdayName (Visual Basic)

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает значение типа 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, зависит не только от входных аргументов, но и от Regional Options, заданных в Windows Control Panel.

Примечание.
WeekdayName использует текущую настройку календаря из свойства CurrentCulture класса CultureInfo в пространстве имен System.Globalization. По умолчанию значения CurrentCulture определяются настройками Control Panel.

Пример

В следующем примере используется функция Weekday для получения дня недели по заданной дате и WeekDayName для получения названия дня недели по его номеру.

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