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 |
---|---|
Converte um valor em caractere ou numérico de datahora em uma datahora. Abreviação de "Caractere para Datahora". |
|
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 |
---|---|
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. |
|
Converte uma datahora em uma sequência de caracteres. Também pode retornar a datahora atual do sistema operacional. |
|
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 |
---|---|
Converte uma data serial, ou seja, uma data expressa como um inteiro, em um valor de data. É abreviação de "Serial to Date". |
|
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". |
|
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". |