Модуль datetime в Python

Модуль datetime в Python предоставляет классы для работы с датами и временем. Этот модуль является частью стандартной библиотеки Python, что делает его доступным без необходимости установки дополнительных пакетов. Модуль datetime позволяет выполнять множество задач, связанных с обработкой дат и времени, включая создание объектов даты и времени, форматирование, вычисление разницы между датами, работу с временными зонами и многое другое.

Основные возможности модуля datetime

Модуль datetime предоставляет следующие основные классы:

1. datetime.date: Этот класс используется для представления и манипулирования датами без времени. Объекты date включают информацию о годе, месяце и дне.
2. datetime.time: Этот класс используется для представления времени без даты. Объекты time включают часы, минуты, секунды и микросекунды.
3. datetime.datetime: Этот класс объединяет возможности date и time, позволяя работать с датами и временем вместе. Объекты datetime включают год, месяц, день, часы, минуты, секунды и микросекунды.
4. datetime.timedelta: Этот класс представляет разницу между двумя датами или временем. Объекты timedelta используются для выполнения арифметических операций с датами и временем.
5. datetime.tzinfo и datetime.timezone: Эти классы предоставляют информацию о временных зонах и позволяют учитывать временные зоны при работе с датами и временем.

Зачем использовать модуль datetime?

Работа с датами и временем часто является неотъемлемой частью разработки программного обеспечения. Независимо от того, разрабатываете ли вы веб-приложение, обрабатываете данные или пишете утилиту командной строки, вам может потребоваться работать с датами и временем. Модуль datetime предоставляет мощные и гибкие инструменты для выполнения таких задач.

Вот несколько примеров задач, которые можно решить с помощью модуля datetime:

• Получение текущей даты и времени.
• Извлечение отдельных компонентов даты и времени, таких как год, месяц, день, часы, минуты и секунды.
• Выполнение арифметических операций с датами и временем, например, вычисление разницы между двумя датами или добавление/вычитание временных интервалов.
• Форматирование дат и времени для вывода в определенном формате.
• Парсинг строк, содержащих даты и время, и преобразование их в объекты datetime.
• Работа с временными зонами и учет часовых поясов.

В этой статье мы подробно рассмотрим каждый из этих аспектов, приведем примеры использования модуля datetime и дадим рекомендации по его применению.

datetime.date: Работа с датами

Класс datetime.date в модуле datetime предназначен для работы с датами. Он позволяет создавать объекты, представляющие конкретные даты, и предоставляет методы для извлечения информации о датах, выполнения арифметических операций и форматирования. В этом разделе мы рассмотрим основные возможности класса dateи приведем примеры его использования.

Создание объектов даты

Для создания объекта даты используйте конструктор datetime.date(year, month, day), где year — это год, month— месяц (от 1 до 12), а day — день (от 1 до 31 в зависимости от месяца).

import datetime

# Создание объекта даты
date_obj = datetime.date(2023, 6, 27)
print(date_obj)  # Вывод: 2023-06-27

Получение текущей даты

Для получения текущей даты используйте метод today(). Он возвращает объект date, представляющий текущую дату.

import datetime

# Получение текущей даты
current_date = datetime.date.today()
print(current_date)  # Вывод: текущая дата (например, 2024-06-27)

Извлечение отдельных компонентов даты

Класс date предоставляет атрибуты для извлечения отдельных компонентов даты: year, month и day.

import datetime

date_obj = datetime.date(2023, 6, 27)

# Извлечение года, месяца и дня
year = date_obj.year
month = date_obj.month
day = date_obj.day

print(year)  # Вывод: 2023
print(month)  # Вывод: 6
print(day)  # Вывод: 27

Форматирование и вывод даты

Для форматирования даты в строку используйте метод strftime(format), где format — это строка формата. Модуль datetime поддерживает различные спецификаторы формата, такие как %Y для года, %m для месяца и %d для дня.

import datetime

date_obj = datetime.date(2023, 6, 27)
# Форматирование даты
formatted_date = date_obj.strftime("%d-%m-%Y")
print(formatted_date)  # Вывод: 27-06-2023

Создание даты из строки

Для создания объекта даты из строки используйте метод fromisoformat(date_string), если строка находится в ISO формате (YYYY-MM-DD). Если строка в другом формате, используйте метод strptime(date_string, format).

