# Períodos de datas

> Permite cadastrar períodos com nome, como meses, trimestres ou exercícios fiscais, agrupados por tipo.

Fonte: https://docs.kmee.com.br/odoo/modulos/financeiro/date-range/

- Módulo `date_range`
- Origem: OCA
- Licença LGPL-3
- Odoo 16.0, 17.0, 18.0

Permite cadastrar períodos com nome, como meses, trimestres ou exercícios fiscais, agrupados por tipo. Esses períodos passam a ser usados como filtro nas pesquisas de campos de data e como seleção pronta de datas em relatórios contábeis e gerenciais, evitando digitar datas de início e fim a cada consulta.

## Quando usar

- Padronizar os meses e trimestres do exercício para que todos filtrem e emitam relatórios pelo mesmo período.
- Escolher um período cadastrado nos relatórios contábeis e gerenciais em vez de digitar as datas.
- Filtrar listas por um período nomeado, como 2024-T1, a partir de um filtro personalizado.
- Gerar automaticamente os períodos dos próximos meses ou anos sem cadastro manual.

## Como configurar

1. Ative o modo desenvolvedor e abra Definições -> Técnico -> Períodos -> Tipos de períodos para criar os tipos, por exemplo Mês e Trimestre.
2. Cadastre os períodos em Definições -> Técnico -> Períodos -> Períodos ou gere uma sequência em Definições -> Técnico -> Períodos -> Gerar intervalo de datas, informando a Duração e o Número de intervalos a serem gerados.
3. No tipo de período, aba Generation, é possível deixar valores padrão para o gerador e ligar a geração automática de novos períodos, feita por uma tarefa diária.
4. Para filtrar uma lista, abra Filtros -> Adicionar filtro personalizado, escolha um campo de data e selecione o tipo e o período desejados.

## Cuidados

- Criar e alterar tipos e períodos exige acesso de administração com nível Definições; os demais usuários apenas usam os períodos.
- Para cadastrar períodos sobrepostos do mesmo tipo, marque Permitir sobreposição no tipo.
- Os períodos podem ser ligados a uma empresa; em ambiente com várias empresas, cada uma vê os seus e os sem empresa.

## Módulos relacionados

- [Relatórios contábeis (razão, balancete e vencidos)](https://docs.kmee.com.br/odoo/modulos/financeiro/account-financial-report/)
- [Relatórios gerenciais (MIS Builder)](https://docs.kmee.com.br/odoo/modulos/financeiro/mis-builder/)

## Código e fontes

- Código-fonte: [OCA/server-ux](https://github.com/OCA/server-ux)
- [Documentação do módulo na OCA (16.0)](https://github.com/OCA/server-ux/tree/16.0/date_range)

Mais módulos em [Faturamento e contabilidade](https://docs.kmee.com.br/odoo/modulos/financeiro/) e na [referência de módulos](https://docs.kmee.com.br/odoo/modulos/).