Valor e Tempo
Entenda as diferenças entre os campos Número, Data, Valor Monetário e Duração, além dos recursos disponíveis nos campos de valor e tempo do ENSPACE.
Atualizado
Nesta seção
Número
Crie campos para valores numéricos com validações, formatação regional e modos de exibição como decimal, moeda e porcentagem.
Data
Crie campos para seleção de datas e horários com calendário interativo, formatação regional e suporte a filtros e automações.
Entenda os campos de valor e tempo do ENSPACE
Os campos de valor e tempo do ENSPACE são utilizados para exibir ou armazenar informações quantitativas, temporais e financeiras em formulários, tarefas e telas.
Eles podem ser usados para:
- registrar quantidades, medições e estatísticas;
- controlar prazos, agendas e histórico de eventos;
- calcular valores, custos e orçamentos;
- aplicar correção monetária automática por índices oficiais;
- definir durações de processos, atividades e prazos;
- aplicar formatações automáticas de moeda, data e unidade;
- padronizar a exibição de números e períodos.
Tipos disponíveis e quando utilizar
Número
Campo para valores numéricos como quantidades, porcentagens, medições e identificadores sequenciais. Permite cálculos, comparações e operações matemáticas.
Data
Campo para registrar datas, horários, prazos e eventos com calendário interativo e formatação regional.
Valor Monetário
Campo para valores financeiros com moeda selecionável e correção monetária automática por índices econômicos.
Duração
Campo para representar intervalos de tempo como horas trabalhadas, prazos de atendimento e tempos de espera.
Comparação entre os campos
| Recurso | Número | Data | Valor Monetário | Duração |
|---|---|---|---|---|
| Aceita casas decimais | Sim | Não | Sim | Não |
| Possui formatação de moeda | Sim (visual) | Não | Sim (com correção) | Não |
| Exibe hora junto à data | Não | Sim | Não | Não |
| Possui localidade regional | Sim | Sim | Não | Não |
| Aceita limites mínimo e máximo | Sim | Não | Não | Não |
| Preenche automaticamente | Não | Sim (data atual) | Não | Não |
| Formata exibição automaticamente | Sim | Sim | Sim | Sim |
| Possui correção automática | Não | Não | Sim | Não |
| Aceita cálculos e comparações | Sim | Sim | Sim | Sim |
Como os campos de valor e tempo funcionam
Cada campo armazena e trata os dados de forma específica:
- Número: armazena valores numéricos reais, permitindo cálculos, comparações, filtros e operações matemáticas.
- Data: armazena valores temporais reais, permitindo filtros cronológicos, ordenações, automações e condições baseadas em tempo.
- Valor Monetário: armazena valores numéricos com moeda selecionável e permite correção monetária automática por índices econômicos oficiais.
- Duração: armazena intervalos de tempo como combinação entre valor numérico e unidade de tempo (minutos, horas, dias, semanas, meses ou anos).
Em programação, um number é um tipo de dado utilizado para representar valores numéricos. Isso inclui números inteiros, decimais, negativos e positivos. Já uma string representa textos. Por isso, campos de Número, Valor Monetário e Duração permitem operações matemáticas que campos de Texto não permitem.
Recursos disponíveis
Localidade regional
Os campos Número e Data permitem configurar a localidade regional, que altera separadores, ordem de exibição e padrões culturais.
| Localidade | Número | Data |
|---|---|---|
| Português (Brasil) | 1.500,75 | 25/12/2026 |
| Inglês | 1,500.75 | 12/25/2026 |
A localidade afeta apenas a exibição visual e a interpretação de entrada. O valor armazenado internamente permanece padronizado.
Validações numéricas (Número)
O campo Número possui configurações próprias de validação e comportamento numérico.
| Configuração | Descrição |
|---|---|
| Mostrar botões | Exibe controles visuais para aumentar ou diminuir o valor diretamente no campo. |
| Valor mínimo | Define o menor valor permitido. |
| Valor máximo | Define o maior valor permitido. |
Você pode impedir números negativos definindo o valor mínimo como
0.Modos de exibição numérica (Número)
O campo Número oferece três modos visuais que alteram a forma como o valor é exibido.
| Modo | Descrição | Exemplo |
|---|---|---|
| Decimal | Números comuns e fracionários. | 1520.5 → 1.520,5 |
| Moeda | Formatação monetária visual. | 1500 → R$ 1.500,00 |
| Porcentagem | Formatação percentual. | 25 → 25% |
O modo Moeda no campo Número adiciona apenas formatação visual. Para tratamento financeiro avançado com correção monetária, utilize o campo específico de Valor Monetário.
Casas decimais (Número)
Controla a quantidade mínima e máxima de casas decimais exibidas e aceitas.
| Configuração | Exemplo |
|---|---|
| Fração mínima = 2 | 10 → 10,00 |
| Fração máxima = 2 | 10,999 → 10,99 |
Quando o usuário ultrapassa a quantidade máxima de casas decimais permitidas, os dígitos excedentes são cortados automaticamente.
Configurações temporais (Data)
O campo Data possui configurações próprias de comportamento e exibição temporal.
| Configuração | Descrição |
|---|---|
| Exibir hora | Permite selecionar também o horário além da data. |
| Preencher com a data atual | Preenche automaticamente com a data atual quando o campo está vazio no formulário. |
Formatos de data
| Formato | Exemplo |
|---|---|
| Full | sexta-feira, 25 de dezembro de 2026 |
| Long | 25 de dezembro de 2026 |
| Medium | 25 de dez. de 2026 |
| Short | 25/12/26 |
Formatos de hora
| Formato | Exemplo |
|---|---|
| Full | 18:30:00 Horário Padrão de Brasília |
| Long | 18:30:00 BRT |
| Medium | 18:30:00 |
| Short | 18:30 |
A configuração "Exibir hora" controla o armazenamento do horário. Já o "Formato da Hora" controla apenas como a hora será exibida visualmente. Se o formato da hora for deixado vazio, a hora não será exibida.
Correção monetária (Valor Monetário)
O campo Valor Monetário permite configurar correção automática por índices econômicos.
| Recurso | Descrição |
|---|---|
| Moeda selecionável | Escolha entre moedas como BRL (Real) e USD (Dólar). |
| 41 índices disponíveis | IPCA, SELIC, CDI, IGP-M, taxas de câmbio e índices judiciais, entre outros. |
| Períodos de correção | Defina data inicial e final para aplicar a correção. |
| Múltiplos períodos | Permite aplicar índices diferentes em sequência para o mesmo valor. |
| Correção automática | O ENSPACE verifica diariamente e aplica a correção quando novos valores dos índices são publicados. |
A correção monetária é aplicada automaticamente ao submeter o formulário, desde que o índice escolhido tenha competência sobre as datas definidas. Caso contrário, o sistema aguarda a publicação de novos valores do índice.
Unidades de tempo (Duração)
O campo Duração combina valor numérico com unidade de tempo.
| Unidade | Uso comum |
|---|---|
| Minutos | Atendimentos rápidos, pausas |
| Horas | Jornadas, atividades operacionais |
| Dias | Prazos e períodos administrativos |
| Semanas | Planejamento operacional |
| Meses | Contratos, vigências |
| Anos | Longos períodos ou validade |
O campo Duração aceita apenas números inteiros. Não aceita valores decimais, negativos ou segundos.
Armazenamento interno
O valor informado é convertido internamente para uma representação numérica padronizada.
| Valor informado | Valor interno |
|---|---|
2 horas | 120 |
Validação vs formatação
| Aspecto | Validação | Formatação |
|---|---|---|
| Objetivo | Restringir valores inválidos | Alterar aparência visual |
| Atua em | Valor permitido | Exibição do número |
| Exemplo | Valor mínimo/máximo | Moeda e porcentagem |
| Altera visualmente | Não necessariamente | Sim |
Comportamento dos dados
Algumas alterações feitas no campo afetam apenas novos preenchimentos.
Isso significa que:
- alterar localidade não modifica registros antigos;
- alterar casas decimais não retroage automaticamente;
- mudar formato de data ou hora não altera o valor temporal armazenado;
- trocar a unidade de duração não converte valores já salvos;
- conteúdos anteriores só mudam se forem editados novamente.
O valor continua sendo numérico ou temporal internamente mesmo quando exibido como:
- moeda;
- porcentagem;
- decimal formatado;
- data ou hora formatada;
- duração com unidade.
Casos de uso
- Número: quantidade de produtos, estoque, metas, distâncias, medidas, taxas, porcentagens, pontuações, pesos, comissões, indicadores numéricos.
- Data: datas de nascimento, agendamentos, vencimentos, início e fim de processos, prazos operacionais, registros de atendimento, eventos, cronogramas.
- Valor Monetário: preços de produtos e serviços, faturas, orçamentos, despesas, salários, investimentos, custos operacionais, cálculos judiciais com correção monetária.
- Duração: tempo de execução, tempo médio de atendimento, SLA, prazo operacional, tempo estimado, duração de reuniões, ciclos produtivos, permanência.
Boas práticas
- Utilize o campo Número com modo Decimal para valores matemáticos comuns e quantidades.
- Utilize o modo Moeda do campo Número apenas para formatação visual simples; para controle financeiro com correção automática, prefira o campo Valor Monetário.
- Configure a localidade adequada em campos de Número e Data para evitar interpretações incorretas.
- Utilize Duração em vez de Número quando o valor precisar representar tempo e ser tratado temporalmente pelo sistema.
- Padronize unidades de tempo semelhantes entre processos para facilitar comparações em relatórios.
- Configure limites mínimos e máximos no campo Número para evitar entradas inválidas.