import datetime

# Создание даты из строки в ISO формате
date_from_string = datetime.date.fromisoformat("2023-06-27")
print(date_from_string)  # Вывод: 2023-06-27

# Создание даты из строки с использованием strptime
date_from_string = datetime.datetime.strptime("27-06-2023", "%d-%m-%Y").date()
print(date_from_string)  # Вывод: 2023-06-27

Арифметические операции с датами

С помощью класса date можно выполнять арифметические операции с датами, используя класс datetime.timedelta. Например, можно добавить или вычесть дни из даты.

import datetime

date_obj = datetime.date(2023, 6, 27)

# Добавление 10 дней к дате
new_date = date_obj + datetime.timedelta(days=10)
print(new_date)  # Вывод: 2023-07-07

# Вычитание 5 дней из даты
new_date = date_obj - datetime.timedelta(days=5)
print(new_date)  # Вывод: 2023-06-22

Примеры использования

Ниже приведены несколько примеров использования класса date в реальных задачах.

Пример 1: Вычисление возраста

import datetime

def calculate_age(birthdate):
    today = datetime.date.today()
    age = today.year - birthdate.year - ((today.month, today.day) < (birthdate.month, birthdate.day))
    return age

birthdate = datetime.date(1990, 6, 27)
age = calculate_age(birthdate)
print(f"Возраст: {age} лет")  # Вывод: Возраст: 34 лет

Пример 2: Определение дня недели

import datetime

date_obj = datetime.date(2023, 6, 27)
# Определение дня недели
day_of_week = date_obj.strftime("%A")
print(day_of_week)  # Вывод: Tuesday

Пример 3: Сравнение дат

import datetime

date1 = datetime.date(2023, 6, 27)
date2 = datetime.date(2023, 7, 1)

# Сравнение дат
if date1 < date2:
    print(f"{date1} раньше {date2}")
else:
    print(f"{date1} позже или совпадает с {date2}")

# Вывод: 2023-06-27 раньше 2023-07-01

datetime.time: Работа со временем

Класс datetime.time в модуле datetime предназначен для работы с временем. Он позволяет создавать объекты, представляющие конкретное время, и предоставляет методы для извлечения информации о времени и форматирования. В этом разделе мы рассмотрим основные возможности класса time и приведем примеры его использования.

Создание объектов времени

Для создания объекта времени используйте конструктор datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None), где hour — часы (от 0 до 23), minute — минуты (от 0 до 59), second — секунды (от 0 до 59), microsecond — микросекунды (от 0 до 999999), а tzinfo — информация о временной зоне.

import datetime

# Создание объекта времени
time_obj = datetime.time(14, 30, 45, 123456)
print(time_obj)  # Вывод: 14:30:45.123456

Извлечение отдельных компонентов времени

Класс time предоставляет атрибуты для извлечения отдельных компонентов времени: hour, minute, second и microsecond.

import datetime

time_obj = datetime.time(14, 30, 45, 123456)

# Извлечение часов, минут, секунд и микросекунд
hour = time_obj.hour
minute = time_obj.minute
second = time_obj.second
microsecond = time_obj.microsecond

print(hour)  # Вывод: 14
print(minute)  # Вывод: 30
print(second)  # Вывод: 45
print(microsecond)  # Вывод: 123456

Форматирование и вывод времени

Для форматирования времени в строку используйте метод strftime(format), где format — это строка формата. Модуль datetime поддерживает различные спецификаторы формата, такие как %H для часов, %M для минут и %S для секунд.

import datetime

time_obj = datetime.time(14, 30, 45, 123456)

# Форматирование времени
formatted_time = time_obj.strftime("%H:%M:%S.%f")
print(formatted_time)  # Вывод: 14:30:45.123456

Создание времени из строки

Для создания объекта времени из строки используйте метод strptime(time_string, format).

import datetime

# Создание времени из строки
time_from_string = datetime.datetime.strptime("14:30:45", "%H:%M:%S").time()
print(time_from_string)  # Вывод: 14:30:45

Сравнение времени

Объекты времени можно сравнивать друг с другом с использованием стандартных операторов сравнения (<, <=, >, >=, ==, !=).

