from datetime import datetime, timedelta

ZI_HOUR_START = 23  # 真太阳时 23:00 换日


def resolve_calendar_day(tst: datetime) -> tuple[datetime, dict]:
    """
    子初换日：真太阳时 23:00–24:00 归入次日。

    返回
      (日历日 00:00 的 datetime, flag)
    """
    is_late_zi = tst.hour == ZI_HOUR_START

    day = tst.replace(hour=0, minute=0, second=0, microsecond=0)
    if is_late_zi:
        day += timedelta(days=1)

    return day, {
        "rule": "子初换日@真太阳时23:00",
        "is_late_zi": is_late_zi,
        "tst_time": tst.strftime("%Y-%m-%d %H:%M:%S"),
    }