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


Tópico anterior

Próximo tópico

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:


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