import datetime

time1 = datetime.time(14, 30)
time2 = datetime.time(16, 45)

# Сравнение времени
if time1 < time2:
    print(f"{time1} раньше {time2}")
else:
    print(f"{time1} позже или совпадает с {time2}")

# Вывод: 14:30:00 раньше 16:45:00

Примеры использования

Ниже приведены несколько примеров использования класса time в реальных задачах.

Пример 1: Проверка времени в пределах диапазона

import datetime

def is_time_in_range(start_time, end_time, check_time):
    return start_time <= check_time <= end_time

start_time = datetime.time(9, 0)
end_time = datetime.time(17, 0)
check_time = datetime.time(12, 30)

if is_time_in_range(start_time, end_time, check_time):
    print("Время в пределах диапазона")
else:
    print("Время вне диапазона")

# Вывод: Время в пределах диапазона

Пример 2: Получение текущего времени

import datetime

# Получение текущего времени
current_datetime = datetime.datetime.now()
current_time = current_datetime.time()
print(current_time)  # Вывод: текущее время (например, 14:30:45.123456)

Пример 3: Округление времени до ближайших минут

import datetime

def round_time_to_nearest_minute(time_obj):
    if time_obj.second >= 30:
        new_minute = time_obj.minute + 1
        return datetime.time(time_obj.hour, new_minute)
    else:
        return datetime.time(time_obj.hour, time_obj.minute)

time_obj = datetime.time(14, 30, 45)
rounded_time = round_time_to_nearest_minute(time_obj)
print(rounded_time)  # Вывод: 14:31:00

datetime.datetime: Работа с датой и временем

Класс datetime.datetime в модуле datetime предназначен для работы с датой и временем одновременно. Он объединяет возможности классов date и time, позволяя создавать объекты, представляющие конкретные даты и время, и предоставляет методы для их обработки. В этом разделе мы рассмотрим основные возможности класса datetime и приведем примеры его использования.

Создание объектов datetime

Для создания объекта datetime используйте конструктор datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None), где year — год, month — месяц (от 1 до 12), day — день (от 1 до 31 в зависимости от месяца), hour — часы (от 0 до 23), minute — минуты (от 0 до 59), second — секунды (от 0 до 59), microsecond — микросекунды (от 0 до 999999), а tzinfo — информация о временной зоне.

import datetime

# Создание объекта datetime
datetime_obj = datetime.datetime(2023, 6, 27, 14, 30, 45, 123456)
print(datetime_obj)  # Вывод: 2023-06-27 14:30:45.123456

Получение текущей даты и времени

Для получения текущей даты и времени используйте метод now(). Он возвращает объект datetime, представляющий текущий момент времени.

import datetime

# Получение текущей даты и времени
current_datetime = datetime.datetime.now()
print(current_datetime)  # Вывод: текущая дата и время (например, 2024-06-27 14:30:45.123456)

Извлечение отдельных компонентов даты и времени

Класс datetime предоставляет атрибуты для извлечения отдельных компонентов даты и времени: year, month, day, hour, minute, second и microsecond.

import datetime

datetime_obj = datetime.datetime(2023, 6, 27, 14, 30, 45, 123456)

# Извлечение компонентов даты и времени
year = datetime_obj.year
month = datetime_obj.month
day = datetime_obj.day
hour = datetime_obj.hour
minute = datetime_obj.minute
second = datetime_obj.second
microsecond = datetime_obj.microsecond

print(year)  # Вывод: 2023
print(month)  # Вывод: 6
print(day)  # Вывод: 27
print(hour)  # Вывод: 14
print(minute)  # Вывод: 30
print(second)  # Вывод: 45
print(microsecond)  # Вывод: 123456

Форматирование и вывод даты и времени

Для форматирования даты и времени в строку используйте метод strftime(format), где format — это строка формата. Модуль datetime поддерживает различные спецификаторы формата, такие как %Y для года, %m для месяца, %d для дня, %H для часов, %M для минут и %S для секунд.

import datetime

datetime_obj = datetime.datetime(2023, 6, 27, 14, 30, 45, 123456)

# Форматирование даты и времени
formatted_datetime = datetime_obj.strftime("%d-%m-%Y %H:%M:%S.%f")
print(formatted_datetime)  # Вывод: 27-06-2023 14:30:45.123456

