from datetime import datetime


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

    功能说明:
        - 这个函数用于获取当前是几点钟。
        - 返回结果是 24 小时制整数，范围是 ``0`` 到 ``23``。
        - 适合做时段判断、整点任务和页面显示。

    Returns:
        返回当前小时，例如 ``16``。
    """
    return datetime.now().hour


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

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

    print("\n===== 示例3：判断当前是否是上午 =====")
    print("结果:", 取当前小时() < 12)

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

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

    print("\n===== 示例6：应用场景-根据小时决定展示白天还是夜间文案 =====")
    文案 = "白天模式" if 6 <= 取当前小时() < 18 else "夜间模式"
    print("结果:", 文案)
