Busca en todas las páginas de la documentación
pendulum y arrow mejoran la ergonomía de datetime: análisis de cadenas ambiguas, deltas fluidos, conversión de zonas horarias y diferencias legibles por humanos. zoneinfo de Python 3.9+ cubre muchas necesidades, pero estas bibliotecas todavía brillan en CLIs, informes y bases de código heredadas.
import pendulum
now = pendulum.now("UTC")
tomorrow = now.add(days=1)
parsed = pendulum.parse("2026-07-09 14:30", tz="America/Chicago")
print(parsed.in_timezone("Europe/London").to_iso8601_string())Cuándo recurrir a esto:
zoneinfo se siente pesadofrom __future__ import annotations
import pendulum
def next_billing_run(anchor: str, tz: str = "UTC") -> pendulum.DateTime:
"""Devuelve la próxima ejecución mensual a las 02:00 local en el día de anclaje."""
base = pendulum.parse(anchor, tz=tz)
run = base.replace(hour=2, minute=0, second=0, microsecond=0)
now = pendulum.now(tz)
while run <= now:
run = run.add(months=1)
return run.in_timezone("UTC")
def format_relative(dt: pendulum.DateTime) -> str:
return dt.diff_for_humans()
if __name__ == "__main__":
utc_run = next_billing_run("2026-01-15", tz="America/New_York")
print(utc_run.to_iso8601_string())
print(format_relative(pendulum.now("UTC").subtract(hours=3)))Lo que esto demuestra:
pendulum.parse acepta cadenas similares a ISO con zona horaria explícitaadd(months=1) maneja mejor los casos extremos de fin de mes que timedelta manualdiff_for_humans para mensajes dirigidos al operadordatetime; las instancias son en su mayoría compatibles con las APIs de la librería estándar.arrow.get() analiza muchos formatos; shift() agrega unidades de calendario.datetime de Python 3.14 + zoneinfo + dateutil.parser cubre el análisis para pipelines ISO estrictos.| Biblioteca | Fortaleza | Contrapartida |
|---|---|---|
| pendulum | Ayudantes amigables con la mutabilidad, humanización de duraciones | Dependencia adicional |
| arrow | API compacta, buena para scripts rápidos | Comunidad más pequeña que pendulum |
| zoneinfo + datetime | Sin dependencia, explícito | Más código repetitivo para análisis ambiguo |
from datetime import datetime
from zoneinfo import ZoneInfo
# Equivalente de la librería estándar para el límite de almacenamiento
utc = datetime.now(ZoneInfo("UTC"))
local = utc.astimezone(ZoneInfo("America/Chicago"))TIMESTAMPTZ + almacenamiento UTC."2026-07-09" significa instantes diferentes a nivel mundial. Solución: requerir explícitamente el desplazamiento o la zona horaria predeterminada de la organización.datetime. Solución: .naive() o convertir a través de .in_timezone("UTC") a la librería estándar."09/07/2026" es ambiguo (EE. UU. vs. UE). Solución: forzar ISO 8601 en los límites de la API..timestamp() en valores ingenuos - Época incorrecta en servidores que no están en UTC. Solución: adjuntar la zona horaria antes de las operaciones de timestamp.fromisoformat de la librería estándar solo para ISO estricto.| Alternativa | Usar cuando | No usar cuando |
|---|---|---|
zoneinfo + datetime | Nuevos servicios con entradas ISO estrictas | Fechas ambiguas ingresadas por humanos |
python-dateutil | Flexibilidad del analizador sin pendulum completo | Quieres diferencias humanizadas integradas |
pandas.to_datetime | ETL de columnas en DataFrames | Código de aplicación no tabular |
| Almacenar milisegundos de época en JSON | Contratos de API con timestamps enteros | Necesitas aritmética de meses calendario |
Ambos funcionan; pendulum tiene un mantenimiento y documentación más amplios. Para aplicaciones nuevas con APIs ISO estrictas, zoneinfo puede ser suficiente.
Convierte a cadena ISO antes de JSON - la misma regla que para datetime de la librería estándar.
Inyecta una función de reloj invocable o usa pendulum.set_test_now() / freezegun en las pruebas.
Igual que la librería estándar: las marcas de tiempo POSIX ignoran los segundos intercalares; usa UTC para los registros independientemente.
Las bibliotecas típicamente ajustan o ruedan hasta el final del mes; verifica que el comportamiento coincida con las reglas de facturación.
Sí, almacena columnas datetime UTC; convierte al leer para las capas de visualización.
Las utilidades timezone de Django se integran con zoneinfo; pendulum es opcional en los comandos de administración.
email.utils.parsedate_to_datetime en la librería estándar; no necesitas pendulum a menos que quieras encadenamiento fluido.
Verifica la cadencia de lanzamiento de PyPI antes de nuevas dependencias; pendulum es la opción predeterminada más segura para nuevos proyectos.
Siempre registra ISO 8601 UTC con desplazamiento: 2026-07-09T14:30:00+00:00.
Versiones de la pila: Esta página fue escrita para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+ y uv 0.6+.
Revisado por Chris St. John·Última actualización: 16 jul 2026