Udostępnij przez


To_char

Przekonwertuj col na ciąg na podstawie .format Zgłasza wyjątek, jeśli konwersja nie powiedzie się.

Format może składać się z następujących znaków, bez uwzględniania wielkości liter:

  • "0" lub "9": określa oczekiwaną cyfrę z zakresu od 0 do 9. Sekwencja 0 lub 9 w ciągu formatu pasuje do sekwencji cyfr w wartości wejściowej, generując ciąg wynikowy o tej samej długości co odpowiadająca sekwencja w ciągu formatu. Ciąg wynikowy jest w lewo wypełniony zerami, jeśli sekwencja 0/9 składa się z większej liczby cyfr niż zgodna część wartości dziesiętnej, zaczyna się od 0 i znajduje się przed punktem dziesiętnym. W przeciwnym razie jest wypełniony spacjami.

  • '.' lub 'D': określa położenie punktu dziesiętnego (opcjonalnie, dozwolone tylko raz).

  • "", lub "G": określa położenie separatora grupowania (tysięcy) (,). Musi istnieć 0 lub 9 po lewej i po prawej stronie każdego separatora grupowania.

  • '$': określa lokalizację znaku waluty $. Ten znak można określić tylko raz.

  • "S" lub "MI": określa położenie znaku "-" lub "+" (opcjonalne, dozwolone tylko raz na początku lub na końcu ciągu formatu). Należy pamiętać, że element "S" drukuje znak "+" dla wartości dodatnich, ale "MI" drukuje spację.

  • "Żądanie ściągnięcia": dozwolone tylko na końcu ciągu formatu; określa, że ciąg wynikowy będzie owinięty nawiasami kątowymi, jeśli wartość wejściowa jest ujemna.

Jeśli col jest to data/godzina, format jest prawidłowym wzorcem daty/godziny.

Jeśli col jest plikiem binarnym, jest konwertowany na ciąg w jednym z formatów:

  • "base64": podstawowy ciąg 64.
  • "szesnastkowy": ciąg w formacie szesnastkowym.
  • "utf-8": wejściowy plik binarny jest dekodowany do ciągu UTF-8.

Aby uzyskać odpowiednią funkcję SQL usługi Databricks, zobacz to_char funkcja.

Składnia

from pyspark.databricks.sql import functions as dbf

dbf.to_char(col=<col>, format=<format>)

Parametry

Parameter Typ Description
col pyspark.sql.Column lub str Dane wejściowe kolumny lub ciągi.
format pyspark.sql.Column lub str, optional format używany do konwertowania wartości znaków.

Przykłady

df = spark.createDataFrame([(78.12,)], ["e"])
df.select(to_char(df.e, lit("$99.99")).alias('r')).collect()