A try_add függvény

  • Cikk

A következőkre vonatkozik:jelölje be az igennel jelölt jelölőnégyzetet Databricks SQL jelölje be az igennel jelölt jelölőnégyzetet Databricks Runtime 10.4 LTS és újabb

Hiba esetén a null expr2értéket expr1 adja eredményül.

Syntax

try_add ( expr1 , expr2 )

Ez a függvény ablakfüggvényként is meghívható a OVER záradék használatával.

Argumentumok

  • expr1: Numerikus, DÁTUM, IDŐBÉLYEG vagy INTERVALLUM kifejezés.
  • expr2: Ha expr1 egy numerikus expr2 kifejezésnek numerikus kifejezésnek vagy intervallumnak kell lennie.

Válaszok

  • Ha expr1 numerikus, akkor az argumentumok közös maximális típusa.
  • Ha expr1 dátum, és expr2 napi időintervallum, akkor az eredmény IDŐBÉLYEG.
  • Ha expr1 és expr2 vannak évhavi intervallumok, az eredmény egy olyan év-hónap intervallum, amely kellően széles egységekből áll, hogy az eredményt képviselje.
  • Ha expr1 és expr2 vannak nap-idő intervallumok, az eredmény egy olyan nap-idő intervallum, amely elegendően széles egységekből áll az eredmény megjelenítéséhez.
  • Ellenkező esetben az eredmény típusa megegyezik expr1.

Ha mindkét kifejezés intervallum, akkor azonos osztályba kell tartozniuk.

Ha az eredmény túlcsordul, a Databricks SQL eredménytípus null értéket ad vissza.

Ha egy év-hónap intervallumot ad hozzá a DATE Databricks SQL-hez, az biztosítja, hogy az eredményként kapott dátum jól formázott legyen.

Példák

> 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