Создание datetime из строки

Для создания объекта datetime из строки используйте метод strptime(datetime_string, format).

import datetime

# Создание datetime из строки
datetime_from_string = datetime.datetime.strptime("27-06-2023 14:30:45", "%d-%m-%Y %H:%M:%S")
print(datetime_from_string)  # Вывод: 2023-06-27 14:30:45

Арифметические операции с datetime

С помощью класса datetime можно выполнять арифметические операции, используя класс datetime.timedelta. Например, можно добавить или вычесть дни, часы, минуты и секунды.

import datetime

datetime_obj = datetime.datetime(2023, 6, 27, 14, 30, 45, 123456)

# Добавление 10 дней к datetime
new_datetime = datetime_obj + datetime.timedelta(days=10)
print(new_datetime)  # Вывод: 2023-07-07 14:30:45.123456

# Вычитание 5 дней из datetime
new_datetime = datetime_obj - datetime.timedelta(days=5)
print(new_datetime)  # Вывод: 2023-06-22 14:30:45.123456

Примеры использования

Ниже приведены несколько примеров использования класса datetime в реальных задачах.

Пример 1: Разница между двумя датами и временем

import datetime

datetime1 = datetime.datetime(2023, 6, 27, 14, 30)
datetime2 = datetime.datetime(2023, 7, 1, 16, 45)

# Вычисление разницы
difference = datetime2 - datetime1
print(f"Разница: {difference}")  # Вывод: Разница: 4 days, 2:15:00

Пример 2: Изменение времени в существующем объекте datetime

import datetime

datetime_obj = datetime.datetime(2023, 6, 27, 14, 30, 45, 123456)

# Изменение времени
new_time = datetime_obj.replace(hour=16, minute=0)
print(new_time)  # Вывод: 2023-06-27 16:00:45.123456

datetime.timedelta: Разница между датами и временем

Класс datetime.timedelta в модуле datetime предназначен для работы с разницей между двумя датами и временем. Он позволяет представлять разницу в днях, секундах и микросекундах, а также выполнять арифметические операции с датами и временем. В этом разделе мы рассмотрим основные возможности класса timedelta и приведем примеры его использования.

Создание объектов timedelta

Для создания объекта timedelta используйте конструктор datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0), где все параметры являются необязательными и могут быть использованы для указания соответствующих временных интервалов.

import datetime

# Создание объекта timedelta
delta = datetime.timedelta(days=5, hours=3, minutes=30)
print(delta)  # Вывод: 5 days, 3:30:00

Арифметические операции с timedelta

Класс timedelta позволяет выполнять различные арифметические операции, такие как сложение, вычитание, умножение и деление. Эти операции могут быть выполнены как с объектами timedelta, так и с объектами datetime.

Сложение и вычитание

import datetime

# Сложение двух объектов timedelta
delta1 = datetime.timedelta(days=5)
delta2 = datetime.timedelta(hours=3)
result = delta1 + delta2
print(result)  # Вывод: 5 days, 3:00:00

# Вычитание объектов timedelta
result = delta1 - delta2
print(result)  # Вывод: 4 days, 21:00:00

Умножение и деление

import datetime

delta1 = datetime.timedelta(days=5)

# Умножение объекта timedelta на число
result = delta1 * 2
print(result)  # Вывод: 10 days, 0:00:00

# Деление объекта timedelta на число
result = delta1 / 2
print(result)  # Вывод: 2 days, 12:00:00

Использование timedelta с datetime

Одним из основных применений класса timedelta является работа с объектами datetime для вычисления новых дат и времени.

Добавление и вычитание timedelta из datetime

import datetime

delta = datetime.timedelta(days=5, hours=3, minutes=30)

current_datetime = datetime.datetime.now()
print("Текущая дата и время:", current_datetime)

# Добавление timedelta к datetime
new_datetime = current_datetime + delta
print("После добавления 5 дней и 3.5 часов:", new_datetime)

# Вычитание timedelta из datetime
new_datetime = current_datetime - delta
print("После вычитания 5 дней и 3.5 часов:", new_datetime)

Разница между двумя датами и временем

