Devolve uma Variante (Número Inteiro) que contém um número inteiro que representa o dia da semana.
Sintaxe
DiaSemana( data [, primeirodiadasemana ] )
A sintaxe da função DiaSemana tem estes argumentos:
|
Argumento |
Descrição |
|
data |
Obrigatório. A variante, a expressão numérica, a expressão de cadeia ou qualquer combinação destes valores pode representar uma data. Se data contiver Nulo, será devolvido Nulo. |
|
primeirodiadasemana |
Opcional. Uma constante que especifica o primeiro dia da semana. Se não for especificado, assume-se a constante vbSunday. |
Definições
O argumento primeirodiadasemana tem as seguintes definições:
|
Constante |
Valor |
Descrição |
|
vbUseSystem |
0 |
Utilizar a definição NLS API. |
|
vbSunday |
1 |
Domingo (predefiniçã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 Devolvidos
A função DiaSemana pode devolver qualquer um destes 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 |
Observações
Se a definição da propriedade Calendário for Gregoriano, o valor inteiro devolvido representa o dia da semana do calendário Gregoriano para o argumento de data. Se o calendário for Hijiri, o valor inteiro devolvido representa o dia da semana do calendário Hijiri para o argumento de data. Para datas de calendário Hijiri, o número de argumento é qualquer expressão numérica que possa representar uma data e/ou hora de 1/1/100 (2 de agosto de 718 do calendário Gregoriano) até 4/3/9666 (31 de dezembro de 9999 do calendário Gregoriano).
Exemplos de consulta
|
Expressão |
Resultados |
|
SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; |
Devolve os valores do campo "DateofSale" e o número que representa o "Dia da Semana" destes valores de data. (Por predefinição, domingo é considerado o primeiro dia da semana; 1). |
|
SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; |
Devolve os valores do campo "DateofSale" e o número que representa o "Dia da Semana" destes valores de data. (considerando segunda-feira como primeiro dia da semana). |
Exemplo de VBA
Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.
Este exemplo utiliza a função DiaSemana 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.
