Разница между датами: от простого timedelta до сложных вычислений

Расширенные примеры вычисления разницы дат

1. Массовая разница дат с помощью pandas

При работе с таблицами удобно использовать pandas. Разница между столбцами дат вычисляется векторно и даёт Timedelta.

import pandas as pd

df = pd.DataFrame({
    "start": ["2025-03-01", "2025-03-10"],
    "end": ["2025-03-15", "2025-03-20"]
})
df["start"] = pd.to_datetime(df["start"])
df["end"] = pd.to_datetime(df["end"])
df["delta"] = df["end"] - df["start"]
print(df)

       start        end    delta
0 2025-03-01 2025-03-15 14 days
1 2025-03-10 2025-03-20 10 days

# Извлечение компонент
print(df["delta"].dt.days)
print(df["delta"].dt.total_seconds())

0    14
1    10
Name: delta, dtype: int64

0    1209600.0
1     864000.0
Name: delta, dtype: float64

Пояснение: pandas преобразует строки в datetime, вычитание даёт TimedeltaArray, который можно сериализовать. Метод .dt.days извлекает дни, .dt.total_seconds() - секунды.

2. Точное измерение времени с помощью timeit

Модуль timeit многократно выполняет код и усредняет результат, исключая накладные расходы.

import timeit

code = """
def test():
    s = 0
    for i in range(1000):
        s += i**2
    return s
test()
"""

result = timeit.timeit(stmt=code, number=10000)
print(f"Среднее время: {result / 10000:.8f} сек")

Среднее время: 0.00009123 сек

Пояснение: timeit.timeit принимает строку кода и количество повторений (number). Возвращает общее время. Можно также использовать repeat для нескольких серий.

3. Форматирование timedelta в читаемый вид

Иногда требуется представить разницу в виде "2 days 5 hours 30 minutes". Напишем функцию.

from datetime import timedelta

def format_timedelta(delta):
    total_sec = int(delta.total_seconds())
    days, rest = divmod(total_sec, 86400)
    hours, rest = divmod(rest, 3600)
    minutes, seconds = divmod(rest, 60)
    parts = []
    if days:
        parts.append(f"{days} дн")
    if hours:
        parts.append(f"{hours} ч")
    if minutes:
        parts.append(f"{minutes} мин")
    if seconds:
        parts.append(f"{seconds} с")
    return " ".join(parts) if parts else "0 с"

print(format_timedelta(timedelta(seconds=123456)))

1 дн 10 ч 17 мин 36 с

Пояснение: Функция использует total_seconds() для надёжности (избегает проблем с отрицательными значениями). Для пустого результата возвращается "0 с".

4. Сравнение дат с разными часовыми поясами

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

from datetime import datetime
from zoneinfo import ZoneInfo

# Лондон (BST летом) и Нью-Йорк (EDT летом)
london = ZoneInfo("Europe/London")
nyc = ZoneInfo("America/New_York")

dt_london = datetime(2025, 6, 15, 12, 0, tzinfo=london)  # 12:00 BST
dt_nyc = datetime(2025, 6, 15, 7, 0, tzinfo=nyc)          # 07:00 EDT

# Прямое вычитание
print("Разница:", dt_london - dt_nyc)

# Приведение к UTC
utc = ZoneInfo("UTC")
dt_london_utc = dt_london.astimezone(utc)
dt_nyc_utc = dt_nyc.astimezone(utc)
print("Разница по UTC:", dt_london_utc - dt_nyc_utc)

Разница: 0:00:00
Разница по UTC: 0:00:00

Пояснение: В данном примере оба времени соответствуют одному и тому же моменту (12:00 BST = 07:00 EDT = 11:00 UTC). Вычитание aware объектов даёт правильный ноль. Приведение к UTC - дополнительная верификация.

5. Обработка исключений при парсинге строк с датами

При вычислении разницы по введённым строкам следует перехватывать ошибки формата.

from datetime import datetime

user_input = ["2025-03-15", "2025/03/10", "не дата"]

for s in user_input:
    try:
        dt = datetime.strptime(s, "%Y-%m-%d")
        print(f"Успех: {dt}")
    except ValueError:
        print(f"Ошибка: '{s}' не соответствует формату")

Успех: 2025-03-15 00:00:00
Ошибка: '2025/03/10' не соответствует формату
Ошибка: 'не дата' не соответствует формату

Пояснение: Функция strptime выбрасывает ValueError, если строка не совпадает с шаблоном. Рекомендуется использовать гибкие парсеры (например, dateutil.parser.parse) или нормализовать входные данные.

6. Вычисление возраста (разница в годах с точностью до дня рождения)

Для точного возраста в годах используется relativedelta.

from dateutil.relativedelta import relativedelta
from datetime import date

birthday = date(1990, 5, 20)
today = date(2025, 3, 15)

rd = relativedelta(today, birthday)
# Проверка, был ли уже день рождения в этом году
if (today.month, today.day) < (birthday.month, birthday.day):
    years = rd.years
else:
    years = rd.years

print(f"Возраст: {years} лет, {rd.months} мес, {rd.days} дн")

Возраст: 34 лет, 9 мес, 23 дн

Пояснение: relativedelta автоматически вычисляет разницу с учётом неполных месяцев. Вышеприведённая проверка необязательна, если нужен именно «количество полных лет» от даты рождения до текущей даты - достаточно rd.years. Но в примере показан классический подсчёт возраста.