Função DatePart

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

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

Sintaxe

DatePart ( intervalo, data [, primeirodiadasemana] [, primeirasemanadoano] )

A sintaxe da função DatePart possui os seguintes argumentos:

Argumento

Descrição

intervalo

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

Data

Necessário. Variant Valor de (Data) que você deseja avaliar.

primeirodiadasemana

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

primeirasemanadoano

Opcional. Uma constante que especifica a primeira semana do ano. Se não especificado, a primeira semana será considerada sejam semana na qual 1º de janeiro.


Definições tarefas

O intervaloargumento possui estas configurações:

Configuração

Descrição

aaaa

Ano

/t

Trimestre

m

Mês

a

Dia do ano

d

Dia

/s

Dia da semana

ss

Semana

Exemplo de número de telefone do Lync que mostra um formato internacional de discagem

Hora

Ativar ou desativar caracteres não imprimíveis

Minuto

s

Segundo


O argumento primeirodiadasemana possui estas configurações:

Constante

Valor

Descrição

vbUseSystem

0

Use a configuração de 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 possui estas configurações:

Constante

Valor

Descrição

vbUseSystem

0

Use a configuração de API NLS.

vbFirstJan1

1

Comece com a semana na qual 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 específico de tempo. Por exemplo, você pode usar DatePart para calcular o dia da semana ou a hora atual.

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

Se date é uma literal de data, o ano especificado se tornará parte permanente dessa data. No entanto, se a Data está entre aspas duplas ("") e você omitir o ano, o ano atual será inserido no seu código sempre que a expressão de Data é avaliada. Isso possibilita escrever código que pode ser usado em anos diferentes.

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

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

Exemplo

Observação : Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa 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 ele ocorre.

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

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
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.

×