Partilhar via


DateAndTime.WeekdayName(Int32, Boolean, FirstDayOfWeek) Método

Definição

Retorna um valor de cadeia de caracteres que contém o nome do dia da semana especificado.

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

Parâmetros

Weekday
Int32

Obrigatórios. Inteiro. A designação numérica para o dia da semana, de 1 a 7, 1 indica o primeiro dia da semana e 7 indica o último dia da semana. As identidades do primeiro e do último dia dependem da configuração de FirstDayOfWeekValue.

Abbreviate
Boolean

Opcional. O valor Boolean que indicará se o nome do dia da semana deverá ser abreviado. Se for omitido, o padrão será False, que significa que o nome do dia da semana não é abreviado.

FirstDayOfWeekValue
FirstDayOfWeek

Opcional. Um valor escolhido na enumeração de FirstDayOfWeek que especifica o primeiro dia da semana. Se não for especificado, é usado FirstDayOfWeek.System.

Retornos

Um valor de cadeia de caracteres que contém o nome do dia da semana especificado.

Exceções

Weekday é menor que 1 ou maior que 7 ou FirstDayOfWeekValue é menor que 0 ou maior que 7.

Exemplos

O exemplo a seguir usa a Weekday função para obter o dia da semana de uma data especificada e, em seguida, a WeekDayName função para obter o nome do dia da semana de seu número.

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

Comentários

A cadeia de caracteres retornada por WeekdayName depende não apenas dos argumentos de entrada, mas também das configurações de Opções Regionais especificadas no Painel de Controle do Windows.

Observação

WeekdayName usa a configuração de calendário atual da CurrentCulture propriedade da CultureInfo classe no System.Globalization namespace . Os valores padrão CurrentCulture são determinados por Painel de Controle configurações.

O FirstDayOfWeekValue argumento pode ter uma das configurações a seguir.

Valor de enumeração Valor Descrição
FirstDayOfWeek.System 0 Primeiro dia da semana especificado nas configurações do sistema (padrão)
FirstDayOfWeek.Sunday 1 Sunday
FirstDayOfWeek.Monday 2 Segunda-feira (em conformidade com o padrão ISO 8601, seção 3.17)
FirstDayOfWeek.Tuesday 3 Terça-feira
FirstDayOfWeek.Wednesday 4 Quarta-feira
FirstDayOfWeek.Thursday 5 Quinta-feira
FirstDayOfWeek.Friday 6 Friday
FirstDayOfWeek.Saturday 7 Sábado

Aplica-se a

Confira também