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 |
|---|---|---|
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.
.gif "Observação") 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 WeekdayName (Visual Basic)