DateAndTime.Weekday(DateTime, FirstDayOfWeek) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

DateAndTime.vb

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

Int32

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

Exceções

ArgumentException

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

Confira também

• Day(DateTime)
• Month(DateTime)
• Now
• WeekdayName(Int32, Boolean, FirstDayOfWeek)
• Year(DateTime)
• DatePart
• DateTime