Udostępnij za pośrednictwem

Funkcja try_subtract

  • Artykuł

Dotyczy: zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 10.4 LTS i nowsze

Zwraca odejmowanie expr2 wartości z expr1, lub NULL na przepełnieniu.

Składnia

try_subtract ( expr1 , expr2 )

Argumenty

  • expr1: wyrażenie liczbowe, DATE, TIMESTAMP lub INTERVAL.
  • expr2: Jeśli expr1 wartość jest liczbowa expr2 , musi być wyrażeniem liczbowym lub interwałem.

Zwraca

  • Jeśli expr1 jest wartością liczbową, typowym maksymalnym typem argumentów.
  • Jeśli expr1 jest datą i expr2 jest interwałem dnia, wynik jest sygnaturą CZASOWĄ.
  • Jeśli expr1 interwały expr2 i są interwałami miesięcy lat, wynik jest interwałem miesiąca z wystarczająco szerokimi jednostkami do reprezentowania wyniku.
  • Jeśli expr1 i expr2 są interwałami dni, wynik jest interwałem dziennym wystarczająco szerokich jednostek do reprezentowania wyniku.
  • W przeciwnym razie typ wyniku jest zgodny z expr1.

Jeśli oba wyrażenia są interwałami, muszą należeć do tej samej klasy.

Jeśli wynik przepełni typ wyniku, usługa SQL usługi Databricks zwróci wartość NULL.

Po odjęciu interwału miesięcznego od daty databricks SQL zapewni, że wynikowa data jest prawidłowo sformułowana.

Przykłady

> SELECT try_subtract(1, 2);
 -1

> SELECT try_subtract(DATE'2021-03-20', INTERVAL '2' MONTH);
 2021-1-20

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

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

> SELECT try_subtract(DATE'2021-03-31', INTERVAL '1' MONTH);
 2021-02-28

> SELECT try_subtract(-128Y, 1Y);
  NULL