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

Retorna uma Variante (Inteiro) que contém a parte especificada de uma determinada data.

Aviso    Há um problema com o uso dessa função. A última segunda-feira em alguns anos calendários pode ser retornada como semana 53, quando deve ser a semana 1. Para obter mais informações e uma solução alternativa, consulte Formato ou funções DatePart podem retornar o número da semana errada para a última segunda-feira no ano.

Sintaxe

DatePart ( interval, date [, firstdayofweek] [, firstweekofyear] )

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

Argumento

Descrição

intervalo

Obrigatório. Expressão de cadeia de caracteres que é o intervalo de tempo que você deseja retornar.

data

Obrigatório. Valor variant (Data) que você deseja avaliar.

primeirodiadasemana

Opcional. Um constante que especifica o primeiro dia da semana. Se não especificado, será usado o domingo.

primeirasemanadoano

Opcional. Uma constante que especifica a primeira semana do ano. Se não especificado, será usada a semana em que ocorre 1 de janeiro.

Configurações

O argumento de intervalo tem essas configurações:

Configuração

Descrição

aaaa

Ano

q

Trimestre

m

Mês

nte misturada,

Dia do ano

d

Dia

w

Dia da semana

ss

Semana

h

Hora

n

Minuto

a a

Segundo

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

O argumento firstweekofyear tem estas configurações:

Constante

Valor

Descrição

vbUseSystem

0

Use a configuração da API NLS.

vbFirstJan1

1

Comece com a semana em que ocorre 1º de janeiro (padrão).

vbFirstFourDays

2

Comece com a primeira semana que tem pelo menos quatro dias no ano novo.

vbFirstFullWeek

3

Comece com a primeira semana completa do ano.

Comentários

Você pode usar a função DatePart para avaliar uma data e retornar um intervalo de tempo específico. Por exemplo, você pode usar DatePart para calcular o dia da semana ou a hora atual.

O argumento firstdayofweek afeta cálculos que usam os símbolos de intervalo "w" e "ww".

Se date for um literal de data, o ano especificado se tornará uma parte permanente dessa data. No entanto, se a data estiver entre aspas duplas (" "), e você omitir o ano, o ano atual será inserido em seu código sempre que a expressão de data for avaliada. Isso torna possível gravar um código que pode ser usado em anos diferentes.

Observação: Para a data, se a configuração da propriedade Calendar for gregoriana, a data fornecida deverá ser gregoriana. Se o calendário for Hijri, a data fornecida deverá ser Hijri.

A parte de data retornada está nas unidades de período de tempo do calendário árabe atual. Por exemplo, se o calendário atual for Hijri e a parte de data a ser retornada for o ano, o valor do ano será um ano Hijri.

Exemplos de consulta

Expressão

Resultados

SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales;

Retorna o 'Ano' dos valores de data do campo "DateofSale".

SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales;

Retorna o 'Quarter' (com base no ano de calender) dos valores de data do campo "DateofSale".

SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales;

Retorna o "Dia do Ano" (1 a 365) dos valores de data do campo "DateofSale".

SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales;

Retorna o "Dia" dos valores de data do campo "DateofSale".

SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales;

Retorna o "Dia da Semana" (de 1 a 7, onde 1 representa domingo) dos valores de data do campo "DateofSale".

SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales;

Retorna o "número da semana" (de 1 a 52) dos valores de data do campo "DateofSale".

SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales;

Retorna a 'Hora' dos valores de data do campo "DateTime".

SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales;

Retorna o 'Minutos' dos valores de data do campo "DateTime".

SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales;

Retorna os "segundos" dos valores de data do campo "DateTime".

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 uma data e, usando a função DatePart , exibe o trimestre do ano em que ela ocorre.

Dim TheDate As Date    ' Declare variables.Dim Msg    TheDate = InputBox("Enter a date:")Msg = "Quarter: " & DatePart("q", TheDate)MsgBox Msg

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.