Partilhar via

Função try_add

Aplica-se a:assinalado como sim Databricks SQL assinalado como sim Databricks Runtime 10.4 LTS e versões superiores

Devolve a soma de expr1 e expr2, ou NULL em caso de erro.

Sintaxe

try_add ( expr1 , expr2 )

Esta função também pode ser invocada como uma função de janela usando a cláusula OVER.

Argumentos

  • expr1: Uma expressão numérica, DATE, TIMESTAMP ou INTERVAL.
  • expr2: Se expr1 é um numérico expr2 deve ser expressão numérica, ou um INTERVALO caso contrário.

Devoluções

  • Se expr1 for um valor numérico, o tipo comum máximo dos argumentos.
  • Se expr1 é uma DATA e expr2 é um intervalo de tempo do dia, o resultado é um timestamp.
  • Se expr1 e expr2 são intervalos ano-mês, o resultado é um intervalo ano-mês de unidades suficientemente amplas para representar o resultado.
  • Se expr1 e expr2 são intervalos de tempo do dia, o resultado é um intervalo de tempo do dia de unidades suficientemente amplas para representar o resultado.
  • Caso contrário, o tipo de resultado corresponde a expr1.

Se ambas as expressões forem consideradas intervalos, devem ser da mesma classe.

Se o resultado exceder o tipo de resultado, o Databricks SQL retornará NULL.

Quando se adiciona um intervalo ano-mês a uma data do tipo DATE no Databricks, o SQL assegura que a data resultante esteja bem formada.

Exemplos

> SELECT try_add(1, 2);
 3

> SELECT try_add(DATE'2021-03-20', INTERVAL '2' MONTH);
 2021-5-20

> SELECT try_add(TIMESTAMP'2021-03-20 12:15:29', INTERVAL '3' SECOND);
 2021-03-20 12:15:32

> SELECT typeof(try_add(INTERVAL '3' DAY, INTERVAL '2' HOUR));
 interval day to hour

> SELECT try_add(DATE'2021-03-31', INTERVAL '1' MONTH);
 2021-04-30

> SELECT try_add(127Y, 1Y);
 NULL
  • Last updated on