Função dia da semana

  • Artigo

Retorna uma Variant (Inteiro) que contém um número inteiro que representa o dia da semana.

Sintaxe

Dia da semana(data, [ 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 a data 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 desses 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 gregoriana, o inteiro retornado representa o dia gregoriano da semana para o argumento de data.

Se o calendário for Hijri, o inteiro retornado representa o dia hijri da semana para o argumento de data. Para datas hijri, o número de argumento é qualquer expressão numérica que possa representar uma data e/ou hora de 1/1/100 (gregoriano 2 de agosto de 718) a 3/4/9666 (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.