Converte uma datahora em uma sequência de caracteres. Também pode retornar a datahora atual do sistema operacional.

DATETIME(<datahora> <;formato>)
Nome Tipo Descrição
datahora

opcional

datahora

O campo, expressão ou valor literal a ser convertido. 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.

Caractere.

Exemplos básicos

Entrada de datahora literal

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

DATETIME(`20141231 235959`)

Retorna "31-Dez-2014 11:59 P":

DATETIME(`20141231 235959`; "DD-MMM-AAAA hh:mm A")

Retorna a data e hora atuais do sistema operacional como uma cadeia de caracteres, usando os formatos atuais de exibição de data e hora do Analytics:

DATETIME( )

Entrada de campo

Retorna cada valor como no campo Carimbo_de_data_e_hora_do_recebimento como uma cadeia de caracteres usando os formatos atuais de exibição de data e hora do Analytics:

DATETIME(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 os formatos específicos de exibição de data e hora:

DATETIME(Carimbo_de_data_e_hora_do_recebimento; "DD/MM/AAAA hh:mm:ss")

Comprimento da cadeia de saída

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

Detalhes do parâmetro

Um campo especificado para datahora pode usar qualquer formato de 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, fica restrito aos formatos na tabela abaixo.

  • Você pode usar qualquer combinação de formatos de data, hora e AM/PM.
  • A data deve preceder a hora. Não é necessário colocar um separador entre os dois, pois o Analytics usa automaticamente um único espaço como separador para a cadeia de saída.
  • O formato AM/PM é opcional e é posicionado ao final.
  • formato deve ser especificado usando apóstrofos ou aspas.

    Por exemplo: "DD-MMM-AAAA hh:mm:ss AM"

Formatos de data

Formatos de hora

Formatos AM/PM

Exemplos

todos os formatos de exibição de data permitidos pelo Analytics

hh:mm:ss

nenhum

Relógio de 24 horas

"DD/MM/AAAA hh:mm:ss"

 

hhmmss

AM ou PM

Relógio de 12 horas

"MMDDAA hhmmss PM"
 

hh:mm

A ou P

Relógio de 12 horas

"DD-MMM-AAAA hh:mm A"

 

hhmm

 

  
 

hh

 

 

Especificação de literal de um valor datahora

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

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 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.

     

Conversão de datahora para caractere

Função Descriçã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.

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".