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 estes argumentos:
|
Argumento |
Descrição |
|
data |
Obrigatório. Variant, expressão numérica, expressão de cadeia de caracteres, ou qualquer combinação dessas que possa representar uma data. Se a data contiver Null, Null será retornado. |
|
primeirodiadasemana |
Opcional. Um 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 |
|
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:
|
Constante |
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 representará o dia gregoriano da semana para o argumento date. Se o calendário for Hijri, o inteiro retornado representará o dia hijri da semana para o argumento date. Para datas Hijri, o número do argumento é qualquer expressão numérica que possa representar uma data e/ou hora de 1/1/100 (2 de agosto de 718) a 3/4/9666 (31 de dezembro de 9999).
Exemplos de consulta
|
Expressão |
Resultados |
|
SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; |
Retorna os valores do campo "DateofSale" e o número que representa o "Weekday" 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 "DateofSale" e o número que representa o "Weekday" desses valores de data. (considerando segunda-feira como o primeiro dia da semana). |
Exemplo do VBA
Observação: Exemplos a seguir demonstram o uso dessa função em um módulo Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Desenvolvedor na listada 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.
