from datetime import datetime


def 取当前日() -> int:
    """返回当前系统日期中的“日”。

    功能说明:
        - 这个函数用于获取今天是本月的第几天。
        - 返回结果是整数，范围通常是 ``1`` 到 ``31``。
        - 适合做日历显示、按日统计或日期判断。

    Returns:
        返回当前日，例如 ``20``。
    """
    return datetime.now().day


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

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

    print("\n===== 示例3：判断是否是月初前 10 天 =====")
    print("结果:", 取当前日() <= 10)

    print("\n===== 示例4：用于拼接日期提示 =====")
    提示 = f"今天是本月第 {取当前日()} 天"
    print("结果:", 提示)

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

    print("\n===== 示例6：应用场景-给日报打上日期标签 =====")
    标签 = f"day_{取当前日():02}"
    print("标签:", 标签)
