| Imprimir Abrir versão PDF da ajuda online

#### 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
--- | ---
expression | Uma expressão ou campo que devolve uma data, uma data e hora ou um valor numérico.
format | 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.
Y | O último dígito do ano.
YY | Os últimos dois dígitos do ano.
YYYY | 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: Acerca do Expression Builder Utilizar o Expression Builder Funções do Expression Builder

Publicado em Agosto 2022 | Copyright © 2005, 2022, Oracle e/ou respetivas associadas. Legal Notices.