Вы можете использовать timedelta для вычисления разницы между двумя объектами datetime.

import datetime

datetime1 = datetime.datetime(2023, 6, 27, 14, 30)
datetime2 = datetime.datetime(2023, 7, 1, 16, 45)

# Вычисление разницы
difference = datetime2 - datetime1
print(f"Разница: {difference}")  # Вывод: Разница: 4 days, 2:15:00

Атрибуты и методы timedelta

Класс timedelta предоставляет несколько атрибутов и методов для работы с временными интервалами.

days, seconds и microseconds

Атрибуты days, seconds и microseconds позволяют извлекать соответствующие компоненты из объекта timedelta.

import datetime

delta = datetime.timedelta(days=5, hours=3, minutes=30)

print("Дни:", delta.days)  # Вывод: 5
print("Секунды:", delta.seconds)  # Вывод: 12600 (3 часа и 30 минут в секундах)
print("Микросекунды:", delta.microseconds)  # Вывод: 0

total_seconds()

Метод total_seconds() возвращает общее количество секунд, содержащееся в объекте timedelta.

import datetime

delta = datetime.timedelta(days=5, hours=3, minutes=30)

total_seconds = delta.total_seconds()
print("Общее количество секунд:", total_seconds)  # Вывод: 444600.0

Примеры использования

Ниже приведены несколько примеров использования класса timedelta в реальных задачах.

Пример 1: Вычисление даты и времени через заданный интервал

import datetime

# Вычисление даты через 10 дней
days_later = datetime.datetime.now() + datetime.timedelta(days=10)
print("Дата через 10 дней:", days_later)

Пример 2: Вычисление возраста на основе даты рождения

import datetime

def calculate_age(birth_date):
    today = datetime.datetime.now()
    age = today - birth_date
    return age.days // 365

birth_date = datetime.datetime(1990, 6, 27)
age = calculate_age(birth_date)
print("Возраст:", age)

# Вывод: Возраст: 34 (пример)

datetime.tzinfo и datetime.timezone: Работа с временными зонами

Работа с временными зонами может быть сложной, особенно при учете летнего времени и различных часовых поясов по всему миру. В Python для этой цели используются классы datetime.tzinfo и datetime.timezone. Они позволяют работать с объектами даты и времени, которые включают информацию о временной зоне.

datetime.tzinfo: Базовый класс для временных зон

Класс datetime.tzinfo является абстрактным базовым классом для всех объектов временной зоны. Этот класс не предназначен для прямого использования, но он может быть подклассом для создания собственных объектов временной зоны.

Создание подкласса tzinfo

Для создания собственного объекта временной зоны необходимо унаследовать класс tzinfo и реализовать методы utcoffset, dst и tzname.

import datetime

class SimpleUTC(datetime.tzinfo):
    def utcoffset(self, dt):
        return datetime.timedelta(hours=0)
    
    def dst(self, dt):
        return datetime.timedelta(0)
    
    def tzname(self, dt):
        return "UTC"

# Использование подкласса tzinfo
utc = SimpleUTC()
datetime_obj = datetime.datetime(2023, 6, 27, 14, 30, tzinfo=utc)
print(datetime_obj)  # Вывод: 2023-06-27 14:30:00+00:00

datetime.timezone: Предопределенные временные зоны

Класс datetime.timezone предоставляет стандартные реализации временных зон. Он поддерживает фиксированные смещения от UTC и предоставляет несколько удобных предопределенных объектов временных зон, таких как timezone.utc.

Использование datetime.timezone

Для создания объекта временной зоны с фиксированным смещением от UTC используйте datetime.timezone(offset, name=None), где offset — это объект timedelta, представляющий смещение от UTC, а name — необязательное имя временной зоны.

import datetime

# Создание объекта временной зоны с фиксированным смещением +5:30 от UTC
offset = datetime.timedelta(hours=5, minutes=30)
ist = datetime.timezone(offset, name="IST")
datetime_obj = datetime.datetime(2023, 6, 27, 14, 30, tzinfo=ist)
print(datetime_obj)  # Вывод: 2023-06-27 14:30:00+05:30

Работа с объектами datetime и временными зонами

Объекты datetime могут содержать информацию о временной зоне, что позволяет выполнять различные операции, учитывающие временные зоны.

