Retorna uma Variante (Inteiro) que contém um número inteiro representando o dia da semana.
Sintaxe
Weekday(date [, firstdayofweek ] )
A sintaxe da função Weekday tem os seguintes argumentos:
| Argumento | Descrição |
|---|---|
| de data | Obrigatório. Variante, expressão numérica, expressão de cadeia de caracteres ou qualquer combinação delas 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 firstdayofweek tem estas configurações:
| Constante | Valor | Descrição |
|---|---|---|
| vbUseSystem | 0 | Use a configuração da API NLS. |
| vbSunday | 1 | Domingo (padrão) |
| vbMonday | 2 | Segunda-feira |
| vbTerça-feira | 3 | Terça-feira |
| vbQuarta-feira | 4 | Quarta-feira |
| vbQuinta-feira | 5 | Quinta-feira |
| vbFriday | 6 | Sexta-feira |
| vbSábado | 7 | Sábado |
Valores retornados
A função Weekday pode retornar qualquer um destes valores:
| Constante | Valor | Descrição |
|---|---|---|
| vbSunday | 1 | Domingo |
| vbMonday | 2 | Segunda-feira |
| vbTerça-feira | 3 | Terça-feira |
| vbQuarta-feira | 4 | Quarta-feira |
| vbQuinta-feira | 5 | Quinta-feira |
| vbFriday | 6 | Sexta-feira |
| vbSábado | 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).
Exemplos de consulta
| Expressão. | Resultados |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | Retorna os valores do campo "DatadeVenda" e o número que representa o 'Dia da semana' desses valores de data. (Por padrão, o domingo é considerado o primeiro dia da semana; 1). |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | Retorna os valores do campo "DatadeVenda" e o número que representa o 'Dia da semana' desses valores de data. (considerando segunda-feira como primeiro dia da semana). |
Exemplo de VBA
Observação
Os exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.
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.