时间进度 API

今年、本季度、本月、本周、今天分别过去了百分之多少，附进度条和可直接发送的中文文案（北京时间），适合聊天机器人

数据来源：本地计算（北京时间）

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

年 / 季度 / 月 / 周 / 日时间进度

GET /api/progress

请求参数

  • date：按指定时间计算：YYYY-MM-DD（按当天结束 24:00 计算）或 YYYY-MM-DD HH:mm（北京时间）；默认当前时刻，示例 2026-09-29
  • width：进度条长度（字符数）5–50，示例 10

返回字段

  • now（string）：计算所用的北京时间 YYYY-MM-DD HH:mm（只传日期时为 YYYY-MM-DD 24:00）
  • weekday（string）：星期几，如 星期一
  • weekNumber（number）：ISO 周数（周一为一周开始，1–53）
  • year（object）：今年的进度
  • year.key（string）：周期键名，固定为 year
  • year.label（string）：周期中文简称：年 / 季度 / 月 / 周 / 日
  • year.name（string）：周期名称，如 2026 年、第三季度、9 月、本周（第 39 周）、今天
  • year.start（string）：周期开始日期 YYYY-MM-DD
  • year.end（string）：周期最后一天 YYYY-MM-DD（含）
  • year.percent（number）：已过去的百分比（0–100，保留 2 位小数，精确到当前时刻）
  • year.total（number）：周期总长度（天）
  • year.elapsed（number）：已完整过去的天数
  • year.remaining（number）：剩余的完整天数（不含正在进行的这一天）
  • year.unit（string）：elapsed / remaining / total 的单位：天
  • year.bar（string）：ASCII 进度条，▓ 为已过去、░ 为剩余，长度由 width 参数决定
  • year.text（string）：一句话中文，如 2026 年已过去 74.52%，还剩 93 天
  • quarter（object）：本季度的进度
  • quarter.key（string）：周期键名，固定为 quarter
  • quarter.label（string）：周期中文简称：年 / 季度 / 月 / 周 / 日
  • quarter.name（string）：周期名称，如 2026 年、第三季度、9 月、本周（第 39 周）、今天
  • quarter.start（string）：周期开始日期 YYYY-MM-DD
  • quarter.end（string）：周期最后一天 YYYY-MM-DD（含）
  • quarter.percent（number）：已过去的百分比（0–100，保留 2 位小数，精确到当前时刻）
  • quarter.total（number）：周期总长度（天）
  • quarter.elapsed（number）：已完整过去的天数
  • quarter.remaining（number）：剩余的完整天数（不含正在进行的这一天）
  • quarter.unit（string）：elapsed / remaining / total 的单位：天
  • quarter.bar（string）：ASCII 进度条，▓ 为已过去、░ 为剩余，长度由 width 参数决定
  • quarter.text（string）：一句话中文，如 2026 年已过去 74.52%，还剩 93 天
  • month（object）：本月的进度