Compartilhar via


Função dia da semana (Visual Basic) 

Retorna um valor Integer contendo um número que representa o dia da semana.

Public Function Weekday( _
   ByVal DateValue As DateTime, _
   Optional ByVal DayOfWeek As FirstDayOfWeek = FirstDayOfWeek.Sunday _
) As Integer

Parâmetros

  • DateValue
    Obrigatório.Date valor para o qual você deseja determinar o dia da semana.

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

Configurações

O argumento DayOfWeek pode ter uma das seguintes configurações.

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 (compatível com padrão 8601, Seção 3.17 ISO)

FirstDayOfWeek.Tuesday

3

Terça-feira

FirstDayOfWeek.Wednesday

4

Quarta-feira

FirstDayOfWeek.Thursday

5

Quinta-feira

FirstDayOfWeek.Friday

6

Sexta-feira

FirstDayOfWeek.Saturday

7

Sábado

Exceções

Tipo de exceção

Número de erro

Condição

ArgumentException

5

DayOfWeek é menor que 0 ou maior que 7.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

O valor retornado pela função Weekday é o dia da semana que que o DateValue corresponde a, relativo ao primeiro dia da semana definido pelo valor DayOfWeek.Por exemplo, se a data se refere a uma Quarta e o primeiro dia da semana é especificado como Segunda, a função retorna 3.

Observação:

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

Exemplo

Este exemplo usa a função Weekday 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.

Requisitos

Namespace:Microsoft.VisualBasic

**Módulo:**DateAndTime

**Assembly:**Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Referência

Função Day (Visual Basic)

Função Mês (Visual Basic)

Propriedade agora

Função WeekdayName (Visual Basic)

Função de ano (Visual Basic)

Função DatePart (Visual Basic)

DateTime