from datetime import datetime


def 取当前分钟() -> int:
    """返回当前系统分钟数。

    功能说明:
        - 这个函数用于获取当前时间里的分钟部分。
        - 返回结果是整数，范围是 ``0`` 到 ``59``。
        - 适合做时间展示、分钟级判断或拼接提示语。

    Returns:
        返回当前分钟，例如 ``25``。
    """
    return datetime.now().minute


if __name__ == "__main__":
    print("===== 示例1：直接获取当前分钟 =====")
    print("结果:", 取当前分钟())

    print("\n===== 示例2：查看返回值类型 =====")
    结果 = 取当前分钟()
    print("结果:", 结果, "类型:", type(结果).__name__)

    print("\n===== 示例3：判断是否过了半点 =====")
    print("结果:", 取当前分钟() >= 30)

    print("\n===== 示例4：用于拼接时间提示 =====")
    提示 = f"当前分钟：{取当前分钟()} 分"
    print("结果:", 提示)

    print("\n===== 示例5：连续调用两次 =====")
    print("结果1:", 取当前分钟())
    print("结果2:", 取当前分钟())

    print("\n===== 示例6：应用场景-每到 30 分提醒一次 =====")
    是否提醒 = 取当前分钟() == 30
    print("是否触发提醒:", 是否提醒)
