to_char

Convertissez col en chaîne de caractères en fonction de format. Lance une exception si la conversion échoue.

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 remplie de zéros à gauche si la séquence 0/9 contient plus de chiffres que la partie correspondante de la valeur décimale, start avec 0 et se trouve avant la virgule. Sinon, il est complété par des espaces.
« . » ou « D » : Spécifie la position du séparateur décimal (facultatif, autorisé une seule fois).
« , » ou « G » : spécifie la position du séparateur de groupes (milliers) (,). Il doit y avoir un 0 ou un 9 à gauche et à droite de chaque séparateur de regroupement.
'$': Spécifie l'emplacement du signe de devise $. 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' : Uniquement autorisé à la fin de la chaîne de format ; spécifie que la chaîne de résultat sera encadrée par des chevrons si la valeur d'entrée est négative.

Si col est un datetime, format doit être un modèle de datetime valide.

Si col est un binaire, il est converti en chaîne dans l'un des formats :

Pour la fonction Databricks SQL correspondante, consultez la fonctionto_char.

Syntaxe

Python
from pyspark.sql import functions as dbf

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

parameter	Type	Description
`col`	`pyspark.sql.Column` OU `str`	Colonne d'entrée ou chaînes de caractères.
`format`	`pyspark.sql.Column` OU `str, optional`	format à utiliser pour convertir les valeurs de type caractère.

parameter	Type	Description
`col`	`pyspark.sql.Column` OU `str`	Colonne d'entrée ou chaînes de caractères.
`format`	`pyspark.sql.Column` OU `str, optional`	format à utiliser pour convertir les valeurs de type caractère.

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