Applies ToAccess para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

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, MyWeekDayMyDate = #February 12, 1969#    ' Assign a date.MyWeekDay = Weekday(MyDate)    ' MyWeekDay contains 4 because ' MyDate represents a Wednesday.

Escolher a função de data correta

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.