DateAndTime.WeekdayName(Int32, Boolean, FirstDayOfWeek) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает строковое значение, содержащее название указанного дня недели.
public static string WeekdayName (int Weekday, bool Abbreviate = false, Microsoft.VisualBasic.FirstDayOfWeek FirstDayOfWeekValue = Microsoft.VisualBasic.FirstDayOfWeek.System);
static member WeekdayName : int * bool * Microsoft.VisualBasic.FirstDayOfWeek -> string
Public Function WeekdayName (Weekday As Integer, Optional Abbreviate As Boolean = false, Optional FirstDayOfWeekValue As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.System) As String
Параметры
- Weekday
- Int32
Обязательный. Целое число. Числовое обозначение дня недели со значениями от 1 до 7: 1 обозначает первый день недели, а 7 — последний. Первый и последний дни недели определяются значением параметра FirstDayOfWeekValue
.
- Abbreviate
- Boolean
Необязательный элемент. Значение типа Boolean
, указывающее, должно ли название дня недели быть представлено в сокращенном виде. Если параметр опущен, по умолчанию используется значение False
, определяющее, что имя дня недели представляется не в сокращенном виде.
- FirstDayOfWeekValue
- FirstDayOfWeek
Необязательный элемент. Значение, выбранное из перечисления FirstDayOfWeek, указывающее первый день недели. Если этот параметр не задан, используется значение FirstDayOfWeek.System
.
Возвращаемое значение
Строковое значение, содержащее название указанного дня недели.
Исключения
Weekday
меньше 1 или больше 7 или FirstDayOfWeekValue
меньше 0 или больше 7.
Примеры
В следующем примере функция используется Weekday
для получения дня недели из указанной даты, а затем WeekDayName
функция для получения имени дня недели из его номера.
Dim oldDate As Date
Dim oldWeekDayName As String
oldDate = #2/12/1969#
oldWeekDayName = WeekdayName(Weekday(oldDate))
' oldWeekDayName now contains "Wednesday".
Комментарии
Строка, возвращаемая методом WeekdayName
, зависит не только от входных аргументов, но и от параметров региональных параметров, указанных в панель управления Windows.
Примечание
WeekdayName
использует текущий параметр календаря CurrentCulture из свойства CultureInfo класса в System.Globalization пространстве имен . Значения по умолчанию CurrentCulture определяются панель управления параметрами.
Аргумент 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 | Суббота |