Administrando o Oracle CRM On Demand > Expression Builder > Funções do Expression Builder > ToChar
ToChar
A função ToChar no Expression Builder converte uma data ou expressão numérica especificada em uma string formatada.
Sintaxe
ToChar(expressão, formato)
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.
Tipo de resultado
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.
|
S
|
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:
|