time calculator

Week Number Calculator

Find the ISO week number (W01–W53) and ISO year for any date in seconds.

Results

ISO week
2.00
ISO year
2025.00
Week label
2025-W02

Overview

When sprint plans, release calendars, or logistics timelines reference W12 or W36, this week number calculator translates any calendar date into its official ISO week and ISO year. It follows the ISO 8601 week-date system, which is the standard many global tools use, so you can keep everyone aligned on which week you actually mean.

How to use this calculator

  1. Enter a date by specifying the calendar year, month, and day.
  2. The calculator interprets that date using the Gregorian calendar and applies ISO 8601 week rules.
  3. Review the ISO week number, ISO year, and a formatted label such as 2025-W02 or 2026-W01.
  4. Use the label consistently across sprint boards, roadmaps, and reports so everyone is working off the same week reference.

Inputs explained

Year
The calendar year of the date you’re checking (for example, 2024 or 2025). Note that the ISO year returned may differ for dates near New Year’s.
Month
Calendar month number from 1 to 12 (1 = January, 12 = December). You can think in terms of standard calendar dates; the ISO logic handles the underlying week mapping.
Day
Day of the month (1–31, depending on month and leap year). The calculator validates the day-month-year combination against the Gregorian calendar.

Outputs explained

ISO week
The ISO 8601 week number for the given date, from W01 up to W52 or W53. This week index resets to 1 at the start of each ISO year, which is defined by the week containing January 4.
ISO year
The ISO week-year associated with the date. For dates near the start or end of the calendar year, the ISO year may be the previous or next calendar year (for example, December 31 may belong to ISO year 2026 rather than 2025).
Week label
A combined label like 2025-W02 or 2026-W01 that joins the ISO year and ISO week in a standard format you can reuse in issue trackers, spreadsheets, and filenames.

How it works

The calculator uses ISO 8601 rules, where weeks start on Monday and ISO Week 1 is defined as the week containing the first Thursday of the calendar year (equivalently, the week containing January 4).

Because of this definition, ISO weeks are always full Monday–Sunday blocks, and some dates at the beginning or end of a calendar year actually belong to the previous or next ISO year.

Internally, the code converts your year–month–day input into a date object, derives the correct ISO week-year and week number using a standard ISO algorithm, and then formats a label like 2025-W02.

The outputs include the numeric ISO week (1–52 or 1–53), the ISO year (which may differ from the calendar year near New Year’s), and a combined week label you can paste directly into planning docs.

Formula

ISO 8601 week rules:\n1) Weeks start on Monday.\n2) ISO Week 1 is the week containing January 4 (first Thursday of the year).\n3) The ISO year may differ from the calendar year for dates near New Year’s.\nImplementation uses a standard algorithm equivalent to language helpers like `getISOWeek` and `getISOWeekYear`.

When to use it

  • Coordinating software releases, agile sprints, or OKR check-ins that are scheduled by ISO week rather than by calendar month.
  • Aligning transportation, manufacturing, or maintenance operations with partners and suppliers who communicate in week numbers.
  • Building content, editorial, or analytics reporting calendars using ISO week labels so recurring items are easy to group and compare year over year.
  • Normalizing logs and exports from systems that tag activity by ISO year and week, allowing you to map those labels back to calendar dates when needed.
  • Quickly checking whether two dates fall into the same ISO week or cross a week-year boundary before shifting deadlines or grouping work.

Tips & cautions

  • Remember that ISO weeks start on Monday. If your local workweek starts on Sunday, expect some weeks to appear shifted compared with a Sunday-start calendar.
  • Because Week 1 is defined by the first Thursday, early January dates can belong to the prior ISO year, and late December dates may belong to Week 1 of the following ISO year.
  • Use the ISO week label (for example, 2025-W10) in both internal tools and client communication to avoid ambiguity about which week you mean.
  • Pair this tool with the day-of-week calculator to get a complete view: ISO week, ISO year, and specific weekday for any key date.
  • If your organization uses a custom retail or 4-4-5 calendar, treat this as an ISO baseline and maintain a separate mapping between ISO weeks and your internal week numbers.
  • Uses ISO 8601 rules only; retail calendars, 4-4-5 patterns, and custom fiscal week systems may define week numbers differently.
  • Assumes the proleptic Gregorian calendar for all dates. Historical transitions from other calendars are not modeled.
  • Does not provide direct mapping to quarter-based or fiscal week systems; those require separate business-specific rules.
  • Output follows Monday-start ISO conventions and does not reflect locales that define Week 1 or the start of the week differently.

Worked examples

January 6, 2025

  • Input date: 2025-01-06.
  • Under ISO rules, weeks start on Monday and Week 1 contains January 4.
  • January 6, 2025 falls in ISO week 02 of ISO year 2025.
  • Week label = 2025-W02.

December 31, 2025

  • Input date: 2025-12-31.
  • Under ISO 8601, this date can belong to ISO Week 1 of the following ISO year.
  • For 2025, December 31 is in ISO week 01 of ISO year 2026.
  • Week label = 2026-W01, even though the calendar year is 2025.

Checking a week crossover around New Year’s

  • Plug in December 30, 2024 and January 2, 2025.
  • You may see that both dates fall in the same ISO week and ISO year even though they span different calendar years.
  • This helps you treat that entire Monday–Sunday block as a single planning week.

Deep dive

This week number calculator converts any calendar date into its ISO week number (W01–W52 or W53) and ISO year, returning a ready-to-use label like 2025-W06 in seconds.

Use it to align sprint plans, release schedules, logistics timelines, and content calendars with the ISO 8601 week system used by many project management and reporting tools. The calculator makes it easy to see when dates near New Year’s fall into the previous or next ISO year.

Because it follows the ISO Monday-start convention, it’s especially helpful for global teams that need a shared, unambiguous way to reference weeks across time zones and regions.

FAQs

What calendar rules does this follow?
The calculator uses ISO 8601 week-date rules: Monday is the first day of the week, and ISO Week 1 is the week that contains the first Thursday of the calendar year (or equivalently January 4). All dates are interpreted under the proleptic Gregorian calendar.
Why is December 31 sometimes in Week 1 of the next ISO year?
ISO weeks are tied to week structure, not strictly to calendar year boundaries. If the last few days of December form part of the ISO week that contains January 4 of the next year, those days belong to the next ISO year’s Week 1.
Can I use this for systems that start weeks on Sunday?
You can, but you should be aware that the output follows ISO Monday-start rules. If your internal reports use Sunday-start weeks or a different Week 1 definition, the week numbers may not match one-for-one.
Does time of day or time zone affect the week result?
No. The calculator works purely on the calendar date, not the clock time. Time zones and daylight saving time do not change which ISO week a date belongs to in this model.
Is this suitable for retail or 4-4-5 calendars?
Retail, 4-4-5, and other fiscal calendars use their own week numbering schemes. This calculator gives ISO week numbers only; you would need a separate mapping to your specific retail or fiscal calendar.

Related calculators

This week number calculator is for general planning and scheduling purposes only. It assumes the Gregorian calendar and ISO 8601 Monday-start week rules and does not account for custom fiscal or retail calendars, historical calendar reforms, or locale-specific week numbering conventions. Always verify critical timelines with your organization’s official calendar or planning system.