Пример 1: Конвертация времени между часовыми поясами

# Создание объектов datetime в разных временных зонах
utc = datetime.timezone.utc
ist = datetime.timezone(datetime.timedelta(hours=5, minutes=30), "IST")

datetime_utc = datetime.datetime(2023, 6, 27, 14, 30, tzinfo=utc)
print("UTC время:", datetime_utc)  # Вывод: 2023-06-27 14:30:00+00:00

# Конвертация UTC времени в IST
datetime_ist = datetime_utc.astimezone(ist)
print("IST время:", datetime_ist)  # Вывод: 2023-06-27 20:00:00+05:30

Пример 2: Получение текущего времени в разных временных зонах

import datetime

ist = datetime.timezone(datetime.timedelta(hours=5, minutes=30), "IST")

# Получение текущего времени в UTC
current_utc = datetime.datetime.now(datetime.timezone.utc)
print("Текущее UTC время:", current_utc)

# Получение текущего времени в IST
current_ist = current_utc.astimezone(ist)
print("Текущее IST время:", current_ist)

Переход на летнее время (DST)

Метод dst класса tzinfo используется для определения перехода на летнее время. При реализации собственного класса временной зоны можно учитывать изменения времени, связанные с переходом на летнее и зимнее время.

Пример: Реализация временной зоны с учетом DST

class SimpleDST(datetime.tzinfo):
    def utcoffset(self, dt):
        return datetime.timedelta(hours=1) + self.dst(dt)
    
    def dst(self, dt):
        # Условие для перехода на летнее время (пример)
        if datetime.datetime(dt.year, 3, 29) <= dt.replace(tzinfo=None) < datetime.datetime(dt.year, 10, 25):
            return datetime.timedelta(hours=1)
        else:
            return datetime.timedelta(0)
    
    def tzname(self, dt):
        return "DST" if self.dst(dt) != datetime.timedelta(0) else "STD"

dst = SimpleDST()
datetime_obj = datetime.datetime(2023, 6, 27, 14, 30, tzinfo=dst)
print(datetime_obj)  # Вывод: 2023-06-27 14:30:00+02:00 (пример)

Форматирование и разбор строковых представлений даты и времени

В работе с датами и временем часто требуется конвертация объектов datetime в строковые представления и обратно. Для этого в Python используются методы strftime и strptime. В этом разделе мы рассмотрим, как форматировать даты и время в строки, а также как разбирать строки в объекты datetime.

Форматирование даты и времени: Метод strftime

Метод strftime позволяет преобразовать объект datetime в строку по заданному формату. Формат задается с использованием специальных символов, обозначающих компоненты даты и времени.

Основные символы форматирования

• %Y — год в формате 4 цифры (например, 2024)
• %y — год в формате 2 цифры (например, 24)
• %m — месяц (01-12)
• %B — полное название месяца (например, June)
• %b — краткое название месяца (например, Jun)
• %d — день месяца (01-31)
• %H — час в 24-часовом формате (00-23)
• %I — час в 12-часовом формате (01-12)
• %p — AM/PM
• %M — минуты (00-59)
• %S — секунды (00-59)
• %f — микросекунды (000000-999999)
• %A — полное название дня недели (например, Monday)
• %a — краткое название дня недели (например, Mon)
• %w — день недели (0-6, воскресенье — 0)
• %j — день года (001-366)

Примеры использования strftime

import datetime

# Создание объекта datetime
now = datetime.datetime.now()

# Форматирование даты и времени
formatted_date = now.strftime("%Y-%m-%d %H:%M:%S")
print("Форматированная дата и время:", formatted_date) # Вывод: Форматированная дата и время: 2024-07-07 13:42:53

formatted_date = now.strftime("%A, %B %d, %Y")
print("Форматированная дата:", formatted_date) # Вывод: Форматированная дата: Sunday, July 07, 2024

Разбор строковых представлений даты и времени: Метод strptime

Метод strptime позволяет преобразовать строку в объект datetime на основе заданного формата. Формат указывается так же, как и в strftime.

Примеры использования strptime

import datetime

# Разбор строки в формате "день/месяц/год"
date_string = "27/06/2024"
date_object = datetime.datetime.strptime(date_string, "%d/%m/%Y")
print("Разобранный объект datetime:", date_object) # Вывод: Разобранный объект datetime: 2024-06-27 00:00:00

