Imprimir      Abrir versão PDF da ajuda online


Tópico anterior

Tópico seguinte

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:


Publicado em Setembro 2017 Copyright © 2005, 2017, Oracle. Todos os direitos reservados. Legal Notices.