OdooWiki OCA HUB

Date Range

date_range folder_open OCA/server-ux open_in_new
Uncategorized Licencia: LGPL-3

Este módulo permite definir rangos de fechas globales que se pueden usar para filtrar tus valores en las vistas de árbol.

También proporciona un modelo mixin para desarrolladores que extiende la vista de búsqueda del modelo para que los rangos de fechas se puedan buscar como cualquier campo relacional.

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 20.0

Crea y gestiona rangos de fechas reutilizables (periodos) en Odoo, y filtra registros por esos periodos en las vistas de lista. Los rangos se pueden agrupar en tipos, generar automáticamente y usar como filtro 'Period' en las vistas de búsqueda.

Este módulo añade una nueva área bajo el menú Custom llamada 'Date ranges' con tres pantallas: Date Ranges, Date Range Types y Generate Date Ranges.

  • Date Ranges: cada rango tiene un nombre, una fecha de inicio, una fecha de fin y un tipo. Un rango no puede terminar antes de empezar, y dos rangos del mismo tipo no pueden solaparse a menos que el tipo lo permita. Los rangos son únicos por compañía y se pueden archivar.
  • Date Range Types: definen categorías de periodos (por ejemplo, años fiscales o trimestres). Cada tipo puede permitir solapamiento, y puede llevar valores predeterminados para la generación automática: una duración y unidad (days, weeks, months, years), un prefijo de nombre o una expresión de nombre, y ajustes de autogeneración (una fecha de inicio más cuántas unidades crear por adelantado).
  • Generate Date Ranges: un asistente que crea muchos rangos a la vez a partir de un tipo, ya sea hasta una fecha de fin dada o para un número de periodos elegido. Los nombres se construyen a partir del prefijo o de la expresión, y una vista previa muestra el primer nombre generado.

Una tarea programada ('Auto-generate date ranges') se ejecuta en segundo plano para crear rangos futuros para los tipos que tienen ajustes de autogeneración. El módulo también añade un filtro 'Period' a las vistas de búsqueda de los modelos que usan el mixin de búsqueda de rangos de fechas, lo que permite a los usuarios elegir un rango guardado en lugar de escribir fechas. El acceso es de solo lectura para los usuarios normales y de gestión completa para los administradores, con reglas multicompañía.

Depende de

web

Lo necesitan otros módulos

account_export_csvaccount_financial_reportaccount_fiscal_monthaccount_move_budgetaccount_tax_balanceaccount_vat_period_end_statementdate_range_accountdatev_export_dtvfddmrp_adjustmenthr_payroll_periodhr_utilization_analysisl10n_br_mis_reportl10n_de_tax_statementl10n_fr_fec_ocal10n_it_accountl10n_it_account_balance_eul10n_it_account_vat_period_end_settlementl10n_it_central_journall10n_it_central_journal_reportlabl10n_it_financial_statement_eul10n_it_vat_registriesl10n_nl_tax_statement_date_rangel10n_th_account_reportl10n_th_account_tax_filingl10n_th_account_tax_reportl10n_th_gov_purchase_reportl10n_th_tax_reportl10n_th_vat_reportl10n_th_withholding_tax_reportmis_builder

Menús que añade

Date rangesmenu_date_range_actionmenu_date_range_type_actionmenu_date_range_generator_action
Modelos y campos (4)
  • date.range · modelo nuevoname, active, type_id, date_end (End date), company_id, date_start (Start date)
  • date.range.type · modelo nuevoname, active, name_expr (Range name expression), company_id, name_prefix (Range name prefix), unit_of_time, allow_overlap, date_range_ids (Ranges), duration_count (Duration), date_ranges_exist, range_name_preview, autogeneration_unit, autogeneration_count, autogeneration_date_start (Autogeneration Start Date)
  • date.range.generator · modelo nuevocount (Number of ranges to generate), type_id, date_end (End date), name_expr (Range name expression), company_id, date_start (Start date), name_prefix (Range name prefix), unit_of_time, duration_count (Duration), range_name_preview
  • date.range.search.mixin · modelo nuevodate_range_search_id (Filter by period (technical field))

Texto generado por IA (DeepSeek) al leer el código de la versión 20.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 9 confirmadas, 0 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 20.0

Instalación

Fuente · Odoo 20.0

El addon utiliza el método daterange de postgres. Este método es compatible a partir de postgresql 9.2

Configuración

Fuente · Odoo 20.0

Para el uso habitual, consulte Uso a continuación. Esta sección tiene como objetivo aclarar a los desarrolladores la funcionalidad opcional.

Para configurar un modelo para que use el campo de búsqueda de estilo Many2one, haga que el modelo herede de date.range.search.mixin:

class AccountMove(models.Model):
    _name = "account.move"
    _inherit = ["account.move", "date.range.search.mixin"]

Esto hará que aparezca un campo Period en la vista de búsqueda:

>

De forma predeterminada, el mixin funciona sobre el campo date. Si desea que el mixin funcione sobre un campo con un nombre diferente, puede establecer una propiedad en su modelo:

_date_range_search_field = "invoice_date"

Uso

Fuente · Odoo 20.0

Para configurar este módulo, debe:

  • Vaya a Settings \> Technical \> Date ranges \> Date Range Types, donde puede crear tipos de rangos de fechas.
  • Vaya a Settings \> Technical \> Date ranges \> Date Ranges, donde puede crear rangos de fechas. También es posible lanzar un asistente desde el menú 'Generate Date Ranges'. El asistente es útil para generar periodos recurrentes. Establezca una fecha de fin o introduzca el número de rangos que se van a crear. La duración, la unidad de tiempo, el prefijo del nombre y la fecha de inicio se toman del tipo de rango de fechas.
  • Sus rangos de fechas ya están disponibles en el filtro personalizado para cualquier campo de tipo date o datetime. Los tipos de rango de fechas se proponen como operador de filtro ("in \"). Una vez seleccionado un tipo, los rangos de fechas de este tipo se proponen como valor de filtro. Y las fechas especificadas en el rango de fechas se utilizan para filtrar su resultado.
  • Puede configurar los tipos de rango de fechas con valores predeterminados para el asistente de generación en la pestaña Generation. En la misma pestaña también puede configurar los tipos de rango de fechas para la autogeneración. Los nuevos rangos para los tipos configurados para ello se generan mediante una tarea programada que se ejecuta a diario.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.