# Разбор строки в формате "Полное название месяца день, год"
date_string = "June 27, 2024"
date_object = datetime.datetime.strptime(date_string, "%B %d, %Y")
print("Разобранный объект datetime:", date_object) # Вывод: Разобранный объект datetime: 2024-06-27 00:00:00

Форматирование даты с учетом локализации

При форматировании и разборе дат можно учитывать локализацию, чтобы корректно обрабатывать названия месяцев и дней недели на разных языках.

Пример: Форматирование даты с учетом локализации

import locale
import datetime

# Установка локали на русский язык
locale.setlocale(locale.LC_TIME, "ru_RU")

# Форматирование даты на русском языке
now = datetime.datetime.now()
formatted_date = now.strftime("%A, %d %B %Y")
print("Форматированная дата на русском:", formatted_date) # Вывод: Форматированная дата на русском: воскресенье, 07 июля 2024

# Восстановление локали по умолчанию
locale.setlocale(locale.LC_TIME, "")

Примеры практического применения

Пример 1: Логирование с временными метками

В логировании часто требуется добавлять временные метки к записям. Для этого можно использовать strftimeдля форматирования текущего времени.

import datetime

def log_message(message):
    timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
    print(f"[{timestamp}] {message}")

log_message("Программа запущена")
log_message("Произошла ошибка")

Пример 2: Разбор дат из CSV-файла

При работе с данными из CSV-файлов может понадобиться разбор строк с датами.

import csv
import datetime

with open("data.csv", mode="r") as file:
    reader = csv.reader(file)
    for row in reader:
        date_string = row[0]
        date_object = datetime.datetime.strptime(date_string, "%Y-%m-%d")
        print(f"Разобранная дата: {date_object}")

Методы и функции модуля datetime

Модуль datetime в Python предоставляет широкий набор методов и функций для работы с датами и временем. Эти методы и функции позволяют создавать, манипулировать и форматировать объекты даты и времени, а также выполнять различные операции с ними. В этом разделе мы рассмотрим основные методы и функции, доступные в модуле datetime.

datetime.date: Методы и функции

Создание объектов date

date(year, month, day): Создает объект даты с указанными годом, месяцем и днем

import datetime
d = datetime.date(2024, 6, 27)
print(d)  # Вывод: 2024-06-27

Методы объекта date

today(): Возвращает текущую дату

import datetime
today = datetime.date.today()
print(today)  # Вывод: (текущая дата)

fromtimestamp(timestamp): Создает объект даты из временной метки

import datetime
timestamp = 1624800000
date_from_timestamp = datetime.date.fromtimestamp(timestamp)
print(date_from_timestamp)  # Вывод: 2021-06-27

replace(year, month, day): Возвращает копию объекта даты с измененными значениями года, месяца и дня

import datetime
d = datetime.date(2024, 6, 27)
new_date = d.replace(year=2025)
print(new_date)  # Вывод: 2025-06-27

weekday(): Возвращает день недели (0 — понедельник, 6 — воскресенье)

day_of_week = d.weekday()
print(day_of_week)  # Вывод: день недели для 2024-06-27

isoformat(): Возвращает строковое представление даты в формате ISO 8601

import datetime
d = datetime.date(2024, 6, 27)
iso_date = d.isoformat()
print(iso_date)  # Вывод: 2024-06-27

datetime.time: Методы и функции

Создание объектов datetime

time(hour, minute, second, microsecond): Создает объект времени с указанными часом, минутой, секундой и микросекундой

import datetime
t = datetime.time(14, 30, 15, 500000)
print(t)  # Вывод: 14:30:15.500000

Методы объекта time

replace(hour, minute, second, microsecond): Возвращает копию объекта времени с измененными значениями часа, минуты, секунды и микросекунды

import datetime
t = datetime.time(14, 30, 15, 500000)
new_time = t.replace(hour=16)
print(new_time)  # Вывод: 16:30:15.500000

isoformat(): Возвращает строковое представление времени в формате ISO 8601

import datetime
t = datetime.time(14, 30, 15, 500000)
iso_time = t.isoformat()
print(iso_time)  # Вывод: 14:30:15.500000

