para_varchar

Converte col em uma string baseada em format. Lança uma exceção se a conversão falhar. Compatível com Spark Connect.

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 do ponto decimal. 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, veja Padrões.

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

• 'base64': uma base de 64 cordas.
• 'hex': uma string em formato hexadecimal.
• 'utf-8'O sinal binário de entrada é decodificado para strings UTF-8.

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

Sintaxe

Python

from pyspark.databricks.sql import functions as dbf

dbf.to_varchar(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	Formato a ser usado para converter valores de caracteres.

Exemplos

Python

from pyspark.databricks.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()