Skip to main content Link Search Menu Expand Document (external link)

dayOfYear() : Extract Day of Year from Date


On this page

Summary

Extract the day of the year from a datetime value as a number (1-366), representing which day it is in the calendar year.

Signature

dayOfYear(date)

Parameters

Parameter Type Required Description
date DateTime Yes The datetime to extract the day of year from

Returns

Type: Number (Integer)

The day of the year as a number from 1 (January 1st) to 365 or 366 (December 31st in a leap year).


Examples

Display Day of Year

<p>Day  of </p>

Data:

doc.Params["model"] = new {
    date = new DateTime(2024, 3, 15)
};

Output:

<p>Day 75 of 2024</p>

Progress Through Year

<p>Year Progress: %</p>

Data:

doc.Params["model"] = new {
    today = new DateTime(2024, 6, 30)
};

Output:

<p>Year Progress: 50.1%</p>

Manufacturing Day Code

<p>Production Code: -</p>

Data:

doc.Params["model"] = new {
    date = new DateTime(2024, 3, 15),
    batchNumber = "A42"
};

Output:

<p>Production Code: 24075-A42</p>

Seasonal Marketing Periods

<p>Marketing Period:

  Q1 Campaign

  Q2 Campaign

  Q3 Campaign

  Q4 Campaign

</p>

Data:

doc.Params["model"] = new {
    date = new DateTime(2024, 8, 15)
};

Output:

<p>Marketing Period: Q3 Campaign</p>

Days Remaining in Year

<p>Days left in : 365</p>

Data:

doc.Params["model"] = new {
    today = new DateTime(2024, 12, 20)
};

Output:

<p>Days left in 2024: 11</p>

Notes

  • Returns 1-365 for regular years, 1-366 for leap years
  • January 1st is always day 1
  • December 31st is day 365 (or 366 in leap year)
  • Time component is ignored
  • Useful for:
    • Julian date calculations
    • Manufacturing date codes
    • Year progress tracking
    • Seasonal period calculations
  • Does not account for leap years automatically in calculations (use 366 for leap years)

See Also