to_varchar
Convertit col en chaîne de caractères en fonction de format. Génère une exception si la conversion échoue. Prend en charge Spark Connect.
Le format peut être composé des caractères suivants, sans distinction de casse :
'0'ou'9': Spécifie un chiffre attendu entre 0 et 9. Une séquence de 0 ou 9 dans la chaîne de format correspond à une séquence de chiffres dans la valeur d'entrée, générant une chaîne de résultat de la même longueur que la séquence correspondante dans la chaîne de format. La chaîne de résultat est complétée à gauche par des zéros si la séquence 0/9 comprend plus de chiffres que la partie correspondante de la valeur décimale, commence par 0 et se trouve avant le séparateur décimal. Sinon, il est complété par des espaces.'.'ou'D': spécifie la position de la virgule (facultatif, autorisé une seule fois).','ou'G': Spécifie la position du séparateur de regroupement (milliers) (,). Il doit y avoir un 0 ou un 9 à gauche et à droite de chaque séparateur de regroupement.'$': Spécifie l'emplacement du symbole monétaire $. Ce caractère ne peut être spécifié qu'une seule fois.'S'ou'MI': spécifie la position d'un signe « - » ou « + » (facultatif, autorisé une seule fois au début ou à la fin de la chaîne de format). Notez que 'S' imprime '+' pour les valeurs positives, mais 'MI' imprime un espace.'PR': Autorisé uniquement à la fin de la chaîne de format ; spécifie que la chaîne de résultat sera encadrée par des crochets angulaires si la valeur d'entrée est négative.
Si col est un datetime, format doit être un modèle de datetime valide, voir Motifs.
Si col est un binaire, il est converti en chaîne dans l'un des formats :
'base64': une chaîne base 64.'hex': une chaîne au format hexadécimal.'utf-8': le binaire d'entrée est décodé en chaîne UTF-8.
Pour la fonction Databricks SQL correspondante, consultez la fonctionto_varchar.
Syntaxe
Python
from pyspark.sql import functions as dbf
dbf.to_varchar(col=<col>, format=<format>)
parameter
parameter | Type | Description |
|---|---|---|
|
| Colonne d'entrée ou chaînes de caractères. |
|
| Format à utiliser pour convertir les valeurs de caractères. |
Exemples
Python
from pyspark.sql import functions as dbf
from pyspark.sql.functions import lit
df = spark.createDataFrame([(78.12,)], ['e'])
df.select(dbf.to_varchar(df.e, lit("$99.99")).alias('r')).collect()