ISO week number

Find the ISO 8601 week number of a date, or the Monday to Sunday date range of a given week.

Input

A date to find the week of. Leave empty when sending year and week.
ISO year, used together with week.
ISO week number, used together with year.

Result

Fill in the input and press Run.

Your input is processed in memory and then discarded. It is not stored or logged. Even so, don't paste live passwords or keys into any online tool.

Use it from code or an agent

curl -s https://setget.net/v1/tools/iso-week \
  -H 'Content-Type: application/json' \
  -d '{"input":{"date":"2024-12-30"}}'
import json, urllib.request

body = {'input': {'date': '2024-12-30'}}
request = urllib.request.Request("https://setget.net/v1/tools/iso-week", json.dumps(body).encode(),
                                 {"Content-Type": "application/json"})
print(json.load(urllib.request.urlopen(request))["result"])
const response = await fetch("https://setget.net/v1/tools/iso-week", {
  method: "POST",
  headers: {"Content-Type": "application/json"},
  body: JSON.stringify({"input":{"date":"2024-12-30"}}),
});
console.log((await response.json()).result);
Tool: run_tool
Arguments:
{
  "slug": "iso-week",
  "input": {
    "date": "2024-12-30"
  }
}
{
  "input": {
    "date": "2024-12-30"
  }
}

Endpoint: POST /v1/tools/iso-week. Over MCP: run_tool with slug: "iso-week". Machine-readable: input schema, Markdown. Connect an agent.

Inputs

NameTypeRequiredWhat it does
date string no A date to find the week of. Leave empty when sending year and week.
year integer no ISO year, used together with week. From 1 to 9999.
week integer no ISO week number, used together with year. From 1 to 53.

Examples

Input
{
  "date": "2024-12-30"
}
Result
{
  "iso_year": 2025,
  "week": 1,
  "weekday": 1,
  "weekday_name": "Monday",
  "label": "2025-W01",
  "start": "2024-12-30",
  "end": "2025-01-05",
  "weeks_in_year": 52
}

The dates of a week

Input
{
  "year": 2026,
  "week": 53
}
Result
{
  "iso_year": 2026,
  "week": 53,
  "weekday": null,
  "weekday_name": null,
  "label": "2026-W53",
  "start": "2026-12-28",
  "end": "2027-01-03",
  "weeks_in_year": 53
}

Questions

Why is the ISO year different from the calendar year?
ISO weeks run Monday to Sunday and week 1 is the week with the first Thursday of January. So the last days of December can belong to week 1 of the next year, and the first days of January to week 52 or 53 of the previous one.
Which years have 53 weeks?
Years that start on a Thursday, and leap years that start on a Wednesday.