| Imprimir Abrir a versão em PDF da Ajuda on-line

#### ToChar A função ToChar no Expression Builder converte uma data ou expressão numérica especificada em uma string formatada. ### Sintaxe ToChar(expression, format) CUIDADO: não use os formatos de data e número em uma instância da função ToChar. Se você fizer isso, os resultados podem ser inválidos. ### Result Type String ### Argumentos A tabela a seguir descreve os argumentos da função.
Argumento | Descrição
--- | ---
expressão | Uma expressão ou um campo que retorna uma data, data e hora ou um valor numérico.
formato | Uma string que representa o formato de data ou número.
A tabela a seguir descreve os formatos de data da função.
Código do formato | Descrição
--- | ---
DD | Um dia de dois dígitos do mês (01-31).
DDDD dddd | O nome do dia.
MM | Um número de mês de dois dígitos (01-12 onde 01 é JAN). Você deve usar MM em letras maiúsculas, pois mm em letras minúsculas indica minutos.
MMMM mmmm | O nome do mês. Observe que se você usar letras minúsculas, será preciso usar mmmm (isto é, a letra m minúscula, quatro vezes), pois mm (isto é, a letra m minúscula, duas vezes) indica minutos.
Y | O último dígito do ano.
YY | Os dois últimos dígitos do ano.
YYYY | Um ano de quatro dígitos.
hh12 | A hora do dia no formato de 12 horas.
hh24 | A hora do dia no formato de 24 horas.
hh | A hora do dia. É possível especificar AM ou PM para ajustar a hora adequadamente, por exemplo: hh:mm:ss PM Se você não especificar AM ou PM, o formato de 24 horas será usado por padrão.
mm | Os minutos. Observe que mm (isto é, a letra m minúscula, duas vezes) sempre indica minutos e não pode ser usada para especificar um dia de dois dígitos do mês.
ss | Os segundos.
A tabela a seguir descreve os formatos de número da função.
Código do formato | Exemplo | Descrição
--- | --- | ---
# | #### | Retorna o valor com o número especificado de dígitos, precedido por um sinal de menos se o valor for negativo.
0 | ####.00 | Retorna zeros à esquerda. Retorna zeros à direita.
$ | $###.00 | Retorna o valor com um sinal de dólar à esquerda.
, | #,### | Retorna uma vírgula na posição especificada. Uma vírgula não pode aparecer à direita do ponto decimal. O modelo do formato não deve começar com uma vírgula.
. | ###.## | Retorna um ponto decimal na posição especificada. É permitido somente um ponto decimal no parâmetro de formato. Se o número de dígitos especificado após o ponto decimal for menor que o número de dígitos disponível após o ponto decimal, o decimal será arredondado para cima.
### Exemplos de uso de formatos de número O exemplo a seguir retorna o valor 10: ToChar (10, '##.##') O exemplo a seguir retorna o valor 10: ToChar (10, '##.00') O exemplo a seguir retorna o valor 10.24: ToChar (10.2388, '##.00') O exemplo a seguir retorna o valor -10.24: ToChar (-10.2388, '##.##') ### Exemplos de uso de formatos de data O exemplo a seguir converte o valor retornado pela função Timestamp() no formato DD/MM/YYYY: ToChar(Timestamp(),'DD/MM/YYYY') Por exemplo, se a função Timestamp() retornar um valor de 02/29/2008 10:58:37, a expressão anterior será avaliada como 29/02/2008. Os exemplos a seguir mostram como se mostra meia-noite usando vários formatos: ToChar(Today(), YYYY/MM/DD hh:mm:ss PM) retorna 2009/05/22 12:00:00 AM ToChar(Today(), YYYY/MM/DD hh:mm:ss) retorna 2009/05/22 00:00:00 ToChar(Today(), YYYY/MM/DD hh24:mm:ss PM) retorna 2009/05/22 00:00:00 #### Tópicos relacionados Consulte os seguintes tópicos para obter informações relacionadas ao Expression Builder: Sobre o Expression Builder Usando o Expression Builder Funções do Expression Builder

Publicado em agosto de 2022 | Copyright © 2005, 2022, Oracle e/ou suas empresas afiliadas. Legal Notices.