datetime: fechas y horas

El módulo datetime proporciona las clases para representar fechas y horas.

Las tres clases principales

• date — solo fecha (año, mes, día)
• time — solo hora (hora, minuto, segundo, microsegundo)
• datetime — fecha y hora juntas
• timedelta — una duración (diferencia entre dos instantes)

from datetime import date, time, datetime, timedelta

date(2025, 1, 1)                  # datetime.date(2025, 1, 1)
time(14, 30, 0)                   # datetime.time(14, 30)
datetime(2025, 1, 1, 14, 30, 0)   # datetime.datetime(2025, 1, 1, 14, 30)

"Ahora": now y today

datetime.now()        # current date + time
date.today()          # current date only

Aritmética con timedelta

from datetime import datetime, timedelta

ora = datetime(2025, 1, 1, 12, 0)
domani = ora + timedelta(days=1)
una_ora_fa = ora - timedelta(hours=1)

# difference between two datetimes -> timedelta
delta = domani - ora
delta.days        # 1
delta.total_seconds()   # 86400.0

timedeltaaceptadays, seconds, microseconds, milliseconds, minutes, hours, weeks(NOmonthsniyears`, que son ambiguos).

Formateo: strftime

Transforma datetime → cadena de texto según un patrón.

ora = datetime(2025, 1, 1, 14, 30)
ora.strftime("%Y-%m-%d")         # '2025-01-01'
ora.strftime("%d/%m/%Y %H:%M")   # '01/01/2025 14:30'
ora.strftime("%A %d %B %Y")      # 'Wednesday 01 January 2025' (locale-dependent)

Directivas más utilizadas: %Y año de 4 dígitos, %m mes de 2 dígitos, %d día de 2 dígitos, %H hora en formato 24h, %M minutos, %S segundos.

Análisis (parsing): strptime

Lo contrario: cadena → datetime, dado el patrón esperado.

datetime.strptime("01/01/2025", "%d/%m/%Y")
# datetime.datetime(2025, 1, 1, 0, 0)

ISO 8601

Para el intercambio de datos prefiere siempre el formato ISO 8601 (AAAA-MM-DDTHH:MM:SS):

ora.isoformat()                 # '2025-01-01T14:30:00'
datetime.fromisoformat("2025-01-01T14:30:00")

Zonas horarias y datetimes conscientes

Por defecto, los objetos datetime en Python son ingenuos (naive, es decir, no contienen información de zona horaria). Para aplicaciones reales, la mejor práctica es hacerlos conscientes (aware) estableciendo la zona horaria mediante datetime.timezone.utc o utilizando el módulo zoneinfo.

Pruébalo

Ejercicio de repaso

Desafío adicional