Sdílet prostřednictvím

Funkce to_varchar

Platí pro:zaškrtnuto ano Databricks SQL zaškrtnuto ano Databricks Runtime 11.3 LTS a novější

Vrátí expr přetypované na STRING s použitím formátování fmt.

Ve verzích Databricks Runtime 14.0 a starších to_varchar podporuje expr číselné typy.

V Databricks SQL a Databricks Runtime 14.1 a vyšší to_varchar také podporuje typy expr, DATE a TIMESTAMP

to_varchar je synonymem pro to_char.

Syntaxe

to_varchar(expr, { numericFormat | datetimeFormat | stringFormat } )

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

Argumenty

  • expr: Výraz číselného typu, datetime, STRINGnebo BINARY.
  • numericFormat: STRING literál, specifikující formátovaný výstup pro expr číselného typu.
  • datetimeFormat: STRING Literál určující formátovaný výstup pro expr typu datum a čas.
  • stringFormat: Literál STRING, který určuje formátovaný výstup pro expr typu BINARY.

Návraty

Výsledek operace formátování reprezentovaný STRING.

datetmeFormat může obsahovat vzory uvedené ve vzorech pro datum a čas Datetime patterns.

stringFormat může být jedna z následujících (nerozlišující malá a velká písmena):

  • "base64"

    Řetězec Base64.

  • Hex

    Řetězec v šestnáctkovém formátu.

  • 'utf-8'

    Vstupní binární soubor je dekódován na řetězec UTF-8.

numericFormat může obsahovat následující prvky (nerozlišují malá a velká písmena):

  • 0 nebo 9

    Určuje očekávanou číslici mezi 0 a 9. Posloupnost číslic s hodnotami od 0 do 9 ve formátovacím řetězci odpovídá sekvenci číslic ve vstupní hodnotě. Tím se vygeneruje výsledný řetězec se stejnou délkou jako odpovídající sekvence jako formátovací řetězec. Výsledný řetězec je vlevo vycpaný nulami, pokud sekvence 0/9 obsahuje více číslic než odpovídající část desetinné čárky, začíná číslem 0 a je před desetinnou čárkou. V opačném případě je doplněna mezerami.

  • . nebo D

    Určuje pozici desetinné čárky (volitelné, povoleno pouze jednou).

  • , nebo G

    Určuje pozici oddělovače seskupení (tisíce) označeného čárkou (,). Musí existovat 0 nebo 9 vlevo a vpravo od každého oddělovače seskupení.

  • $

    Určuje umístění znaménka měny $. Tento znak lze zadat pouze jednou.

  • S nebo MI

    Určuje pozici znaménka -nebo +(volitelné, povoleno pouze jednou na začátku nebo na konci řetězce formátu). Všimněte si, že S vytiskne + kladné hodnoty, ale MI vytiskne mezeru.

  • PR

    Povoleno pouze na konci formátovacího řetězce; určuje, že výsledný řetězec bude zabalen do úhlových závorek, pokud je vstupní hodnota záporná. ('<1>').

Pokud numExpr vyžaduje více číslic, než kolik fmt dovoluje, funkce vrátí fmt, přičemž 0 a 9 budou nahrazeny # (např. '$###.##').

Pokud fmt je poškozený Databricks SQL, vrátí chybu.

Tato funkce je aliasem pro to_varchar.

Příklady

> SELECT to_varchar(454, '999');
 454

> SELECT to_varchar(454, '000.00');
 454.00

> SELECT to_varchar(12454, '99,999');
 12,454

> SELECT to_varchar(78.12, '$99.99');
 $78.12

> SELECT to_varchar(-12454.8, '99,999.9S');
 12,454.8-

> SELECT to_varchar(12454.8, '99,999.9S');
 12,454.8+

> SELECT '>' || to_varchar(123, '00000.00') || '<';
 >00123.00<

> SELECT '>' || to_varchar(123, '99999.99') || '<';
 >  123.00<

> SELECT to_varchar(1.1, '99');
 ##

> SELECT to_varchar(111.11, '99.9');
 ##.#

> SELECT to_varchar(111.11, '$99.9');
 $##.#

> SELECT to_varchar(date'2016-04-08', 'y');
 2016

> SELECT to_varchar(x'537061726b2053514c', 'base64');
 U3BhcmsgU1FM

> SELECT to_varchar(x'537061726b2053514c', 'hex');
 537061726B2053514C

> SELECT to_varchar(encode('abc', 'utf-8'), 'utf-8');
 abc

> SELECT to_varchar(111, 'wrong');
 Error: 'wrong' is a malformed format.
  • Last updated on