No artigo de hoje, vamos listar algumas das máscaras (pictures) mais usadas no mundo Protheus.
Pessoal, abaixo irei listar as principais que me recordei ao montar o artigo, se faltou alguma, mandem nos comentários que irei complementar.
No caso, procurei no TDN a página em que explica um pouco sobre as letras utilizadas na formação da Picture, mas não encontrei em português, apenas em espanhol ( TDN – Picture de los Campos ). Abaixo então segue os caracteres usados nas máscaras:
| Caractere | Descrição |
| A | Permite somente letras |
| N | Permite letras e números |
| X | Permite qualquer caractere |
| 9 | Permite números |
| # | Permite letras, números, sinais, espaços para qualquer tipo de dado |
| L | Permite apenas Y, N, T e F (Yes, No, True e False respectivamente) |
| Y | Permite apenas Y e N (Yes e No respectivamente) |
| ! | Converter letras para maiúsculo |
| $ | Exibe um cifrão |
| . | Se usar @E converte o ponto para vírgula |
| , | Se usar @E converte vírgula para ponto |
| R | Insere caracteres na máscara, mas eles não serão salvos no banco de dados |
| * | Exibe asterisco no lugar dos caracteres digitados |
| < | Começa da direita para a esquerda |
Agora vamos as máscaras mais utilizadas:
| Descrição | Máscara utilizada |
| Ano / Mês | @R 9999/99 |
| CEP | @R 99999-999 |
| CNPJ | @R 99.999.999/9999-99
ou @R! NN.NNN.NNN/NNNN-99 (a partir de 2026) |
| CPF | @R 999.999.999-99 |
| Hora e Minuto (será salvo no banco como HHMM) | @R 99:99 |
| Hora, Minuto e Segundo (será salvo no banco como HHMMSS) | @R 99:99:99 |
| Mês / Ano | @R 99/9999 |
| RG | @R 99.999.999-X |
| Senhas | @* |
| Telefone (com DDD) | @R (99) 9 9999-9999 |
| Telefone (sem DDD) | @R 9 9999-9999 |
| Tudo Maiúsculo | @! |
| Valor numérico com 2 casas decimais | @E 999,999,999.99 |
| Valor numérico com 4 casas decimais | @E 999,999,999.9999 |
| Valor numérico sem casa decimal | @E 999,999,999 |
| Valor numérico sem separador de milhar e com 2 casas decimais | @E 999999999.99 |
| Valor numérico com 2 casas decimais começando pelos centavos (direita para esquerda) | @<E 999,999,999.99 |
Update:
Pessoal, o grande Robson Gonçalves ( LinkedIn ), mandou um complemento também para o artigo, o caractere < se usado na máscara, ele começa da direita para a esquerda. Ideal para campos numéricos, quando se começa pelos centavos.
Bom pessoal, por hoje é só.
Abraços e até a próxima.
