Hora

Introdução

No NocoBase, hora (Time) é usada para armazenar a hora do dia.

O campo de hora é adequado para dados de negócio que não estão vinculados a uma data específica, como horário de funcionamento, horário de lembretes e períodos de turnos.

Se precisar armazenar a data e a hora ao mesmo tempo, escolha data e hora.

Cenários aplicáveis

A hora é adequada para estes cenários de negócio:

  • Horário de início e término do expediente
  • Horário de lembretes diários
  • Horário de início e término dos turnos
  • Configuração de horários fixos

Criar configuração

Na página «Configure fields» da tabela de dados, clique em «Add field» e selecione «Hora» para criar um campo de hora.

20240512181216

ConfiguraçãoDescrição
Field interfaceTipo de interface do campo. Para hora, corresponde a time e determina como o valor é inserido e exibido na página.
Field display nameNome exibido do campo na interface, como «Horário de início», «Horário do lembrete» e «Horário de funcionamento». Recomenda-se usar um nome que as pessoas responsáveis pelo negócio compreendam diretamente.
Field nameNome identificador do campo, usado em referências internas como API, campos de relação, permissões e fluxos de trabalho. Normalmente não é alterado após a criação; aceita apenas letras, números e sublinhados e deve começar com uma letra.
Field typeTipo do campo na camada de dados. Por padrão, o campo de hora é time.
Default valueValor padrão. Ao criar um registro, se o usuário não preencher o campo, o valor padrão poderá ser preenchido automaticamente.
Validation rulesRegras de validação. É possível configurar opções como preenchimento obrigatório e intervalo de tempo.
DescriptionDescrição do campo. Pode incluir o significado do campo, requisitos de preenchimento, origem dos dados ou responsável pela manutenção.
Atenção

O nome do campo será referenciado por blocos de página, permissões, fluxos de trabalho e APIs. Confirme a nomenclatura antes da criação para evitar custos de ajustes posteriores.

Características do campo

O comportamento padrão do campo de hora é o seguinte:

CaracterísticaDescrição
Field interface padrãotime.
Field type padrãotime.
Field type disponíveltime.
Componente da páginaO modo de edição usa um seletor de hora.
FiltragemSuporta filtragem por hora, intervalo, vazio e não vazio.
OrdenaçãoSuporta ordenação por hora.
ValidaçãoSuporta validações como preenchimento obrigatório e intervalo de tempo.

Editar configuração

Após a criação, clique em «Edit» à direita do campo para editar a configuração do campo de hora. A edição do campo é usada principalmente para ajustar a forma como ele é exibido e utilizado no NocoBase, como alterar o nome de exibição, a descrição, o valor padrão, as regras de validação ou as configurações específicas do campo.

Se o campo vier de uma tabela já sincronizada do banco de dados principal, a edição normalmente consiste em fazer um mapeamento de campo — mapear o campo do banco de dados para o Field type e o Field interface do NocoBase.

ConfiguraçãoPode ser editadaDescrição
Field display nameSimAltera o nome exibido do campo na interface, sem alterar o nome identificador do campo.
Field nameNãoO nome identificador do campo normalmente não pode ser alterado no formulário de edição após a criação.
Field interfaceCom suporte condicionalOs campos do banco de dados principal ou os campos sincronizados podem ser ajustados durante o mapeamento de campos. O ajuste afetará a forma de entrada, exibição e validação na página.
Field typeCom suporte condicionalOs campos do banco de dados principal ou os campos sincronizados podem ser ajustados durante o mapeamento de campos. Antes do ajuste, é necessário confirmar se os dados existentes podem ser usados com o novo tipo.
Default valueSimAjusta o valor padrão ao criar novos registros.
Validation rulesSimAjusta as regras de validação do campo.
DescriptionSimComplementa o significado do campo, os requisitos de preenchimento, a origem dos dados ou o responsável pela manutenção.
Atenção

Alternar o Field type ou o Field interface não equivale a simplesmente alterar um nome de exibição. Isso afeta a forma de armazenamento do campo, o componente de entrada, as regras de validação, as condições de filtragem e a forma como ele é usado nas variáveis de fluxo de trabalho. Quando houver muitos dados existentes, confirme primeiro se o formato dos dados é compatível.

Excluir campo

Clique em «Delete» à direita do campo para excluir o campo de hora. No banco de dados principal, também é possível selecionar vários campos e excluí-los em lote.

Ao excluir um campo de hora criado no banco de dados principal, normalmente a coluna correspondente no banco de dados e os dados já existentes nessa coluna também serão excluídos. Ao excluir um campo sincronizado do banco de dados ou mapeado de uma fonte de dados externa, o impacto dependerá da fonte de dados e da origem do campo correspondente.

Aviso

A exclusão de um campo pode afetar blocos de página, formulários, filtros, permissões, fluxos de trabalho, APIs, importações e exportações, além dos dados existentes. Antes de excluir, confirme se o campo ainda é referenciado por alguma configuração de negócio.

Uso na configuração de páginas

O campo de hora é adequado para uso em formulários e configurações de regras. 20260709232726

CenárioUso
Bloco de formulárioSelecionar uma hora do dia.
Bloco de tabelaExibir, ordenar e filtrar horários.
Bloco de filtroFiltrar por intervalo de horário.
Fluxo de trabalhoUsar como campo de condição de horário.