Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

Python `date`: interpretar, extraer y combinar una fecha con una hora

En Python 3.12, `strptime()` devuelve un `datetime`, `.date()` extrae la fecha y `combine()` la une a una hora elegida.

Versión: Python 3.12

Sintaxis

from datetime import date, datetime, time

calendar_day = date(year, month, day)
parsed = datetime.strptime(text, format_string)
calendar_day = parsed.date()
combined = datetime.combine(calendar_day, clock_time)
combined = datetime.combine(calendar_day, clock_time, tzinfo=zone)

En Python 3.12, datetime.date es una clase inmutable del módulo datetime. Un objeto date guarda el año, el mes y el día, sin hora ni zona horaria. Tras from datetime import date, date(year, month, day) construye una fecha a partir de tres enteros. Si los argumentos caben en un int de C, una fecha no válida como el 29 de febrero de 2023 provoca ValueError. En CPython 3.12, un entero que no se puede convertir en un int de C, como el año en date(10**100, 1, 1), provoca OverflowError antes de que se valide la fecha.

Tras from datetime import datetime, el nombre datetime se refiere a la clase datetime.datetime, no al módulo. El método de clase datetime.strptime(text, format_string) interpreta el texto según el formato indicado y devuelve un datetime, aunque el texto solo contenga una fecha. En %d/%m/%Y, las barras separan el día, el mes y el año de cuatro cifras. Si no se indica una hora, el resultado tiene la hora 00:00:00. Un texto que no encaja en el formato o una fecha no válida provocan ValueError. La clase date no tiene un método strptime() en Python 3.12.

El método de instancia parsed.date() devuelve un date con el mismo año, mes y día. No modifica parsed, no conserva la hora ni la zona horaria y no convierte entre zonas horarias. A diferencia de este método, el constructor date(year, month, day) recibe los componentes de la fecha por separado.

El método de clase datetime.combine(calendar_day, clock_time) crea un nuevo datetime a partir de una fecha y un objeto datetime.time, no de una cadena. Por defecto toma tzinfo del objeto time; un tzinfo=zone explícito sustituye ese valor sin convertir la hora. Si el primer argumento es un datetime, se ignoran su hora y su tzinfo.

Ejemplos

from datetime import date, datetime, time

parsed = datetime.strptime("29/02/2024", "%d/%m/%Y")
calendar_day = parsed.date()
assert type(calendar_day) is date
combined = datetime.combine(calendar_day, time(14, 30))

print(parsed.isoformat())
print(calendar_day.isoformat())
print(combined.isoformat())

Resultado

2024-02-29T00:00:00
2024-02-29
2024-02-29T14:30:00

La primera línea muestra la medianoche tras interpretar un texto que solo contiene una fecha; la segunda muestra solo la fecha, y la tercera muestra esa misma fecha a las 14:30 sin zona horaria.

Lecciones relacionadas

  • Python · Lección 31 · Intermedio · Versión: 3

Fuentes