DST Calendar

from datetime import datetime, timedelta
import pytz  # pip install pytz

def get_dst_transitions(tz_name: str, year: int) -> dict:
    """Get DST start and end dates for a timezone in a given year."""
    tz = pytz.timezone(tz_name)
    transitions = []

    # Check each day of the year for offset changes
    prev_offset = None
    for day in range(365 + (1 if year % 4 == 0 else 0)):
        dt = datetime(year, 1, 1) + timedelta(days=day)
        localized = tz.localize(dt)
        offset = localized.utcoffset()
        if prev_offset is not None and offset != prev_offset:
            transitions.append({
                "date": dt.strftime("%Y-%m-%d"),
                "from_offset": str(prev_offset),
                "to_offset": str(offset),
                "type": "start" if offset > prev_offset else "end",
            })
        prev_offset = offset
    return {"timezone": tz_name, "year": year, "transitions": transitions}

# Example
info = get_dst_transitions("America/New_York", 2024)
for t in info["transitions"]:
    print(f"DST {t['type']}: {t['date']} ({t['from_offset']} -> {t['to_offset']})")