ISO Week Number Calculator

ISO Week Number Introduction

ISO week numbering solves a problem that ordinary calendar dates do not: weekly planning needs a stable seven-day label, even when a month ends in the middle of that block. This calculator turns any date into its ISO week number and ISO year so you can see the exact week reference that accountants, schedulers, and project teams often rely on.

Under ISO-8601, each week starts on Monday, and week 1 is the week that contains the year’s first Thursday. That rule keeps the week system consistent from one year to the next and prevents the last few days of December or the first few days of January from being mislabeled. The calculator follows that standard directly, so the answer matches the convention used in many reports and planning tools.

When a date near New Year seems to land in the wrong year, the ISO system is usually doing exactly what it was designed to do. December 31 can belong to week 1 of the next ISO year, and January 1 can still belong to the last ISO week of the previous ISO year. This calculator handles those boundary cases for you and gives you a result that is easy to paste into a schedule, spreadsheet, or sprint board.

How to Use the ISO Week Number Calculator

Using this ISO week number calculator takes only a moment. Choose a date in the input below and press Calculate; the result will show both the ISO week number and the ISO year assigned to that week.

After you calculate, pay attention to both parts of the answer. For most dates in the middle of the year, the calendar year and ISO year are identical, but the edges of the year can cross into a different ISO year. A date like 2024-12-31 can therefore appear as ISO week 1 of ISO year 2025, while the first days of January may still belong to week 52 or 53 of the prior ISO year. If you want to reuse the answer elsewhere, the Copy Result button lets you move it into another note or document.

The simplest way to read the output is to think in Monday-to-Sunday blocks. The calculator is not counting months or trying to follow the printed year on the date field; it is identifying the ISO week that contains that date according to the global week standard.

ISO Week Number Formula

The ISO week calculation starts by turning the selected date into an ordinal day, shown as $d$. Next we determine the ISO weekday, where Monday equals 1 and Sunday equals 7. With those pieces in place, the week number $w$ is obtained using:

Formula: w = ⌊ (d + 6 - k) / 7 ⌋ + 1

$$w=\lfloor \frac{d+6-k}{7}\rfloor +1$$

In this expression $k$ is the ISO weekday for January 1 of the given year. You can calculate $k$ with Zeller’s congruence or any equivalent weekday routine. The formula shifts the year so that week 1 is anchored by the first Thursday in January. If the preliminary result is zero, the date belongs to the final ISO week of the previous year. Values above 52 or 53 can likewise indicate that the date has moved into week 1 of the next ISO year, depending on how many ISO weeks that year contains.

The browser code below follows a compact Thursday-shift method instead of a long calendar table. It moves the chosen date to the Thursday in the same ISO week, finds the start of that ISO year in UTC, and counts whole seven-day intervals from there. That approach produces the same ISO answer while keeping leap years and December-to-January transitions under control.

That is why ISO week results can look surprising at the year boundary. The formula is not trying to preserve the printed calendar year on the date itself; it is trying to preserve the integrity of full Monday-through-Sunday weeks. For planning work, that is often exactly the behavior you want.

ISO Week Number Example

Take 2024-12-31, a Tuesday, as a boundary case for ISO week numbering. The printed calendar year says 2024, but the ISO system asks which Monday-to-Sunday block contains that date. Since the same week also contains Thursday, 2025-01-02, the ISO year for the entire week is 2025. The calculator therefore returns ISO week 1 of ISO year 2025.

Now compare 2025-01-05, a Sunday. It sits in the very same ISO week as the last days of December 2024, so it also lands in ISO week 1 of ISO year 2025. That is the part that usually surprises people: the ISO year follows the week block, not the left edge of the printed calendar page.

A second boundary example is the opening days of January in a year whose first Thursday has not arrived yet. In that case, January 1, 2, or 3 can still belong to week 52 or 53 of the previous ISO year. When you label payroll periods, sprint boards, or weekly dashboards, that distinction keeps every date in the correct seven-day block.

ISO Week Number Limitations and Assumptions

This ISO week number calculator follows ISO-8601 only. It does not switch to Sunday-start calendars, regional week-one rules, or custom fiscal definitions. If another tool uses a different standard, the week number can change even when the date is identical.

The calculation assumes the modern Gregorian calendar and uses the browser’s date picker as its input path. Internally, the selected date is normalized to a UTC-based calculation, which keeps time-of-day and daylight-saving changes from nudging the answer. That is a good fit for everyday planning, but historical dates outside the Gregorian framework would need a different calendar model.

