plazos

Cálculo de plazos administrativos y judiciales españoles que no se limita a darte una fecha: explica cada paso y cita el artículo que lo justifica, con enlace al texto consolidado del BOE.

Pruébalo sin instalar nada: jaimefgdev.com/plazos

>>> from datetime import date
>>> from plazos import calcular
>>> r = calcular(date(2026, 7, 20), 20, "dias", "civil", municipio="Madrid")
>>> r.vencimiento
datetime.date(2026, 9, 15)
>>> print(r.explicar())
Vence el martes, 15 de septiembre de 2026.
Último momento para presentar: miércoles, 16 de septiembre de 2026 a las 15:00.

1. Plazo procesal del orden civil (LEC); los días inhábiles judiciales los fija la LOPJ (LOPJ, art. 182)
2. Agosto y los días del 24 de diciembre al 6 de enero son inhábiles (LOPJ, art. 183)
3. Calendario de festivos: Comunidad de Madrid, Madrid
4. Fiestas locales de Madrid en 2026 (15/05, 09/11), según BOCM n.º 296, de 12-12-2025 (...)
5. El día inicial es el de la notificación o publicación (20/07/2026); se empieza a contar el día siguiente, martes, 21 de julio de 2026 (LEC, art. 133.1)
6. Se cuentan 20 días hábiles, sin sábados, domingos ni festivos (LEC, art. 133.2)
7. Días que no cuentan: 16 días de fin de semana; 21 días (03/08 a 31/08): agosto, inhábil en los juzgados (LEC, art. 130.2)
8. El día hábil número 20 es el martes, 15 de septiembre de 2026
9. El plazo expira a las 24:00 del 15/09/2026, pero el escrito puede presentarse hasta las 15:00 del día hábil siguiente, el miércoles, 16 de septiembre de 2026 (LEC, art. 135.5)

Qué cubre

Calendarios incluidos

• Festivos nacionales y autonómicos de 2026 tomados del anexo de la Resolución BOE-A-2025-23702, incluidos los insulares de Canarias. Para otros años se usa la librería holidays y el resultado lo advierte.
• Fiestas locales de 2026 de 7.390 municipios (el 91 % de los 8.132 de España), sacadas de los boletines oficiales de las 17 comunidades, de las 9 provincias de Castilla y León y de Ceuta y Melilla, con sus correcciones y resoluciones complementarias (por ejemplo, Bilbao pasó del 21 al 28 de agosto). Los que faltan son ayuntamientos que no comunicaron sus fiestas a tiempo. La fuente sale en la explicación.
• Fiestas de pedanías, parroquias y entidades locales menores: si en parte del municipio hay otra fiesta local (Raimat en Lleida, las parroquias de Llanes…), el resultado lo avisa si cae dentro del plazo.
• En Canarias, el municipio decide también la fiesta insular (Arucas → Gran Canaria).
• Para un municipio sin datos puedes pasar sus fiestas locales con festivos_locales=[...].

Instalación

pip install plazos

Requiere Python 3.10 o superior.

Uso

from datetime import date
from plazos import Lugar, calcular

# Recurso contencioso: dos meses, agosto no cuenta.
calcular(date(2026, 7, 20), 2, "meses", "contencioso", municipio="Sevilla").vencimiento
# -> 2026-10-20

# Cualquier municipio, por nombre o por código INE; si el nombre se repite, con la provincia.
calcular(date(2026, 7, 23), 5, municipio="Begíjar")
calcular(date(2026, 7, 23), 5, municipio="Villanueva de la Sierra", provincia="Cáceres")

# Municipio sin datos: comunidad y fiestas locales a mano (fechas de ejemplo).
calcular(date(2026, 5, 14), 10, ccaa="MD", festivos_locales=[date(2026, 5, 20), date(2026, 9, 8)])

# Interesado en Valencia y órgano en Madrid: cuenta como inhábil lo que lo sea en cualquiera.
calcular(date(2026, 3, 18), 5, lugares=[Lugar(municipio="València"), Lugar("MD")])

# Despido (modalidad urgente de la LRJS): agosto y Navidad cuentan.
calcular(date(2026, 12, 18), 20, "dias", "social", ccaa="CT", urgente=True)

Resultado incluye vencimiento, presentacion_hasta (en los judiciales), pasos (texto y norma de cada uno), excluidos (cada día que no cuenta y por qué), advertencias y normas con sus enlaces.

Línea de órdenes

plazos 2026-07-20 20 dias -j civil --municipio Madrid
plazos 2026-07-20 2 meses -j contencioso --ccaa AN --local 2026-06-04 --json

Comunidades con código ISO 3166-2: AN AR AS IB CN CB CL CM CT EX GA MD MC NC PV RI VC CE ML.

Criterios cuando la norma no es clara

Si hay más de una lectura razonable, plazos elige la que da la fecha más temprana y lo dice en las advertencias:

• Plazos procesales por meses que cruzan agosto en civil y social: no se descuenta agosto.
• Derechos fundamentales en el contencioso: además de agosto, se cuenta como hábil el periodo del 24 de diciembre al 6 de enero.
• Notificaciones en agosto de plazos contenciosos por meses: se cuenta desde el 1 de septiembre y se avisa de que hay criterios distintos.

Qué no hace

• No cubre plazos tributarios, penales ni de prescripción o caducidad civil con reglas propias.
• No calcula cuándo se entiende hecha una notificación (por ejemplo, los tres días de LexNET o los diez de la sede electrónica): parte del día que le digas.
• Plazos por horas: aún no.

Herramienta web

La carpeta web/ contiene la calculadora publicada en jaimefgdev.com/plazos: HTML, CSS y JavaScript sin dependencias. Todo el cálculo se hace en el navegador. web/plazos.js traduce el motor de Python y web/datos.js se genera con python scripts/exportar_web.py. Un test lanza 600 casos aleatorios en los dos y exige que den exactamente el mismo resultado, textos incluidos.

Desarrollo

pip install -e ".[dev]"
pytest
ruff check . && ruff format --check . && mypy

Cada año hay que añadir el calendario nuevo en src/plazos/datos/: el anexo de la resolución del BOE y las fiestas locales de los municipios (los lectores de boletines están en herramientas/municipios_2026/), y volver a generar web/datos.js y web/municipios.json.

Aviso

Herramienta orientativa, no asesoramiento jurídico. Comprueba siempre el calendario oficial y la norma aplicable a tu caso. Se distribuye sin garantía de ningún tipo (ver LICENSE).

Licencia

MIT © Jaime Fernández González