DT_FIMHRVERAO - Data Fim do Horário de Verão

Tela de configuração: ADM010 — Parâmetros do Sistema Tabela: PARMSISTEMA.DT_FIMHRVERAO Tipo: DOM_TIMESTAMP (data e hora) Valor padrão: Nenhum (campo nulo por padrão)

Descrição

Define a data e hora de término do horário de verão utilizado pelo sistema. Trabalha em conjunto com DT_INICIOHRVERAO e é controlada pelo flag ST_HORARIOVERAOAUTO (período automático).

Campos envolvidos

Campo	Tipo	Descrição
DT_FIMHRVERAO	TIMESTAMP	Data/hora de término do horário de verão
DT_INICIOHRVERAO	TIMESTAMP	Data/hora de início do horário de verão (configurado na mesma tela)
ST_HORARIOVERAOAUTO	CHAR(1)	Indica se o período é determinado automaticamente (configurado na mesma tela)

Opções disponíveis

Preenchimento manual

O que faz	Detalhe
Permite digitar a data de término do horário de verão	Habilitado apenas quando ST_HORARIOVERAOAUTO está desmarcado
Editável	Sim, quando habilitado
Obrigatório	Condicional — obrigatório se DT_INICIOHRVERAO estiver preenchido

Simulação passo a passo

1. Acesse a tela ADM010 — Parâmetros do Sistema.
2. Desmarque a opção Período Automático (ST_HORARIOVERAOAUTO).
3. O campo Data Fim Horário de Verão será habilitado para edição.
4. Digite a data de término desejada, por exemplo 18/02/2024 23:59.
5. Preencha também o campo Data Início Horário de Verão com a data de início correspondente.
6. Salve o registro.

Resultado esperado: A data de término do horário de verão fica armazenada e será utilizada pelo sistema. Ao tentar salvar com a data de término anterior à data de início, o sistema exibe a mensagem "Data de Término do Horário de Verão deve ser posterior a data de Início!" e foca no campo de término.

Exceção / Importante: Se DT_INICIOHRVERAO estiver preenchido e DT_FIMHRVERAO estiver vazio, o sistema bloqueia a gravação com a mensagem "Informe a data de término do Horário de Verão!".

Preenchimento automático

O que faz	Detalhe
Preenche automaticamente início e fim do horário de verão	Chamada à função SQL RETORNA_HORARIOVERAO
Editável	Não — campo fica desabilitado quando automático está ativo
Exige	ST_HORARIOVERAOAUTO = 'S'

Simulação passo a passo

1. Acesse a tela ADM010 — Parâmetros do Sistema.
2. Marque a opção Período Automático (ST_HORARIOVERAOAUTO).
3. Os campos Data Início e Data Fim do horário de verão serão preenchidos automaticamente pela função RETORNA_HORARIOVERAO e ficarão desabilitados.
4. Salve o registro.

Resultado esperado: Ambas as datas de horário de verão são preenchidas automaticamente com base nas regras oficiais e os campos ficam bloqueados para edição manual.

Regras de validação

Regra	Mensagem exibida	Condição
Fim preenchido sem início	"Informe a data de início do Horário de Verão!"	DT_FIMHRVERAO <> vazio e DT_INICIOHRVERAO = vazio
Início preenchido sem fim	"Informe a data de término do Horário de Verão!"	DT_INICIOHRVERAO <> vazio e DT_FIMHRVERAO = vazio
Fim anterior ao início	"Data de Término do Horário de Verão deve ser posterior a data de Início!"	DT_FIMHRVERAO < DT_INICIOHRVERAO

Procedures impactadas

Rotinas Delphi com referência direta

Rotina	Arquivo	Descrição
TfrmADM010.chkST_PERIODOAUTOMATICOClick	source/ADM010/UADM010.pas	Habilita/desabilita o campo e preenche automaticamente via RETORNA_HORARIOVERAO
TdmADM010.tabPARMSISTEMABeforePost	source/ADM010/UdmADM010.pas	Validações de preenchimento obrigatório e consistência de datas

Referências SQL diretas ao campo

Nenhuma procedure ou view em Scripts/ referencia diretamente o campo DT_FIMHRVERAO. As procedures listadas na evidência utilizam a tabela PARMSISTEMA para outros fins (plano de contas, SPED, etc.).

Relacionamento com outros parâmetros

Parâmetro	Configurado em	Relação
DT_INICIOHRVERAO	ADM010 — mesmo campo	Par obrigatório: preenchimento de um exige o outro
ST_HORARIOVERAOAUTO	ADM010 — flag Período Automático	Quando ativo, desabilita edição e preenche automaticamente ambas as datas