Why ISO Week Numbers Matter

ISO week numbers are useful anywhere work moves in weekly blocks. Payroll teams, production planners, academic schedulers, and agile crews all benefit from one shared week label that always starts on Monday. That consistency makes year-over-year comparisons easier because week 12 this year means the same type of seven-day span as week 12 last year.

Calendars, spreadsheets, and project trackers often display week numbers in their own way, but ISO-8601 removes the ambiguity. The same label maps to the same Monday-through-Sunday range for everyone, instead of shifting because one system starts the week on Sunday and another starts on Monday. That matters most when teams, suppliers, or clients read the same schedule from different countries or tools.

ISO Week Number Algorithm Details

The browser logic for ISO week numbering mirrors the standard in a few compact steps. After the input date is parsed, the script finds the day-of-year value by comparing the date with January 1 and adjusting for leap years. It then determines the weekday with the built-in Date object, mapping Sunday to 7 so the ISO convention stays intact. With $k$ set to the ISO weekday of January 1, the formula above produces a first-pass week number.

If that first-pass value is zero, the date really belongs to the previous ISO year’s final week. In that case the code checks the prior year’s length, uses December 31 of the previous year, and reruns the same logic. If the value is greater than 52, the code tests whether the current ISO year has a valid week 53. ISO rules give a year 53 weeks when it is a leap year beginning on Thursday or a common year beginning on Wednesday. If neither condition applies, the date rolls into week 1 of the next ISO year.

The shorter script on this page uses the same idea in Thursday-shift form. It moves the selected date to the Thursday in its ISO week, finds the UTC start of that ISO year, and counts whole seven-day intervals from there. The code stays compact, but the result still follows the ISO rules described above. That is what makes the calculator quick, private, and easy to inspect.

Sample ISO Week Numbers Near Year Boundaries

These sample ISO week numbers show how the label can jump across a year boundary without warning. The effect is easiest to see in late December and the first week of January, where the ISO year and the calendar year often diverge.

These examples show how week numbers wrap from one ISO year to another. December 31 can point to week 1 of the next year, which is why New Year’s Eve sometimes carries the following year’s week label. That behavior is exactly what ISO-8601 is designed to standardize.

Practical ISO Week Number Use Cases

ISO week numbers are useful anywhere a schedule repeats in seven-day blocks. Farmers, shipping teams, and religious calendars all relied on weekly cycles long before modern software, and the ISO standard keeps that rhythm consistent inside digital tools.

A construction manager can use week numbers to map a 40-week project without worrying about month lengths. A production planner can point to week 18 or week 19 and know that the whole crew is discussing the same date range, not a date that gets interpreted differently by each department.

Agile software teams also benefit from ISO week labels when they plan sprints and release calendars. A two-week sprint, a weekly stand-up rotation, or a test window marked by week number is easier to reference than a date that has to be translated across time zones and month boundaries.

Week labels are just as helpful in education and personal planning. Teachers can reference week 15 of a term, runners can log mileage by week, and habit trackers can group progress into clean Monday-to-Sunday blocks that are easy to review later.

Because this calculator runs in the browser, the date stays on the page and the answer appears immediately. Pick a date, calculate the week number, and use the Copy Result button if you want to move the answer into a note, spreadsheet, or chat message.

Leap years matter because they change the ordinal day count after February 29. The ISO result still stays correct because the algorithm accounts for the extra day before it counts the seven-day blocks.

The January boundary is the other place where week numbers do their most useful work. Data from January 1 can belong to the prior ISO year, so the calculator shows both the week and the ISO year instead of assuming the printed year is always the right one.

If you use fiscal calendars such as 4-4-5 layouts, ISO weeks still provide a reliable bridge between a calendar date and a weekly reporting period. The numbering system does not replace a fiscal calendar, but it gives you a consistent starting point when you need to convert dates quickly.

ISO Week Number Conclusion

Whether you are comparing reports, planning a project, or trying to decode a date at the turn of the year, ISO week numbers turn a calendar date into a stable weekly label. This calculator follows the ISO-8601 rule set, so you can see the week number and ISO year without having to count Mondays by hand.

For more date-planning help, try the date addition calculator, the date difference tool, and the agile sprint velocity calculator to line up timelines, retrospectives, and sprints alongside your ISO week plan.