from datetime import datetime


def 是否本年(时间字符串: str) -> bool:
    """判断某个时间是不是在本年内。

    功能说明:
        - 这个函数用于判断传入时间的年份是否和当前年份相同。
        - 输入内容必须是 ``YYYY-MM-DD HH:MM:SS`` 格式。
        - 只比较年份，不比较月份和日。
        - 输入格式不正确时，函数返回 ``False``。

    Args:
        时间字符串: 要判断的时间字符串。

    Returns:
        属于本年返回 ``True``，否则返回 ``False``。
    """
    try:
        输入时间 = datetime.strptime(时间字符串.strip(), "%Y-%m-%d %H:%M:%S")
        当前时间 = datetime.now()
        return 输入时间.year == 当前时间.year
    except Exception:
        return False


if __name__ == "__main__":
    今天时间 = datetime.now().strftime("%Y-%m-%d %H:%M:%S")

    print("===== 示例1：传入今天的时间 =====")
    print("结果:", 是否本年(今天时间))

    print("\n===== 示例2：传入本年其他月份 =====")
    print("结果:", 是否本年(datetime.now().strftime("%Y-01-01 08:00:00")))

    print("\n===== 示例3：传入其他年份时间 =====")
    print("结果:", 是否本年("2020-01-01 12:00:00"))

    print("\n===== 示例4：输入错误格式 =====")
    print("结果:", 是否本年("2026/03/20"))

    print("\n===== 示例5：输入空字符串 =====")
    print("结果:", 是否本年(""))

    print("\n===== 示例6：应用场景-筛选本年成交记录 =====")
    print("是否本年成交:", 是否本年(今天时间))
