A to_number függvény

A következőkre vonatkozik: Databricks SQL Databricks Runtime 11.3 LTS és újabb

expr a TIZEDES értékre öntött értéket adja vissza fmt formázással.

Szintaxis

to_number(expr, fmt)

fmt
  { ' [ MI | S ] [ L | $ ]
      [ 0 | 9 | G | , ] [...]
      [ . | D ]
      [ 0 | 9 ] [...]
      [ L | $ ] [ PR | MI | S ] ' }

Argumentumok

• expr: Egy számot jelképező KARAKTERLÁNC-kifejezés. expr tartalmazhat kezdő vagy záró szóközöket.
• fmt: Egy KARAKTERLÁNC-literál, amely megadja a expr várt formátumát.

Visszatérítések

DECIMAL szám (p, s), ahol p a számjegyek teljes száma (0 vagy 9), és s a tizedesvessző utáni számjegyek száma, vagy 0, ha nincs.

fmt a következő elemeket tartalmazhatja (nem érzékeny a kis- és nagybetűkre):

• 0 vagy 9

  Adjon meg egy számjegyet, amely 0 és 9 között várható. A tizedespontoktól balra lévő A 0 érték azt jelzi, hogy expr legalább annyi számjegynek kell lennie. A bevezető 9 azt jelzi, hogy expr kihagyhatja ezeket a számjegyeket.

  expr nem lehet nagyobb, mint amennyit a tizedesvessző bal oldalán lévő számjegyek megengednek.

  A tizedesvessző jobb oldalán lévő számjegyek azt jelzik, hogy expr több számjeggyel rendelkezhet a tizedespont után, mint ahányat fmt megad.

• . vagy D

  A tizedesvessző pozícióját adja meg.

  expr nem kell tizedesvesszőt tartalmaznia.

• , vagy G

  Meghatározza a csoportosítás , (ezres) elválasztó helyét. Az egyes csoportosítási elválasztóknak 0 balra és 9 jobbra kell lenniük. expr meg kell egyeznie a szám méretéhez kapcsolódó csoportosítási elválasztóval.

• L vagy $

  Meghatározza a $ pénznemjel helyét. Ez a karakter csak egyszer adható meg.

• S vagy MI

  Megadja a "+" vagy "-" jel lehetőségét S, és csak a "-" jel helyét MI esetén. Ez az irányelv csak egyszer adható meg.

• PR

  Csak a formátumsztring végén engedélyezett; azt adja meg, hogy expr negatív számot jelezzen a hegyes zárójelekkel (<1>).

Ha a expr a 0 és 9 közötti karaktereken, vagy a fmt megengedett karakterein kívül más karaktereket tartalmaz, akkor hiba keletkezik.

Ha érvénytelen NULL esetén expr-t szeretnél kapni a hiba helyett, akkor használd a try_to_number() függvényt.

Példák

-- The format expects:
--  * an optional sign at the beginning,
--  * followed by a dollar sign,
--  * followed by a number between 3 and 6 digits long,
--  * thousands separators,
--  * up to two dight beyond the decimal point.
> SELECT to_number('-$12,345.67', 'S$999,099.99');
 -12345.67

-- Plus is optional, and so are fractional digits.
> SELECT to_number('$345', 'S$999,099.99');
 1.00

-- The format requires at least three digits.
> SELECT to_number('$45', 'S$999,099.99');
 Error: INVALID_FORMAT.MISMATCH_INPUT

-- The format requires at least three digits.
> SELECT try_to_number('$45', 'S$999,099.99');
 NULL

-- The format requires at least three digits
> SELECT to_number('$045', 'S$999,099.99');
 1.00

-- Using brackets to denote negative values
> SELECT to_number('<1234>', '999999PR');
 -1234

Kapcsolódó függvények

• cast függvény
• to_date függvény
• try_to_number függvény