Administrar o Oracle CRM On Demand > Expression Builder > Funções do Expression Builder > ToChar
ToChar
A função ToChar do Expression Builder converte uma data especificada ou expressão numérica numa cadeia formatada.
Sintaxe
ToChar(expression, format)
ATENÇÃO: Não utilize os formatos de data e de número numa instância da função ToChar. Se o fizer, poderá conduzir a resultados inválidos.
Tipo de resultado
Cadeia
Argumentos
A tabela seguinte descreve os argumentos para a função.
Argumento
|
Descrição
|
expressão
|
Uma expressão ou campo que devolve uma data, uma data e hora ou um valor numérico.
|
formato
|
Uma cadeia que representa a data ou formato numérico.
|
A tabela seguinte descreve os formatos de data para a função.
Código de formato
|
Descrição
|
DD
|
Um dia do mês com dois dígitos (01-31).
|
DDDD
dddd
|
O nome do dia.
|
MM
|
Um número do mês com dois dígitos (01-12, em que 01 corresponde a JAN). Tem de utilizar MM em maiúsculas, porque mm em minúsculas indica os minutos.
|
MMMM
mmmm
|
O nome do mês. Note que, se utilizar minúsculas, terá de utilizar mmmm (ou seja, a letra m em minúsculas, quatro vezes), porque mm (isto é, a letra m em minúsculas, duas vezes) indica os minutos.
|
S
|
O último dígito do ano.
|
AA
|
Os últimos dois dígitos do ano.
|
AAAA
|
Um ano com 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. Pode especificar AM ou PM para ajustar a hora, conforme necessário, por exemplo:
hh:mm:ss PM
Por predefinição, se não especificar AM ou PM, será utilizado o formato de 24 horas.
|
mm
|
Os minutos. Note que, mm (isto é, a letra m em minúsculas, duas vezes) indica sempre os minutos e não pode ser utilizado para especificar um dia do mês com dois dígitos.
|
ss
|
Os segundos.
|
A tabela seguinte descreve os formatos dos números para a função.
Código de formato
|
Exemplo
|
Descrição
|
#
|
####
|
Devolve o valor com o número especificado de dígitos, com um sinal menos à esquerda se o valor for negativo.
|
0
|
####,00
|
Devolve zeros à esquerda. Devolve zeros à direita.
|
$
|
$###,00
|
Devolve o valor com um cifrão à esquerda.
|
.
|
#.###
|
Devolve um ponto na posição especificada. Não pode aparecer um ponto à direita da vírgula decimal. O modelo do formato não deve começar por um ponto.
|
,
|
###,##
|
Devolve uma vírgula decimal na posição especificada. Só é permitida uma vírgula decimal no parâmetro formato. Se o número de dígitos especificado depois da vírgula decimal for menor do que o número de dígitos disponível depois da vírgula decimal, a casa decimal será arredondada.
|
Exemplos de utilização de formatos de número
O exemplo seguinte devolve o valor 10:
ToChar (10, '##,##')
O exemplo seguinte devolve o valor 10:
ToChar (10, '##,00')
O exemplo seguinte devolve o valor 10,24:
ToChar (10,2388, '##,00')
O exemplo seguinte devolve o valor -10,24:
ToChar (-10,2388, '##,##')
Exemplos de utilização de formatos de data
O exemplo seguinte converte o valor devolvido pela função TimeStamp() no formato DD/MM/AAAA:
ToChar(Timestamp(),'DD/MM/YYYY')
Por exemplo, se a função TimeStamp() devolver um valor de 02/29/2008 10:58:37, a expressão anterior avalia para 29/02/2008.
Os exemplos que se seguem mostram como a meia-noite é apresentada através dos seguintes formatos:
ToChar(Hoje(), YYYY/MM/DD hh:mm:ss PM) devolve 2009/05/22 12:00:00 AM
ToChar(Hoje(), YYYY/MM/DD hh:mm:ss) devolve 2009/05/22 00:00:00
ToChar(Hoje(), YYYY/MM/DD hh24:mm:ss PM) devolve 2009/05/22 00:00:00
Tópicos relacionados
Consulte os tópicos seguintes para obter informações do Expression Builder relacionadas:
|