Partilhar via

- Operador (sinal de subtração)

  • Artigo

Aplica-se a:verificar a verificação sim do SQL do Databricks marcada como sim Databricks Runtime

Devolve a subtração de de expr2expr1.

Sintaxe

expr1 - expr2

Argumentos

  • expr1: uma expressão numérica, DATE, TIMESTAMP ou INTERVAL.
  • expr2: o tipo aceite depende do tipo de expr:
    • Se expr1 for um número tem expr2 de ser uma expressão numérica
    • Se expr1 for um intervalo de um ano ou de um dia, expr2 tem de ser da classe de intervalo correspondente.
    • Caso contrário, expr2 tem de ser UMA DATA ou CARIMBO DE DATA/HORA.

Devolve

O tipo de resultado é determinado pela seguinte ordem:

  • Se expr1 for numérico, o resultado é o tipo máximo comum dos argumentos.
  • Se expr1 for uma DATA e expr2 for um intervalo de tempo diário, o resultado será um CARIMBO DE DATA/HORA.
  • Se expr1 for um CARIMBO DE DATA/HORA e expr2 for um intervalo, o resultado será um CARIMBO DE DATA/HORA.
  • Se expr1 e expr2 forem DATEs, o resultado será .INTERVAL DAYS
  • Se expr1 ou expr2 for TIMESTAMP, o resultado será .INTERVAL DAY TO SECOND
  • Se expr1 e expr2 forem intervalos de ano/mês, o resultado é um intervalo de ano/mês de unidades suficientemente amplas para representar o resultado.
  • Se expr1 e expr2 forem intervalos de tempo diário, o resultado é um intervalo de tempo diário de unidades suficientemente largas para representar o resultado.
  • Caso contrário, o tipo de resultado corresponde expr1a .

Se ambas as expressões forem intervalo, têm de ser da mesma classe.

Quando subtrai um intervalo de um ano a uma DATA, o SQL do Databricks garante que a data resultante está bem formada.

Se o resultado exceder o tipo de resultado, o SQL do Databricks gera um erro ARITHMETIC_OVERFLOW .

Utilize try_subtract para regressar em excesso NULL .

Aviso

No Databricks Runtime, se spark.sql.ansi.enabled for false, uma capacidade excedida não causará um erro, mas "encapsula" o resultado.

Exemplos

> SELECT 2 - 1;
 1

> SELECT DATE'2021-03-20' - INTERVAL '2' MONTH
 2021-1-20

> SELECT TIMESTAMP'2021-03-20 12:15:29' - INTERVAL '3' SECOND
 2021-03-20 12:15:26

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

> SELECT typeof(current_date - (current_date + INTERVAL '1' DAY));
 interval day

> SELECT typeof(current_timestamp - (current_date + INTERVAL '1' DAY));
 interval day to second

> SELECT DATE'2021-03-31' - INTERVAL '1' MONTH;
 2021-02-28

> SELECT -100Y - 100Y;
 Error: ARITHMETIC_OVERFLOW