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

Sintaxe

CTOT(cadeia/número)

Parâmetros

Nome Tipo Descrição
cadeia/número

caractere

numérico

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

Saída

Datahora. O valor de hora nos resultados é mostrado usando o formato de exibição de hora atual do Analytics.

Exemplos

Exemplos básicos

Entrada literal de caractere

Retorna `t235959` exibido como 23:59:59 presumindo um formato atual de exibição de hora do Analytics de hh:mm:ss:

CTOT("t235959")
CTOT("23:59:59")
CTOT("20141231 235959")

Entrada literal numérica

Retorna `t235959` exibido como 23:59:59 presumindo um formato atual de exibição de hora do Analytics de hh:mm:ss:

CTOT(,235959)
CTOT(0,235959)
CTOT(20141231,235959)

Entrada de campo de campo de caracteres

Retorna cada valor no campo de caracteres Hora_login como uma hora usando o formato atual de exibição de hora do Analytics:

CTOT(Hora_login)

Entrada de campo numérico

Retorna cada valor no campo numérico Datahora_pagamento como uma hora, sem a parte de data, usando o formato de exibição de data atual do Analytics:

CTOT(Datahora_pagamento)

Exemplos avançados

Comparar um campo caractere ou numérico com uma hora

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

O filtro abaixo compara dois valores:

  • o campo numérico Hora_login, que armazena as horas como dados numéricos
  • o valor de tempo literal 09:30:00
SET FILTER TO CTOT(Hora_login) > `t093000`

Observações

Formatos de datahora obrigatórios

Os campos de caracteres e numéricos contendo valores de hora ou datahora também devem corresponder aos formatos na tabela abaixo.

Valores de hora podem usar qualquer combinação de formatos de separador e hora. Você deve usar um separador antes do valor de hora ou dois pontos entre os componentes da hora para que a função funcione corretamente.

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.

Use a função CTOD( ) se quiser converter um valor data em caracteres ou numérico para uma data, ou para extrair a data de um valor datahora em caracteres ou numérico e retorná-lo como uma data.

Use a função CTODT( ) se quiser converter um valor de datahora em formato de caracteres ou numérico em datahora.

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

 

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

 

 

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

CTODT( )

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

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