Função Weekday

Retorna uma Variante (Inteiro) contendo um número inteiro que representa o dia da semana.

Sintaxe

Weekday(date, [ firstdayofweek ])

A sintaxe da função Weekday tem estes argumentos nomeados:

Sair Descrição
data Obrigatório. Variante, expressão numérica, expressão de cadeia de caracteres ou qualquer combinação que possa representar uma data. Se date contiver Null, Null será retornado.
primeirodiadasemana Opcional. Uma constante que especifica o primeiro dia da semana. Se não for especificado, vbSunday será assumido.

Configurações

O argumento primeirodiadasemana tem as seguintes configurações:

Constante Valor Descrição
vbUseSystem 0 Use a configuração da API NLS.
vbSunday 1 Domingo (padrão)
vbMonday 2 Segunda-feira
vbTuesday 3 Terça-feira
vbWednesday 4 Quarta-feira
vbThursday 5 Quinta-feira
vbFriday 6 Sexta-feira
vbSaturday 7 Sábado

Valores de retorno

A função Weekday pode retornar qualquer um destes valores:

Constant Valor Descrição
vbSunday 1 Domingo
vbMonday 2 Segunda-feira
vbTuesday 3 Terça-feira
vbWednesday 4 Quarta-feira
vbThursday 5 Quinta-feira
vbFriday 6 Sexta-feira
vbSaturday 7 Sábado

Comentários

Se a configuração da propriedade Calendar for gregoriano, o inteiro retornado representará o dia da semana gregoriano para o argumento de data.

Se o calendário for islâmico, o inteiro retornado representará o dia da semana islâmico para o argumento de data. Para datas islâmicas, o número do argumento é qualquer expressão numérica que pode representar uma data e/ou hora de 1/1/100 (gregoriano 2 de agosto de 718) a 4/3/9666 (gregoriano 31 de dezembro de 9999).

Exemplo

Este exemplo usa a função Weekday para obter o dia da semana de uma data especificada.

Dim MyDate, MyWeekDay
MyDate = #February 12, 1969#    ' Assign a date.
MyWeekDay = Weekday(MyDate)    ' MyWeekDay contains 4 because 
    ' MyDate represents a Wednesday.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.