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

Sintaxe

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

Parâmetros

Nome Tipo Descrição
cadeia/número

caractere

numérico

O campo, expressão ou valor literal a ser convertido para uma data, ou do qual será extraída a data.
formato

opcional

caractere

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

Nota

Se você usar a função CTOD com um valor datahora que exige o parâmetro formato, especifique somente a parte da data do formato, e não a parte da hora. Por exemplo:

CTOD("31/12/2014 23:59:59"; "DD/MM/YYYY")

A especificação da parte da hora impede a exibição dos resultados.

Saída

Datahora. O valor de data resultante usa o formato de exibição de data atual do Analytics.

Exemplos

Exemplos básicos

Entrada literal de caractere

Retorna `20141231` exibido como 31 Dez 2014 presumindo um formato de exibição atual de data do Analytics de DD MMM AAAA:

CTOD("20141231")
CTOD("31/12/2014"; "DD/MM/YYYY")
CTOD("20141231 235959")

Entrada literal numérica

Retorna `20141231` exibido como 31 Dez 2014 presumindo um formato de exibição atual de data do Analytics de DD MMM AAAA:

CTOD(20141231)
CTOD(31122014; "DDMMYYYY")
CTOD(20141231;235959)

Entrada de campo de campo de caracteres

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

CTOD(Data_fatura; "DD/MM/YYYY")
CTOD(Carimbo_de_data_e_hora_do_recebimento)

Entrada de campo numérico

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

CTOD(Data_vencimento; "DDMMYYYY")
CTOD(Carimbo_de_data_e_hora_do_pagamento)

Exemplos avançados

Comparar um campo caractere ou numérico com uma data

Use a função CTOD( ) para comparar uma data com um campo caractere ou numérico contendo valores que representam datas.

O filtro abaixo compara dois valores:

  • o campo numérico Data_vencimento que armazena datas como números no formato DDMMAAAA
  • o valor de data literal 1 de julho de 2014
SET FILTER TO CTOD(Data_vencimento; "DDMMYYYY") < `20140701`

Observações

Formatos de data exigidos

Os campos de caracteres e numéricos contendo valores de data ou 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.

Datas ou a parte de data de valores datahora podem 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.

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

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

Guia de scripting do ACL 14.1