para_caractere

Converter col em uma string com base em format. Lança uma exceção se a conversão falhar.

O formato pode consistir nos seguintes caracteres, sem distinção entre maiúsculas e minúsculas:

• '0' ou '9': Especifica um dígito esperado entre 0 e 9. Uma sequência de 0 ou 9 nas strings de formato corresponde a uma sequência de dígitos no valor de entrada, gerando strings de resultado com o mesmo comprimento da sequência correspondente nas strings de formato. A sequência resultante é preenchida com zeros à esquerda se a sequência 0/9 contiver mais dígitos do que a parte correspondente do valor decimal, começar com 0 e estiver antes da vírgula decimal. apontar. Caso contrário, será preenchido com espaços.

• '.' ou 'D': Especifica a posição do ponto decimal (opcional, permitido apenas uma vez).

• ',' ou 'G': Especifica a posição do separador de agrupamento (milhares) (,). Deve haver um 0 ou um 9 à esquerda e à direita de cada separador de agrupamento.

• '$': Especifica a localização do símbolo de moeda $. Este caractere só pode ser especificado uma vez.

• 'S' ou 'MI': Especifica a posição de um sinal '-' ou '+' (opcional, permitido apenas uma vez no início ou no final das cadeias de formatação). Note que 'S' imprime '+' para valores positivos, mas 'MI' imprime um espaço.

• 'PR ': Permitido apenas no final das strings de formatação; especifica que as strings resultantes serão envolvidas por colchetes angulares se o valor de entrada for negativo.

Se col for uma data e hora, format deverá ser um padrão de data e hora válido.

Se col for um valor binário, ele será convertido em uma string em um dos seguintes formatos:

• 'base64': uma sequência de caracteres em base 64.
• 'hex': uma string no formato hexadecimal.
• 'utf-8': o binário de entrada é decodificado para strings UTF-8.

Para a função Databricks SQL correspondente, consulte a funçãoto_char.

Sintaxe

Python

from pyspark.databricks.sql import functions as dbf

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

Parâmetros

Parâmetro	Tipo	Descrição
col	pyspark.sql.Column ou str	Coluna de entrada ou strings.
format	pyspark.sql.Column ou str, optional	Formato a ser usado para converter valores de caracteres.

Exemplos

Python

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