O uso de máscaras tem o objetivo de garantir que os dados inseridos estejam no formato correto. Normalmente, não há validação dos dados, apenas uma adequação em relação ao formato destes, garantindo que cada caractere do valor seja inserido nos lugares definido pela máscara.

A configuração das máscaras do lado servidor e cliente da aplicação são diferentes. Em geral, quando queremos apresentar um dado mascarado para o usuário em uma view (formulário), usamos as máscaras clientes, e para isso, o Cronapp possui diversos recursos que auxiliam essa configuração, veja mais detalhes em Formatação de máscaras na camada cliente. As máscaras do lado servidor são configuráveis a partir de blocos (servidor) e normalmente são utilizados na criação de textos, relatórios ou qualquer outro conteúdo tratado no lado servidor da aplicação.

Na figura abaixo foram inseridos um valor e uma máscara no bloco Formatar Número, o resultado pode ser visto no Console do Depurador.

Figura 1 - Exemplo de uso de máscaras

Máscaras

Para outros detalhes sobre a utilização das máscaras na camada servidor, acesse a documentação oficial Java Customizing Formats.

Símbolo e separadores

Dentro dos subpadrões, você especifica a formatação com símbolos especiais. Esses símbolos são descritos na tabela a seguir:

Datas e/ou horas

Sintaxe do padrão de formato de data.

Para outros detalhes sobre a utilização das máscaras na camada servidor, acesse a documentação oficial Java Customizing Formats Dates and Times.

Exemplos de máscaras no Servidor:

Blocos de programação

O bloco de programação fornece algumas funções para tratamento de datas. Algumas das mais importantes são:

• Formatar número: formata o número de acordo com a máscara do tipo servidor.
• Formatar número com localidade: formata o número de acordo com a máscara do tipo servidor, podendo configurar o retorno para os padrões PT-BR.
• Obter valor do campo: obtém o valor de qualquer campo da tela cliente no servidor.
• Obter campo (Banco de Dados): essa função obtém o campo do banco de dados que sempre estará no fuso especificado para a aplicação.
• Exibir Notificação: essa função bem comum merece uma observação importante, ao exibir uma data. Caso você não formate a data, ela será exibida no fuso horário do cliente.
• Imprimir: imprime no console do depurador os números já formatados.
• Converter Texto para Data: essa função converterá um texto (representação textual de uma data) para um objeto data. Caso uma máscara seja informada, ela a usará para tentar fazer a conversão, caso contrário, algumas máscaras predefinidas serão usadas - levando em consideração o idioma do cliente. Caso o formato textual não considere o fuso na sua escrita (ex.: 12/03/1910), o fuso padrão do servidor será usado. Caso o fuso tenha sido especificado (ex.: 2019-09-22T02:30Z), ele será usado.
• Converter Texto para Data com Fuso Horário: tem o mesmo comportamento da função acima, porém, quando o fuso não está discriminado, ele usa o especificado pelo parâmetro de fuso da função.
• Formatar Data: formata uma data a partir da máscara e do idioma selecionado.
• Formatar Data com Fuso Horário: formata uma data a partir do fuso horário, máscara e do idioma selecionado.

Exemplos

Máscara com data

Abaixo, na figura 2, segue um exemplo do uso da máscara na camada Servidor, observe que no parâmetro Máscara inserimos o formato "MM-dd-yyyy", onde "MM" é o mês em 2 dígitos, "dd" é o dia em 2 dígitos e "yyyy" é o ano em 4 dígitos, verifique o resultado impresso no Console do Depurador.

Figura 2 - Configurando a máscara através do bloco Formatar data Servidor

Máscara com moedas

Na função abaixo, o bloco Formatar Número com Localidade recebe um valor (em Conteúdo) e mais 3 argumentos Máscara, Língua e País, é retornado no console o valor monetário do mesmo.

Figura 3 - Exemplo monetário