Como fazer para: formatar campos para tratar data e hora

Este estudo de caso procura mostrar algumas sugestões de formatação para campos de edição do tipo data field e table window column para receber e mostrar datas e horas. A formatação destes campos é feita em tempo de design, no ambiente de desenvolvimento do SQLWindows, utilizando-se o Attribute Inspector.

 

Neste estudo de caso vamos nos concentrar em formatação de campos de data e hora.

 

Entendendo a formatação

 

Objetos tipo data field e table window column permitem a edição do seu conteúdo. Após o usuário encerrar a edição e tirar o foco do objeto o SQLWindows aplica a configuração de formato que você definiu para o objeto mostrando a informação no formato especificado.

 

A formatação de campos no SQLWindows está concentrada em dois locais que você precisa conhecer bem, a seção Formats e o Attribute Inspector.

 

A seção formats está localizada no interior da seção Global Declarations, como você pode ver abaixo:

 

figura 1.

 

Na seção Formats estão definidos todos os formatos utilizados pela sua aplicação. Você deve manter nesta seção apenas os formatos utilizados, evite deixar aqui formatos que não estão sendo utilizados. Esta observação torna-se uma regra quando estiver utilizando Dynalibs.

Você pode determinar como um campo será formatado de forma bem simples, basta selecionar o campo e procurar no Attribute Inspector pela propriedade “Format”, selecionando a formatação que desejar.

 

figura 2.

 

Você pode formatar um campo de duas formas:

• escolhendo um dos formatos já existentes e mostrados no combo Box de tipos de formatos.
• personalizar a formatação informando uma nova máscara que se adapte melhor às  necessidades da sua aplicação.

 

Para formatar um campo de forma personalizada você precisará conhecer os caracteres que compõem a máscara de formato e suas funções:

 

Caracter	Função
d	Mostra o número do dia , sem o zero à esquerda ( 1-31 )
dd	Mostra o número do dia , com o zero à esquerda ( 01-31 )
ddd	Mostra o nome do dia abreviado ( Seg-Dom )
dddd	Mostra o nome completo do dia ( Segunda-feira – Domingo )
M	Mostra o número do mês, sem o zero à esquerda ( 1-12 )
MM	Mostra o número do mês, com o zero à esquerda ( 01-12 )
MMM	Mostra o nome do mês abreviado ( Jan-Dez )
MMMM	Mostra o nome completo do mês ( Janeiro-Dezembro )
yy	Mostra o ano com dois dígitos
yyyy	Mostra o ano com quatro dígitos
hh	Mostra a hora ( 0-12 )
hhhh	Mostra a hora ( 0-24 )
mm	Mostra os minutos ( 0-59 )
ss	Mostra os segundos ( 0-59 )
mmmmmm	Mostra os milésimos de segundos ( 000000-999999 )
AMPM	Mostra hora no formato internacional

 

Basicamente um formato precisa ser definido nos mesmos padrões dos formatos do MS Excel.

 

Fique atento !   Uma outra maneira de formatar campos é utilizando a formatação pré-configurada pelo SQLWindows, conhecida como profile-driven, escolhendo um país na lista chamada “Country”. Porém este recurso foi descontinuado e está presente apenas para efeito de manter a compatibilidade, recomendamos que você não utilize este recurso. Se estiver utilizando recomendamos que troque para os formatos pré-definidos na lista de formatos do Attribute Inspector.

 

Mãos a obra !

 

Agora que você já conhece os caracteres utilizados na definição dos formatos, suas funções e sabe onde é feita a definição dos formatos podemos exercitar um pouco.

 

 

Este exemplo chama-se “Estudo de caso - 1.apt” e está disponível para download aqui: