跳到主要内容

ISO 周数计算器

API reference

查询任意日期的 ISO 8601 周数(1–53)和 ISO 周年,并显示该周从周一到周日的日期范围。正确处理 ISO 周年与日历年不一致的跨年日期。

输入

选择任意日历日期,即可查看其 ISO 8601 周数和所在周的日期范围。

输出

结果
属性值
No data yet
这对您有帮助吗?

使用此工具的更多方式

REST API

curl -X POST https://api.iotools.cloud/v1/tool/iso-week-number-calculator \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2020-06-15"
  }'

替换成您账户中的密钥。工具的字段即为请求体——没有额外包装。

让 AI 代理执行

Use the IOTools `iso-week-number-calculator` tool (ISO Week Number Calculator) on this input:

YOUR_INPUT_HERE

将此粘贴给任何已连接 IOTools MCP 服务器的代理,再加上您的输入内容。

嵌入式小组件

<iframe
  src="https://iotools.cloud/embed/iso-week-number-calculator/"
  width="100%" height="520" frameborder="0" scrolling="no" loading="lazy"
  title="ISO 周数计算器 — iotools.cloud"
  sandbox="allow-scripts allow-forms allow-same-origin allow-downloads allow-popups allow-popups-to-escape-sandbox"
  allow="clipboard-write"
  style="width:100%;border:1px solid #e5e7eb;border-radius:12px;overflow:hidden"></iframe>
<script src="https://iotools.cloud/embed.js" async></script>

把它放到您自己的页面上——免费,无需密钥,只需保留一个反向链接。

每次 API/MCP 调用费用5 积分起
需要更多积分?查看定价

也可通过

使用指南

ISO 周数计算器可以告诉您某个日历日期属于 ISO 8601 中的哪一周。选择任意日期,您即可立即看到它的 ISO 周数(1 到 53 之间的数值)、ISO 周年、组合标签 YYYY-Www(例如 2020-W25)、星期几,以及该周从周一到周日的日期范围。它还会告诉您该 ISO 年是否为拥有 53 周的长年。

所有计算都在您的浏览器中完成。您输入的日期不会上传到任何地方。

使用方法

  1. 通过日期选择器选择日期(或以 YYYY-MM-DD 格式输入)。
  2. 查看结果表格:ISO 周数、ISO 周年、YYYY-Www 标签、星期几,以及该周的第一天(周一)和最后一天(周日)。
  3. 复制表格,或将其下载为 CSV。

只要您更改日期,结果便会自动更新。

ISO 8601 周的规则是什么

ISO 8601 标准对周的定义十分精确,使每个日期在全球范围内都只属于一个周,不存在歧义:

  • 每周从周一开始,到周日结束。
  • 第 1 周是包含该年第一个星期四的那一周,也就是包含 1 月 4 日的那一周。因此,第 1 周总是新年中拥有多数天数(四天或以上)的第一周。
  • 由于一周可能跨越元旦,日期的 ISO 周年可能与其日历年不同。12 月的最后几天可能属于下一年的第 1 周,而 1 月的前几天可能属于上一年的第 52 或第 53 周。

为什么年份可能与日历年不同?

由于整周会归入包含其星期四的那一年,年初和年末的日子会被“拉”到相邻的年份。例如,2018 年 12 月 31 日(星期一)与 2019 年 1 月 3 日(星期四)处于同一周,因此属于 2019 年第 1 周。反过来,2017 年 1 月 1 日(星期日)与 2016 年 12 月 29 日(星期四)共享同一周,因此属于 2016 年第 52 周。这是符合预期的行为,并非错误。ISO 周年字段会显示应与周数搭配的正确年份。

一年什么时候有 53 周?

大多数 ISO 年有 52 周。当某年从星期四开始,或者是从星期三开始的闰年时,它就会有第 53 周。例如,2020 年是一个长年:2020 年 12 月 31 日是星期四,位于第 53 周。

哪些日期有效?

任何真实存在的日历日期都有效,包括 2 月 29 日这样的闰日。不可能存在的日期(如 2 月 30 日)会被拒绝。所有计算均以 UTC 进行,因此结果不会因您所在的本地时区而改变。

隐私

本计算器完全在客户端运行。您输入的日期在您自己的设备上处理,绝不会发送到服务器、被记录或被存储。

dateiso 8601week numberiso weekcalendarweek of year

喜欢这些工具?去掉广告吧。

一次性付款即可永久移除您账户中的所有广告。无需订阅,不追踪。