DatePart

Devolve a parte especificada de uma determinada data.

Estrutura

DatePart(intervalo, data[, primeiro dia da semana[, primeira semana do ano]])

Parâmetros

intervalo - obrigatório. Expressão de cadeia de caracteres que corresponde ao intervalo de tempo que pretende devolver. Consulte a secção «Definições» para ver os valores.

data - obrigatório. Expressão de data que pretende avaliar.

primeiro dia da semana - opcional. Constante que especifica o dia da semana. Se não for especificado, considera-se que é domingo. Consulte a secção «Definições» para ver os valores.

primeira semana do ano - opcional. Constante que especifica a primeira semana do ano. Se não for especificado, presume-se que a primeira semana é aquela em que ocorre o dia 1 de janeiro.

Valores dos parâmetros

O argumento «interval» pode assumir os seguintes valores:

Descrição da configuração

aaaa Ano

q Trimestre

m Mês

Dia do ano

Dia D

w Dia da semana

Semana do ano

h Hora

n minutos

o segundo

O argumento «firstdayofweek» pode assumir os seguintes valores:

Descrição do valor constante

vbUseSystemDayOfWeek 0 Utilizar a configuração da API de Suporte a Idiomas Nacionais (NLS).

vbDomingo 1 Domingo (padrão)

Segunda-feira, 2 de fevereiro

vbTerça-feira 3 Terça-feira

Quarta-feira, 4 de março

vbQuinta-feira 5 Quinta-feira

vbSexta-feira, 6 de sexta-feira

Sábado, 7 de sábado

O argumento «primeira semana do ano» pode assumir os seguintes valores:

Descrição do valor constante

vbUseSystem 0 Utilizar a configuração da API de Suporte a Idiomas Nacionais (NLS).

vbFirstJan1 1 Começa pela semana em que se insere o dia 1 de janeiro (padrão).

vbFirstFourDays 2 Começa pela semana que tenha pelo menos quatro dias no ano novo.

vbFirstFullWeek 3 Começa com a primeira semana completa do ano novo.

Descrição

Pode utilizar a função DatePart para analisar uma data e obter um intervalo de tempo específico. Por exemplo, pode utilizar o DatePart para calcular o dia da semana ou a hora atual.

O argumento «firstdayofweek» afeta os cálculos que utilizam os símbolos de intervalo «w» e «ww».

Se «date» for um literal de data, o ano especificado torna-se parte integrante dessa data. No entanto, se a data estiver entre aspas (' ') e omitir o ano, o ano atual será inserido no seu código sempre que a expressão de data for avaliada. Isto permite escrever código que pode ser utilizado em diferentes anos.

Exemplo

Este exemplo recebe uma data e, utilizando a função DatePart, apresenta o trimestre do ano em que ela se insere.

Função GetQuarter(TheDate)

GetQuarter = DatePart("q", TheDate)

End Function. |