ISO week number
Find the ISO 8601 week number of a date, or the Monday to Sunday date range of a given week.
Input
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
| Name | Type | Required | What 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.
Related tools
- Date parserRead a date written in a common human format and return it as ISO 8601 with weekday and week number.
date-parse - Date difference calculatorFind the time between two dates: total days, weeks, hours, minutes and seconds, plus years, months and days.
date-diff - Business days calculatorCount the working days between two dates, or add working days to a date, skipping weekends and holidays.
business-days - Add or subtract time from a dateAdd or subtract years, months, weeks, days, hours and minutes from a date and get the resulting date.
date-add - Age calculatorWork out an exact age in years, months and days on a given date, plus the next birthday.
age-calculator - Aspect ratio calculatorSimplify a width and height to a ratio such as 16:9, and scale to a new width or height.
aspect-ratio