Função CTODT( )

Converte um valor em caractere ou numérico de datahora em uma datahora. Abreviação de "Caractere para Datahora".

Sintaxe

CTODT(cadeia/número <;formato>)

Parâmetros

Nome	Tipo	Descrição
cadeia/número	caractere numérico	O campo, expressão ou valor literal que será convertido em datahora.
formato opcional	caractere	O formato de data da cadeia/número. O formato é obrigatório para valores que usam qualquer formato diferente de AAAAMMDD ou AAMMDD na parte da data do valor, por exemplo, "DD/MM/AAAA".

Nome

Tipo

Descrição

cadeia/número

caractere

numérico

O campo, expressão ou valor literal que será convertido em datahora.

formato

opcional

caractere

O formato de data da cadeia/número. O formato é obrigatório para valores que usam qualquer formato diferente de AAAAMMDD ou AAMMDD na parte da data do valor, por exemplo, "DD/MM/AAAA".

Saída

Datahora. O valor de datahora nos resultados é mostrado usando os formatos atuais de exibição de data e hora do Analytics.

Exemplos

Exemplos básicos

Entrada literal de caractere

Retorna `20141231t235959` exibido como 31 Dez 2014 23:59:59 presumindo um formato de exibição atual de data e hora do Analytics de DD MMM AAAA e hh:mm:ss:

CTODT("20141231 235959")

CTODT("31/12/2014 23:59:59"; "DD/MM/YYYY hh:mm:ss")

Entrada literal numérica

Retorna `20141231t235959` exibido como 31 Dez 2014 23:59:59 presumindo um formato de exibição atual de data e hora do Analytics de DD MMM AAAA e hh:mm:ss:

CTODT(20141231,235959)

CTODT(31122014,235959; "DDMMYYYY,hhmmss")

Entrada de campo de campo de caracteres

Retorna cada valor no campo de caracteres Carimbo_de_data_do_recebimento como datahora, usando o formato atual de exibição de data do Analytics:

CTODT(Carimbo_de_data_e_hora_do_recebimento; "DD/MM/YYYY hh:mm:ss")

Entrada de campo numérico

Retorna cada valor no campo numérico Carimbo_de_data_do_pagamento como datahora, usando o formato atual de exibição de data do Analytics:

CTODT(carimbo_de_data_do_pagamento; "DD/MM/YYYY hh:mm:ss")

Exemplos avançados

Comparar um campo caractere ou numérico com uma datahora

Use a função CTODT( ) para comparar uma datahora com um campo de caracteres ou numérico contendo valores que representam datahora.

O filtro abaixo compara dois valores:

o caractere de campo Carimbo_de_data_e_hora_do_recebimento que armazena datahoras como dados de caractere no formato DD/MM/AAAA hh:mm:ss
o valor de datahora literal 1 de julho de 2014 13:30:00

SET FILTER TO CTODT(Datahora_recebimento; "DD/MM/YYYY hh:mm:ss") < `20140701t133000`

Observações

Formatos de datahora obrigatórios

Os campos de caracteres e numéricos contendo valores de datahora também devem corresponder aos formatos na tabela abaixo. Os valores de datahora podem usar qualquer combinação de formatos de data, separador e hora válidos para seu tipo de dados. A data deve preceder a hora e um separador deve ser usado entre os dois.

A parte de data de valores pode usar qualquer formato de data compatível com o Analytics e válido para o tipo de dados, desde que os formatos diferentes de AAAAMMDD ou AAMMDD sejam definidos corretamente pelo formato. Se você usa o formato, deve também especificar o formato da hora, que deve ser um dos formatos de hora listados na tabela abaixo.

O Analytics reconhece automaticamente o separador entre as partes de data e hora nos valores de datahora, portanto, não é preciso especificar o separador no formato. O separador pode ser especificado, se você quiser.

Formatos de data	Formatos de separador	Formatos de hora
Campos de caractere
AAAAMMDD	único espaço em branco	hhmmss hh:mm:ss
AAMMDD	a letra 't'	hhmm hh:mm
qualquer formato de data compatível com o Analytics e válido para o tipo de dados, se definido pelo formato	a letra 'T'	hh
		+/-hhmm +/-hh:mm (ajuste UTC)
		+/-hh (ajuste UTC)
		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.)
Campos numéricos
AAAAMMDD	ponto decimal	hhmmss
AAMMDD		hhmm
qualquer formato de data compatível com o Analytics e válido para o tipo de dados, se definido pelo formato		hh

Outras funções de conversão datahora

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

[ Voltar ao início ]

Guia de scripting do ACL 14.1