Função DatePart

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

Sintaxe

PartData ( intervalo, data [, FirstDayOfWeek] [, primeirasemanadoano] )

A sintaxe da função PartData tem os seguintes 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. Variante (Date) valor 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 intervaloargumento tem as seguintes configurações:

Configuração

Descrição

aaaa

Ano

q

Trimestre

m

Mês

y

Dia do ano

d

Dia

w

Dia da semana

ss

Semana

h

Hora

n

Minuto

s

Segundo

O argumento FirstDayOfWeek tem as seguintes 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 primeirasemanadoano tem as seguintes configurações:

Constante

Valor

Descrição

vbUseSystem

0

Use a configuração da API NLS.

vbFirstJan1

1

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

vbFirstFourDays

2

Comece com a primeira semana que tenha 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 PartData 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 os cálculos que usam os símbolos de intervalo "w" e "WW".

Se dao ote for uma literal de data, o ano especificado se tornará uma parte permanente da data. No entanto, se a Data estiver entre aspas duplas ("") e você omitir o ano, o ano atual será inserido no seu código toda vez que a expressão de Data for avaliada. Isso torna possível escrever código que pode ser usado em diferentes anos.

Observação: Para Data, se a configuração da propriedade calendário for Gregoriano, a data fornecida deverá ser Gregoriana. Se o calendário for islâmico, a data fornecida deverá ser islâmica.

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

Exemplos de consulta

Expressão

Resultados

Selecione DatePart ("yyyy", [DateofSale]) como NewDate de ProductSales;

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

Selecione DatePart ("t", [DateofSale]) como NewDate de ProductSales;

Retorna o ' trimestre ' (com base no ano do calendário) dos valores de data do campo "DateofSale".

Selecione PartData ("y", [DateofSale]) como NewDate de ProductSales;

Retorna o ' dia do ano ' (1 a 365) dos valores de data do campo "DateofSale".

Selecione DatePart ("d", [DateofSale]) como NewDate de ProductSales;

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

Selecione PartData ("w", [DateofSale]) como NewDate de ProductSales;

Retorna o ' Weekday ' (de 1 a 7 onde 1 representa domingo) dos valores de data do campo "DateofSale".

Selecione PartData ("SS", [DateofSale]) como NewDate de ProductSales;

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

Selecione DatePart ("h", [datahora]) como NewDate da ProductSales;

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

Selecione DatePart ("n", [datahora]) como NewDate da ProductSales;

Retorna os ' minutos ' dos valores de data do campo "DateTime".

Selecione DatePart ("s", [datahora]) como NewDate da 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 do Visual Basic for Applications (VBA). 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 assume uma data e, usando a função PartData , exibe o trimestre do ano em que ele ocorre.

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

Observação:  Esta página foi traduzida automaticamente e pode apresentar erros gramaticais ou imprecisões. Nosso objetivo é que este conteúdo seja útil para você. Você pode nos dizer se as informações foram úteis? Use o artigo em inglês como referência.​

Consulte Também

Escolher a função de data certa

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×