DateAndTime.Weekday(DateTime, FirstDayOfWeek) Método

Definição

Retorna um valor inteiro que contém um número que representa o dia da semana.

public static int Weekday (DateTime DateValue, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday);
static member Weekday : DateTime * Microsoft.VisualBasic.FirstDayOfWeek -> int
Public Function Weekday (DateValue As DateTime, Optional DayOfWeek As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday) As Integer

Parâmetros

DateValue
DateTime

Obrigatórios. Um valor Date para o qual você deseja determinar o dia da semana.

DayOfWeek
FirstDayOfWeek

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

Retornos

Um valor inteiro que contém um número que representa o dia da semana.

Exceções

DayOfWeek é 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.

Dim oldDate As Date
Dim oldWeekDay As Integer
oldDate = #2/12/1969#
oldWeekDay = Weekday(oldDate)
' oldWeekDay now contains 4 because thisDate represents a Wednesday.

Comentários

O valor retornado pela Weekday função corresponde aos valores da FirstDayOfWeek enumeração; ou seja, 1 indica domingo e 7 indica sábado.

Observação

Weekday 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 DayOfWeek 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
FirstDayOfWeek.Sunday 1 Domingo (padrão)
FirstDayOfWeek.Monday 2 Segunda-feira (está em conformidade com o ISO standard 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