Função dia da semana
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.