TOTVSTEC

Árvore de páginas

Função: Transform

Converte qualquer valor para uma string formatada. Para isso, formata valores, do tipo caracter, data, lógico e numérico, conforme uma string de máscara especificada que inclui uma combinação de strings de template e funções de picture.

Sintaxe

Transform (<xExp>, cSayPicture) --> Ret

Parâmetros/Elementos


NomeTipoDescriçãoObrigatórioReferência
xExpQualquerIndica o valor que será formatado. Esta expressão pode ser qualquer tipo de dado válido, exceto array, bloco de código e nulo.X
cSayPictureCaracterIndica uma string de caracteres de máscara e template usada para descrever o formato da string que será retornada. Verificar Tabela de Pictures de FormataçãoX


Retorno
Ret
    (qualquer)
  • Retorna a conversão da expressão (exp) para uma string formatada, conforme a definição do parâmetro cSayPicture.
Observações
  • Esta função tem a mesma característica, do parâmetro PICTURE, do comando @...SAY.
  • Utilizada para formatar dados que serão enviados à tela ou à impressora.
  • O funcionamento da Picture @E está relacionado com a configuração feita através da função __SetPicture.


Exemplo
nValue := 123.45
 
Transform(nValue, "@E 999,999.99" ) 
// Resultado:"    123,45"
Abrangência
Advanced Protheus 6.09, Advanced Protheus 7.10, Microsiga Protheus 8.11 e Protheus 10

Veja Também
__SetPicture
Picture dos Campos - Dicionário de Dados
Tabela de Pictures de Formatação