Abaixo está uma lista completa dos elementos de formato que podem ser usados para formatar números no Oracle Database.
| Elemento | Exemplo | Descrição |
|---|---|---|
, | 9,999 | Retorna uma vírgula na posição especificada. Você pode especificar várias vírgulas. Um modelo de formato de número não pode começar com uma vírgula. Além disso, uma vírgula não pode aparecer à direita de um caractere decimal ou ponto. |
. | 99.99 | Retorna um ponto decimal, que é um ponto (. ) na posição especificada. Apenas um ponto é permitido em um modelo de formato numérico. |
$ | $9999 | Retorna o valor com um cifrão inicial. |
0 | 099990 | Retorna zeros à esquerda e/ou zeros à direita. |
9 | 9999 | Retorna o valor com o número especificado de dígitos com um espaço inicial se positivo ou com um sinal de menos se negativo. Os zeros à esquerda estão em branco, exceto para um valor zero, que retorna um zero para a parte inteira do número de ponto fixo. |
B | B9999 | Retorna espaços em branco para a parte inteira de um número de ponto fixo quando a parte inteira é zero (independentemente de zeros no modelo de formato). |
C | C999 | Símbolo monetário ISO (o valor atual do NLS_ISO_CURRENCY parâmetro). |
D | 99D99 | Retorna o caractere decimal, que é o valor atual do NLS_NUMERIC_CHARACTER parâmetro. O padrão é um ponto (. ). Apenas um caractere decimal é permitido em um modelo de formato numérico. |
EEEE | 9.9EEEE | Retorna o valor usando notação científica. |
G | 9G999 | Separador de grupo (o valor atual do NLS_NUMERIC_CHARACTER parâmetro). Você pode especificar vários separadores de grupo em um modelo de formato numérico, mas um separador de grupo não pode aparecer à direita de um caractere decimal ou ponto. |
L | L999 | Símbolo da moeda local (o valor atual do NLS_CURRENCY parâmetro). |
MI | 9999MI | Retorna valores negativos com um sinal de menos à direita (- ). Retorna um valor positivo com um espaço em branco à direita. Permitido apenas na última posição de um modelo de formato numérico. |
PR | 9999PR | Retorna valor negativo entre colchetes angulares (<> ). Retorna um valor positivo com um espaço em branco à esquerda e à direita. Permitido apenas na última posição de um modelo de formato numérico. |
RN | RN | Retorna o valor como algarismos romanos em maiúsculas. O valor pode ser um número inteiro entre 1 e 3999. |
rn | rn | Retorna o valor como algarismos romanos em minúsculas. O valor pode ser um número inteiro entre 1 e 3999. |
S | S9999 9999S | Retorna valores negativos com um sinal de menos à esquerda ou à direita (- ). Retorna valores positivos com um sinal de mais à esquerda ou à direita (+ ). Permitido apenas na primeira ou na última posição. |
TM | TM | O modelo de formato de número mínimo de texto retorna (em saída decimal) o menor número de caracteres possível. Insensível a maiúsculas e minúsculas. O padrão é TM9, que retorna o número em notação fixa, a menos que a saída exceda 64 caracteres. Se a saída exceder 64 caracteres, o número será retornado em notação científica. Você não pode preceder este elemento com qualquer outro elemento. Você pode seguir este elemento apenas com um 9 ou um E (ou e ), mas não com qualquer combinação destes. |
U | U9999 | Retorna na posição especificada o símbolo de moeda dupla do Euro (ou outro), determinado pelo valor atual do NLS_DUAL_CURRENCY parâmetro. |
V | 999V99 | Retorna um valor multiplicado por 10 (e, se necessário, arredondado), onde n é o número de 9s após o V . |
X x | XXXX xxxx | Retorna o valor hexadecimal do número especificado de dígitos. Se o número especificado não for um número inteiro, o Oracle Database o arredondará para um número inteiro. Aceita apenas valores positivos ou 0 . Valores negativos retornam um erro. Você pode preceder este elemento apenas com 0 (que retorna zeros à esquerda) ou FM . Quaisquer outros elementos retornam um erro. Se você não especificar 0 nem FM com X , o retorno sempre terá um espaço em branco à esquerda. |
Como usar elementos de formato
Elementos de formato (às vezes chamados de especificadores de formato ) pode ser usado para construir modelos de formato (às vezes chamados de strings de formato ), que determinam como o número é exibido.
Por exemplo:
SELECT TO_CHAR(2735.56, 'L99G999D99MI') AS Result
FROM DUAL;Resultado:
$2,735.56
O
fm O modificador de formato também pode ser usado para remover qualquer preenchimento que possa ter sido aplicado automaticamente ao resultado. Exemplo:
SELECT TO_CHAR(2735.56, 'fmL99G999D99MI') AS Result
FROM DUAL;Resultado:
$2,735.56
Elementos de formato de data e hora
Há uma lista separada de elementos de formato para formatar valores de data e hora.
