FormatoDataHora

Formata um valor TDateTime.

Estrutura

FormatDateTime(const Format: string; DateTime: TDateTime): string;

Parâmetros

Valor de retorno

Descrição

A função FormatDateTime formata o valor TDateTime fornecido pela função DateTime utilizando o formato especificado pela função Format. São suportados os seguintes especificadores de formato:

Especificador Exibe

c Exibe a data utilizando o formato definido pela variável global ShortDateFormat, seguida da hora utilizando o formato definido pela variável global LongTimeFormat. A hora não é apresentada se a parte fracionária do valor DateTime for zero.

d Exibe o dia como um número sem o zero inicial (1-31).

dd Exibe o dia como um número precedido por um zero (01-31).

ddd Exibe o dia como uma abreviatura (Dom-Sáb) utilizando as cadeias de caracteres fornecidas pela variável global ShortDayNames.

dddd Exibe o dia por extenso (domingo a sábado) utilizando as cadeias de caracteres definidas na variável global

LongDayNames.

ddddd Exibe a data utilizando o formato definido pela variável global ShortDateFormat.

dddddd Exibe a data utilizando o formato definido pela variável global LongDateFormat.

m Exibe o mês como um número sem o zero inicial (1-12). Se o especificador «m» seguir imediatamente um especificador «h» ou «hh», é exibido o minuto em vez do mês.

mm Exibe o mês como um número precedido por um zero (01-12). Se o especificador «mm» seguir imediatamente um especificador «h» ou «hh», é exibido o minuto em vez do mês.

mmm Exibe o mês como uma abreviatura (Jan-Dez) utilizando as cadeias de caracteres fornecidas pela variável global ShortMonthNames.

mmmm Exibe o mês por extenso (janeiro-dezembro) utilizando as cadeias de caracteres definidas pela variável global LongMonthNames.

yy Exibe o ano como um número de dois dígitos (00-99).

yyyy Exibe o ano como um número de quatro dígitos (0000-9999).

h Exibe a hora sem o zero à esquerda (0-23).

hh Exibe a hora com um zero à esquerda (00-23).

n Apresenta os minutos sem o zero à esquerda (0-59).

nn Apresenta os minutos com um zero à esquerda (00-59).

Exibe os segundos sem o zero à esquerda (0-59).

Exibe os segundos com um zero à esquerda (00-59).

z Apresenta os milissegundos sem o zero à esquerda (0-999).

zzz Exibe os milissegundos com um zero à esquerda (000-999).

Exibe a hora utilizando o formato definido pela variável global ShortTimeFormat.

tt Exibe a hora utilizando o formato definido pela variável global LongTimeFormat.

am/pm Utiliza o formato de 12 horas para o especificador h ou hh anterior e apresenta «am» para qualquer hora antes do meio-dia e «pm» para qualquer hora após o meio-dia.

O especificador «am/pm» pode ser escrito em minúsculas, maiúsculas ou em letras maiúsculas e minúsculas, e o resultado é apresentado em conformidade.

a/p Utiliza o formato de 12 horas para o especificador h ou hh anterior e exibe «a» para qualquer hora antes do meio-dia e «p» para qualquer hora após o meio-dia. O especificador a/p pode ser escrito em minúsculas, maiúsculas ou em letras maiúsculas e minúsculas, e o resultado é apresentado em conformidade.

ampm utiliza o formato de 12 horas para o especificador h ou hh anterior e apresenta o conteúdo da variável global TimeAMString para qualquer hora antes do meio-dia e o conteúdo da variável global TimePMString para qualquer hora após o meio-dia.

/ Exibe o caractere separador de data definido pela variável global DateSeparator.

: Exibe o caractere separador de hora definido pela variável global TimeSeparator.

Os caracteres 'xx'/'xx' entre aspas simples ou duplas são apresentados tal como estão e não afetam a formatação.

Os especificadores de formato podem ser escritos tanto em maiúsculas como em minúsculas — ambos produzem o mesmo resultado.

Se a cadeia de caracteres especificada pelo parâmetro Format estiver vazia, o valor TDateTime é formatado como se tivesse sido fornecido um especificador de formato «c». |