Prefácio
A Linguagem de Transformação
Constantes
Operadores
Variáveis
Datas
Funções
- Categorias de função
  - Funções de agregação
  - Funções de agregação e Nulls
    - Condições do Filtro
  - Funções binárias
  - Funções de caractere
  - Funções de conversão
  - Funções de Limpeza de Dados
  - Funções de data
  - Funções de codificação
  - Funções financeiras
  - Funções numéricas
  - Funções científicas
  - Funções especiais
  - Funções de string
  - Funções de teste
  - Funções variáveis
  - Funções de janela
- ABORT
- ABS
- ADD_TO_DATE
- AES_DECRYPT
- AES_ENCRYPT
- ASCII
- AVG
- BINARY_COMPARE
- BINARY_CONCAT
- BINARY_LENGTH
- BINARY_SECTION
- CEIL
- CHOOSE
- CHR
- CHRCODE
- COMPRESS
- CONCAT
- CONVERT_BASE
- COS
- COSH
- COUNT
- CRC32
- CUME
- DATE_COMPARE
- DATE_DIFF
- DEC_BASE64
- DEC_HEX
- DECODE
- DECOMPRESS
- EBCDIC_ISO88591
- ENC_BASE64
- ENC_HEX
- ERROR
- EXP
- FIRST
- FLOOR
- FV
- GET_DATE_PART
- GREATEST
- IIF
- IN
- INDEXOF
- INITCAP
- INSTR
- ISNULL
- IS_DATE
- IS_NUMBER
- IS_SPACES
- LAG
- LAST
- LAST_DAY
- LEAD
- LEAST
- LENGTH
- LN
- LOG
- LOOKUP
- LOWER
- LPAD
- LTRIM
- MAKE_DATE_TIME
- MAX (Datas)
- MAX (Números)
- MAX (String)
- MD5
- MEDIAN
- METAPHONE
- MIN (Datas)
- MIN (Números)
- MIN (String)
- MOD
- MOVINGAVG
- MOVINGSUM
- NPER
- PERCENTILE
- PMT
- POWER
- PV
- RAND
- RATE
- REG_EXTRACT
- REG_MATCH
- REG_REPLACE
- REPLACECHR
- REPLACESTR
- REVERSE
- ROUND (Datas)
- ROUND (Números)
- RPAD
- RTRIM
- SETCOUNTVARIABLE
- SET_DATE_PART
- SETMAXVARIABLE
- SETMINVARIABLE
- SETVARIABLE
- SHA256
- SIGN
- SIN
- SINH
- SOUNDEX
- SQRT
- STDDEV
- SUBSTR
- SUM
- SYSTIMESTAMP
- TAN
- TANH
- TIME_RANGE
- TO_BIGINT
- TO_CHAR (Datas)
- TO_CHAR (Números)
- TO_DATE
- TO_DECIMAL
- TO_FLOAT
- TO_INTEGER
- TRUNC (Datas)
- TRUNC (Números)
- UPPER
- VARIANCE
Criação de funções personalizadas
Referência de API da Função Personalizada

Referência de Linguagem de Transformação

10.5
- 10.4.0

Anterior Avançar

TO_CHAR (Números)

Converte valores numéricos em cadeias de texto. TO_CHAR também converte datas em cadeias.

Sintaxe

TO_CHAR( numeric_value )

A tabela a seguir descreve o argumento para este comando:

Argumento	Obrigatório/ Opcional	Descrição
numeric_value	Obrigatório	Tipo de dados numérico. O valor numérico que você deseja converter em uma cadeia. Você pode inserir qualquer expressão válida de transformação.

TO_CHAR converte os valores duplos em cadeias de texto da seguinte maneira:

Converte os valores duplos de até 16 dígitos em cadeias e fornece uma precisão de até 15 dígitos. Se você transferir um número com mais de 15 dígitos, TO_CHAR arredondará o número com base no décimo sexto número e retornará a representação de cadeia do número em notação científica. Por exemplo, o valor duplo 1234567890123456 é convertido no o valor de cadeia '1.23456789012346e + 015'.

Retorna a notação decimal de números nos intervalos (-1e16,-1e-16] e [1e-16, 1e16). TO_CHAR retorna a notação científica de números fora desses intervalos. Por exemplo, o valor duplo 10842764968208837340 é convertido no valor de cadeia '1.08427649682088e + 019'.

TO_CHAR converte os valores decimais em cadeias de texto da seguinte maneira:

No modo de alta precisão, TO_CHAR converte os valores decimais de até 28 dígitos em cadeias. Se você transferir um valor decimal com mais de 28 dígitos, TO_CHAR retornará a notação científica para números maiores de 28 dígitos.

No modo de baixa precisão, TO_CHAR trata os valores decimais como valores duplos.

Se você passar uma porta decimal para a função TO_CHAR e o valor de entrada não tiver dígitos suficientes para corresponder à escala da porta decimal, a função TO_CHAR anexará zeros ao valor.

Por exemplo, se a escala da porta decimal for 5 e o valor em uma linha for 7,6901, a função TO_CHAR tratará o valor de entrada como 7,69010 e o valor de retorno será '7,69010'.

Valor de Retorno

Cadeia.

NULL se um valor transmitido para a função for NULL.

Exemplo de Conversão de Duplos

A seguinte expressão converte os valores duplos na porta SALES em cadeias:

TO_CHAR( SALES )

SALES	RETURN VALUE
1010.99	'1010.99'
-15.62567	'-15.62567'
10842764968208837340	'1.08427649682088e+019' (rounded based on the 16th digit and returns the value in scientific notation)
236789034569723	'236789034569723'
0	'0'
33.15	'33.15'
NULL	NULL

Exemplo de Conversão de Decimal

A seguinte expressão converte os valores decimais na porta SALES em cadeias no modo de alta precisão:

TO_CHAR( SALES )

SALES	RETURN VALUE
2378964536789761	'2378964536789761'
1234567890123456789012345679	'1234567890123456789012345679'
1.234578945469649345876123456	'1.234578945469649345876123456'
0.999999999999999999999999999	'0.999999999999999999999999999'
12345678901234567890123456799 (maior que 28)	'1.23456789012346e+028'