import calendar


def 取某年天数(年份: int) -> int | None:
    """返回指定年份一共有多少天。

    功能说明:
        - 这个函数用于查看某一年总共有 365 天还是 366 天。
        - 闰年返回 366，平年返回 365。
        - 年份不合法时，函数返回 ``None``。

    Args:
        年份: 要查询的年份。

    Returns:
        成功时返回年份天数；失败时返回 ``None``。
    """
    try:
        年份 = int(年份)
        if 年份 <= 0:
            return None
        return 366 if calendar.isleap(年份) else 365
    except Exception:
        return None


if __name__ == "__main__":
    print("===== 示例1：查询平年天数 =====")
    print("结果:", 取某年天数(2026))

    print("\n===== 示例2：查询闰年天数 =====")
    print("结果:", 取某年天数(2024))

    print("\n===== 示例3：传入字符串年份 =====")
    print("结果:", 取某年天数("2000"))

    print("\n===== 示例4：年份为 0 =====")
    print("结果:", 取某年天数(0))

    print("\n===== 示例5：输入非法内容 =====")
    print("结果:", 取某年天数("二零二六"))

    print("\n===== 示例6：应用场景-判断这一年是否需要 366 天日历页 =====")
    print("结果:", 取某年天数(2028))
