Tutorial Python: Módulo datetime

El módulo datetime en Python se utiliza para tratar con fechas y tiempos. Este módulo provee funciones y clases para manipular fechas y tiempos de forma más sencilla. Aquí se describirán algunos de sus componentes más usados, como las clases date, time, datetime, timedelta y tzinfo.

Clase date

La clase date en el módulo datetime se utiliza para manejar fechas. Se pueden crear objetos date proporcionando año, mes y día como argumentos, en ese orden.

from datetime import date

# Creando una fecha
fecha = date(2023, 6, 13)
print(fecha)  # 2023-06-13

También se pueden obtener la fecha actual utilizando el método today() de la clase date.

# Obteniendo la fecha de hoy
hoy = date.today()
print(hoy)  # La fecha de hoy

La clase date también tiene otros métodos útiles, como weekday() y isoweekday(), que retornan el día de la semana como un entero (donde el lunes es 0 y el domingo es 6, o el lunes es 1 y el domingo es 7, respectivamente).

Clase time

La clase time se utiliza para manejar el tiempo. Se pueden crear objetos time proporcionando hora, minuto, segundo, microsegundo y tzinfo.

from datetime import time

# Creando un tiempo
tiempo = time(13, 45, 30)
print(tiempo)  # 13:45:30

Clase datetime

La clase datetime se utiliza para manejar tanto la fecha como el tiempo. Es la clase más utilizada en el módulo datetime.

from datetime import datetime

# Creando un objeto datetime
fecha_y_hora = datetime(2023, 6, 10, 13, 45, 30)
print(fecha_y_hora)  # 2023-06-10 13:45:30

Se pueden obtener la fecha y hora actuales utilizando el método now() de la clase datetime.

# Obteniendo la fecha y hora de ahora
ahora = datetime.now()
print(ahora)  # La fecha y hora de ahora

Clase timedelta

La clase timedelta se utiliza para manipular diferencias de tiempo. Esto puede ser útil, por ejemplo, para calcular el tiempo que falta para una fecha futura, o el tiempo que ha pasado desde una fecha anterior.

from datetime import datetime, timedelta

# Creando un timedelta de una semana
una_semana = timedelta(weeks=1)

hoy = datetime.now()

# Calculando la fecha de hace una semana
hace_una_semana = hoy - una_semana
print(hace_una_semana)  

# Calculando la fecha de dentro de una semana
dentro_de_una_semana = hoy + una_semana
print(dentro_de_una_semana)

Clase tzinfo

La clase tzinfo es una clase base abstracta para información de zona horaria. Se puede usar para crear zonas horarias propias, pero generalmente es más fácil utilizar un paquete como pytz, que ya tiene una base de datos de zonas horarias.

Aunque el módulo datetime es muy útil por sí solo, hay otros módulos y paquetes disponibles que pueden hacer el trabajo con fechas y horas aún más fácil, como dateutil, pytz y arrow.