CAST

Converte um campo ou uma expressão de um tipo para outro.

Exemplos de utilização

  • CAST(Number_field AS TEXT)
  • CAST(Text_field AS NUMBER)
  • CAST(Date_field as DATETIME)

Sintaxe

CAST field_expression AS type

Parâmetros

  • field_expression : um campo ou uma expressão.

  • type : um literal de tipo de dados.

Literais de tipo de dados CAST

Pode converter dos seguintes tipos ou para os seguintes tipos:

Tipo de origem Tipo de destino
Texto
  • DATE
  • DATETIME
  • NUMBER
Número
  • TEXT
Data
  • DATETIME
  • TEXT
Data e hora
  • DATETIME
  • TEXT

Exemplos

Objetivo: contar sessões do Website com mais de N segundos.

Numa origem de dados do Google Analytics, a Duração da sessão é uma dimensão de texto. O primeiro passo para contar sessões com mais de N segundos é converter esta dimensão num número através da função CAST. O segundo passo é usar a instrução CASE para identificar sessões com mais de um determinado valor. Para este exemplo, vamos usar 60 segundos. Vamos combinar a instrução CASE com a função SUM para fazer a contagem.

Passo 1: crie um novo campo calculado Duração da sessão (número) com a seguinte fórmula:

CAST(Session Duration AS NUMBER)

Passo 2: crie um novo campo calculado Sessões longas :

SUM(CASE WHEN Session Duration > 60 THEN 1 ELSE 0 END)

Notas

Não pode usar a função em campos agregados. CAST

  • As conversões de [DATE|DATETIME] para TEXT devolvem os formatos de string canónicos apresentados abaixo. Para devolver um formato diferente, use a função FORMAT_DATETIME.
  • As conversões de TEXT para [DATE|DATETIME] aceitam apenas o formato de string canónico. Para analisar um formato diferente, use as funções PARSE_*.
Tipo Formato de STRING canónico
DATE YYYY-\[M\]M-\[D\]D
DATETIME YYYY-\[M\]M-\[D\]D \[\[H\]H:\[M\]M:\[S\]S\[.DDDDDD\]\]

Coerção para texto

Quando uma expressão requer uma string de texto, o Data Studio força (converte implicitamente) os valores que não são strings para um tipo de dados de string.

Tipo Formato de STRING canónico
DATE YYYY-MM-DD
DATETIME YYYY-MM-DD HH:MM:SS\[.DDD\[DDD\]\]

Por exemplo, suponhamos que temos um campo created_datetime do tipo DATETIME e a seguinte fórmula:

CONCAT("Created on ", created_datetime)

Esta fórmula devolve o seguinte:

Created on 2019-11-22 16:30:00.739182

Esta fórmula não requer uma função CAST(created_datetime AS TEXT) explícita.