Day of the Year

What Is the Day of the Year?

The day of the year — also called the ordinal date or the day number — is the position of a date within its calendar year, counting from 1 on January 1. December 31 is day 365, or day 366 when the year is a leap year. It replaces a month-and-day pair with a single integer, which makes dates trivial to sort, subtract, and drop into filenames.

Because the count restarts every January 1, a day number only means something alongside its year: day 200 of 2026 and day 200 of 2027 are different dates.

ISO 8601 Ordinal Dates

ISO 8601 defines an official written form for ordinal dates: YYYY-DDD, where the day number is always zero-padded to three digits. September 1, 2026 is 2026-244, and January 1 is 2026-001. The basic, hyphen-free form is 2026244. Valid day numbers run from 001 to 365, or to 366 in a leap year.

This is a real, parseable date format rather than a local convention. Python reads it with datetime.strptime(s, "%Y-%j"), and many logging, telemetry, and data-interchange formats accept it interchangeably with the familiar YYYY-MM-DD calendar form.

Leap Years and February 29

A year is a leap year if it is divisible by 4, except years divisible by 100, unless they are also divisible by 400. So 2024 and 2000 are leap years, while 1900 and 2100 are not. Leap years have 366 days, and every date from March 1 onward carries a day number one higher than it would in a common year.

That one-day shift is where most day-of-year bugs come from. Hard-coding "day 365 is December 31", or building a fixed table of month offsets, breaks every four years. If you compare day numbers across years, convert back to real dates first, or at the very least branch on the leap-year test.

Day of Year vs. Julian Day

These are two different things that unfortunately share a name.

Ordinal date (1–366)

The day of the year is frequently called a "Julian date" in manufacturing, aviation, food packaging, and mainframe systems, where a code like 26244 means year 2026, day 244. It resets every January.

Julian Day Number (astronomical)

The astronomical Julian Day Number is a continuous count of days since noon UTC on January 1, 4713 BC in the proleptic Julian calendar. September 1, 2026 is Julian Day 2461285. It never resets, which is precisely what astronomers want for computing intervals that span centuries and calendar reforms. The quick test: a value in the millions is a true Julian Day; a value between 1 and 366 is an ordinal date.

How to Calculate the Day of the Year in Code

• Python: datetime.date.today().timetuple().tm_yday, or d.strftime("%j") for the zero-padded string form.
• JavaScript: Math.floor((Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()) - Date.UTC(d.getFullYear(), 0, 1)) / 86400000) + 1 — work in UTC so daylight-saving transitions cannot skew the difference by an hour and round the wrong way.
• Bash (GNU date): date +%j for today, or date -d 2026-09-01 +%j for a given date. On macOS: date -j -f %Y-%m-%d 2026-09-01 +%j.
• Excel / Google Sheets: =A1-DATE(YEAR(A1),1,1)+1, where A1 holds the date.
• SQL: EXTRACT(DOY FROM date_col) in PostgreSQL, DAYOFYEAR(date_col) in MySQL.
• Go: t.YearDay(). Java: LocalDate.now().getDayOfYear().

One gotcha: %j pads to three digits (001), while most language accessors return a plain integer (1). Pick one and be consistent, especially if the values end up in filenames that you expect to sort.

Where Ordinal Dates Are Used

• Batch jobs and log files — names like backup-2026-244.tar.gz sort chronologically as plain strings and sidestep the ambiguity between US and European date order.
• Manufacturing date codes — tires, food packaging, and electronic components are commonly stamped with a compact year-plus-day code instead of a full date.
• Astronomy and satellites — NORAD two-line element sets encode their epoch as a year plus a fractional day of year.
• Agriculture and climate science — growing degree days, planting windows, and phenology datasets are indexed by day of year so that seasons line up when years are compared.
• Aviation and shipping — flight and cargo records use day numbers to keep dates short and locale-neutral.

Day of Year vs. Week Number

ISO 8601 week numbers answer a nearby question under different rules. Weeks start on Monday, and week 1 is the week containing the year's first Thursday — so January 1 can land in week 52 or 53 of the previous year, and a year has either 52 or 53 weeks. This is why the week number shown above will not always equal the day number divided by 7. Use ordinal dates when you need to name an exact day, and week numbers when you need to group by business week.

Frequently Asked Questions