Ler em inglês

Partilhar via


DateAndTime.Weekday(DateTime, FirstDayOfWeek) Método

Definição

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

C#
public static int Weekday (DateTime DateValue, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday);

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.

VB
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.

Nota

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

Produto Versões
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também