# Períodos de datas

> Permite cadastrar períodos com nome, como meses, trimestres ou exercícios fiscais, agrupados por tipo. Módulo date_range no Odoo 18.

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

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

Permite cadastrar períodos com nome, como meses, trimestres ou exercícios fiscais, agrupados por tipo. Os períodos servem de filtro nas pesquisas por data e de seleção pronta nos relatórios contábeis, evitando digitar a data inicial e a final 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 no balancete e em outros relatórios, em vez de digitar as datas.
- Filtrar listas por um período nomeado, como 1T2026, em um filtro personalizado.
- Gerar de uma vez os períodos dos próximos meses, trimestres ou anos.

## Como configurar

1. Em Faturamento -> Configuração, abra Tipos de períodos e crie os tipos, como mês de competência, trimestre de apuração e exercício social.
2. Em Faturamento -> Configuração, abra Gerar intervalo de datas, escolha o tipo, a data inicial, a Duração e o Número de intervalos a serem gerados, e clique em Gerar.
3. Em Períodos, na mesma área, confira ou crie períodos um a um.
4. Com o modo desenvolvedor, os mesmos cadastros ficam em Definições -> Técnico -> Períodos.
5. No tipo de período, a aba Geração guarda valores padrão do gerador e permite criar novos períodos automaticamente.
6. Para filtrar uma lista, abra Filtros, Adicionar filtro personalizado, escolha um campo de data e selecione o tipo e o período.

## Cuidados

- Criar e alterar tipos e períodos pede o acesso de administração. Os demais usuários usam os períodos nas pesquisas e nos relatórios.
- Para cadastrar períodos que se sobrepõem no mesmo tipo, marque Permitir sobreposição no tipo.
- Os períodos podem pertencer a uma empresa. Em bases com várias empresas, cada uma vê os seus e os que não têm empresa.
- Nos relatórios, escolher o período preenche a data inicial e a final automaticamente.

## Veja na prática

Cenários do manual que usam este módulo, do começo ao fim, com exemplo calculado, passo a passo e vídeo curto com legendas.

- [Criar os períodos do ano](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/contabilidade/criar-periodos-ano/) Vídeo de 2 min

## Módulos relacionados

- [Relatórios contábeis clássicos](https://docs.kmee.com.br/odoo/18.0/modulos/financeiro/account-financial-report/)
- [Relatórios gerenciais (SIG)](https://docs.kmee.com.br/odoo/18.0/modulos/financeiro/mis-builder/)
- [Balanço Patrimonial e DRE brasileiros](https://docs.kmee.com.br/odoo/18.0/modulos/localizacao-brasileira/l10n-br-mis-report/)

## Código e fontes

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