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

Retorna uma Variante (Inteiro) que contém um número inteiro representando o dia da semana.

Sintaxe

Dia da semana ( data [, primeiro dia da semana ] )

A sintaxe da função Weekday tem esses argumentos:

Argumento

Descrição

data

Obrigatório. Variant, expressão numérica, expressão de cadeia de caracteres ou qualquer combinação delas 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 retornados

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 representa o dia gregoriano da semana para o argumento de data. Se o calendário for Hijri, o inteiro retornado representará o dia hijri da semana para o argumento de data. 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 (gregoriano 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 "Dia da Semana" desses valores de data. (Por padrã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 "Dia da Semana" desses valores de data. (considerando segunda-feira como primeiro dia da semana).

Exemplo de VBA

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo VBA (Visual Basic for Applications). 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, MyWeekDayMyDate = #February 12, 1969#    ' Assign a date.MyWeekDay = Weekday(MyDate)    ' MyWeekDay contains 4 because ' MyDate represents a Wednesday.

Escolher a função de data certa

Precisa de mais ajuda?

Quer mais opções

Explore os benefícios da assinatura, procure cursos de treinamento, saiba como proteger seu dispositivo e muito mais.

As comunidades ajudam você a fazer e responder perguntas, fazer comentários e ouvir especialistas com conhecimento avançado.