Função DATE( )

Extrai a data a partir de uma data ou datahora específica e retorna como sequência de caracteres. Também pode retornar a data atual do sistema operacional.

Sintaxe

DATE(<data/datahora> <;formato>)

Parâmetros

Nome	Tipo	Descrição
data/datahora opcional	datahora	O campo, expressão ou valor literal do qual será extraída a data. Se for omitido, a data atual do sistema operacional é retornada.
formato opcional	caractere	O formato a ser aplicado à cadeia de saída, por exemplo "DD/MM/AAAA". Se omitido, o formato atual de exibição da data do Analytics é utilizado. Você não pode especificar um formato se tiver omitido data/datahora.

Saída

Caractere.

Exemplos

Exemplos básicos

Retorna "20141231" no formato de exibição atual de data do Analytics:

DATE(`20141231 235959`)

Retorna "31-Dez-2014":

DATE(`20141231 235959`, "DD-MMM-AAAA")

Retorna a data atual do sistema operacional como uma cadeia de caracteres usando o formato atual de exibição de data do Analytics:

DATE()

Retorna cada valor como no campo Carimbo_de_data_e_hora_do_recebimento como uma cadeia de caracteres usando o formato atual de exibição de data do Analytics:

DATE(Carimbo_de_data_e_hora_do_recebimento)

Retorna cada valor como no campo Carimbo_de_data_e_hora_do_recebimento como uma cadeia de caracteres usando o formato específico de exibição de data:

DATE(Carimbo_de_data_e_hora_do_recebimento; "DD/MM/AAAA")

Observações

Às vezes, pode ser um desafio usar corretamente as data e hora. Na Ajuda, os tópicos de função descrevem os detalhes específicos do funcionamento de cada função. Para obter informações sobre algumas considerações gerais ao usar as funções de data e hora, consulte os seguintes tópicos:

Comprimento da cadeia de saída

O comprimento da cadeia de saída é sempre 12 caracteres. Se o formato de saída especificado ou o formato de exibição de data do Analytics for menos do que 12 caracteres, a cadeia de saída será preenchida com espaços em branco à direita.

Detalhes do parâmetro

Um campo especificado para data/datahora pode usar qualquer formato de data ou datahora, desde que a definição do campo defina corretamente o formato.

Se você usa formato para controlar como a cadeia de saída é exibida, pode usar qualquer formato de exibição de data compatível com o Analytics. Por exemplo:

DD/MM/AAAA
MM-DD-AA
DD MMM AAAA

formato deve ser especificado usando apóstrofos ou aspas – por exemplo, "DD MMM AAAA".

Especificação de literal de data ou de um valor datahora

Ao especificar um valor literal de data ou datahora para data/datahora, você fica restrito aos formatos na tabela abaixo e o valor deve estar entre apóstrofos invertidos – por exemplo, `20141231`.

Não use separadores como barras (/) ou dois pontos (:) entre os componentes individuais de datas ou horas.

Valores de datahora – você pode usar qualquer combinação de formatos de data, separador e hora listados na tabela abaixo. A data deve preceder a hora e um separador deve ser usado entre os dois. Os separadores válidos são um único espaço em branco ou as letras 't' ou 'T'.

Valores de tempo – as horas devem ser especificadas usando o relógio de 24 horas. Os ajustes do Tempo Universal Coordenado (UTC) devem ser precedidos por um sinal de mais (+) ou de menos (-).

Exemplos de formato	Exemplos de valores literais
AAAAMMDD	`20141231`
AAMMDD	`141231`
AAAAMMDD hhmmss	`20141231 235959`
AAMMDDthhmm	`141231t2359`
AAAAMMDDThh	`20141231T23`
AAAAMMDD hhmmss+/-hhmm (ajuste UTC)	`20141231 235959-0500`
AAMMDD hhmm+/-hh (ajuste UTC)	`141231 2359+01`
Nota Não use somente hh no formato de hora principal com dados que têm um ajuste UTC. Por exemplo, evite: hh+hhmm. Os resultados podem ser não confiáveis.

Funções relacionadas

Se precisar retornar a data atual do sistema operacional como valor de datahora, use TODAY( ) em vez de DATE( ).

Outras funções de conversão datahora

Conversão de datahora para caractere

Função	Descrição
DATETIME( )	Converte uma datahora em uma sequência de caracteres. Também pode retornar a datahora atual do sistema operacional.
TIME( )	Extrai a hora a partir de uma hora ou datahora específica e retorna como sequência de caracteres. Também pode retornar a hora atual do sistema operacional.

Conversão de caractere ou numérico para datahora

Função	Descrição
CTOD( )	Converte um valor em caractere ou numérico de data em uma data. Também é possível extrair a data de um valor de datahora em formato de caracteres ou numérico e retorná-lo como uma data. Abreviação de "Caractere para Data".
CTODT( )	Converte um valor em caractere ou numérico de datahora em uma datahora. Abreviação de "Caractere para Datahora".
CTOT( )	Converte um valor em caractere ou numérico de hora em uma hora. Também é possível extrair a hora de um valor de datahora em formato de caracteres ou numérico e retorná-lo como uma hora. Abreviação de "Caractere para Hora".

Conversão de serial para datahora

Função	Descrição
STOD( )	Converte uma data serial, ou seja, uma data expressa como um inteiro, em um valor de data. É abreviação de "Serial to Date".
STODT( )	Converte uma datahora serial, ou seja, uma datahora expressa como um inteiro e uma fração de 24 horas, em um valor de datahora. É abreviação de "Serial to Datetime".
STOT( )	Converte uma hora em série, ou seja, uma hora expressa como uma fração de 24 horas, sendo 24 horas representando 1, para um valor de hora. Abreviação de "Série para hora".