datetime.datetime: Методы и функции

Создание объектов datetime

datetime(year, month, day, hour, minute, second, microsecond): Создает объект даты и времени с указанными параметрами

import datetime
dt = datetime.datetime(2024, 6, 27, 14, 30, 15, 500000)
print(dt)  # Вывод: 2024-06-27 14:30:15.500000

Методы объекта datetime

now(): Возвращает текущие дату и время

import datetime
current_datetime = datetime.datetime.now()
print(current_datetime)  # Вывод: (текущие дата и время)

fromtimestamp(timestamp): Создает объект даты и времени из временной метки

import datetime
timestamp = 1624800000
datetime_from_timestamp = datetime.datetime.fromtimestamp(timestamp)
print(datetime_from_timestamp)  # Вывод: 2021-06-27 16:20:00

replace(year, month, day, hour, minute, second, microsecond): Возвращает копию объекта даты и времени с измененными значениями

import datetime
dt = datetime.datetime(2024, 6, 27, 14, 30, 15, 500000)
new_datetime = dt.replace(year=2025, hour=16)
print(new_datetime)  # Вывод: 2025-06-27 16:30:15.500000

strftime(format): Возвращает строковое представление даты и времени согласно заданному формату

import datetime
dt = datetime.datetime(2024, 6, 27, 14, 30, 15, 500000)
formatted_datetime = dt.strftime("%Y-%m-%d %H:%M:%S")
print(formatted_datetime)  # Вывод: 2024-06-27 14:30:15

strptime(date_string, format): Преобразует строку в объект datetime согласно заданному формату

import datetime
date_string = "2024-06-27 14:30:15"
dt = datetime.datetime.strptime(date_string, "%Y-%m-%d %H:%M:%S")
print(dt)  # Вывод: 2024-06-27 14:30:15

datetime.timedelta: Методы и функции

Создание объектов timedelta

timedelta(days, seconds, microseconds, milliseconds, minutes, hours, weeks): Создает объект временного интервала

import datetime
delta = datetime.timedelta(days=5, hours=3, minutes=30)
print(delta)  # Вывод: 5 days, 3:30:00

Методы и операции с timedelta

Сложение и вычитание объектов timedelta с объектами datetime

import datetime
delta = datetime.timedelta(days=5, hours=3, minutes=30)
dt = datetime.datetime(2024, 6, 27, 14, 30)
new_dt = dt + delta
print(new_dt)  # Вывод: 2024-07-02 18:00:00
new_dt1 = dt - delta
print(new_dt1) # Вывод: 2024-06-22 11:00:00

Сложение и вычитание одного объекта timedelta из другого

import datetime
delta1 = datetime.timedelta(days=5)
delta2 = datetime.timedelta(days=2)
result_delta = delta1 - delta2
print(result_delta)  # Вывод: 3 days, 0:00:00
result_delta2 = delta1 + delta2
print(result_delta2)  # Вывод: 7 days, 0:00:00

datetime.tzinfo и datetime.timezone: Методы и функции

Создание объектов временной зоны

timezone(offset, name): Создает объект временной зоны с заданным смещением от UTC и необязательным именем

import datetime
offset = datetime.timedelta(hours=5, minutes=30)
ist = datetime.timezone(offset, name="IST")
print(ist)  # IST

Методы объекта timezone

tzname(dt): Возвращает имя временной зоны

import datetime
offset = datetime.timedelta(hours=5, minutes=30)
ist = datetime.timezone(offset, name="IST")
tz_name = ist.tzname(None)
print(tz_name)  # Вывод: IST

utcoffset(dt): Возвращает смещение от UTC

import datetime
offset = datetime.timedelta(hours=5, minutes=30)
ist = datetime.timezone(offset, name="IST")
utc_offset = ist.utcoffset(None)
print(utc_offset)  # Вывод: 5:30:00

Сравнение объектов datetime

Сравнение объектов datetime возможно с использованием операторов сравнения (<, <=, >, >=, ==, !=)

import datetime
dt1 = datetime.datetime(2024, 6, 27, 14, 30)
dt2 = datetime.datetime(2025, 6, 27, 14, 30)
print(dt1 < dt2)  # Вывод: True