The getDayOfYear function takes a dateTimeValue as an argument, and returns a number representing the day of the year on which the specified dateTimeValue falls. The values range from 1 through 365 for normal years and 1 through 366 for leap years.

Return Type

  • Number


<variable> = <dateTimeValue>.getDayOfYear();


ParameterDescriptionData type
<variable>Variable which will contain the returned number of the day in the year.NUMBER

The date-time value based on which a number will be returned.

The date-time value can be specified without a time value, in which case 00:00:00 will be taken as the default time value.

A runtime error will be encountered if:

  • the specified 2 digit date value exceeds the number of days in that month.
  • an incorrect month value is specified in 3 or more characters.

The function returns a null value if:

  • the month value is specified in less than 3 characters.
  • the hour value, or the minutes value, or the seconds value is specified in more than 2 digits.
  • the date value is specified in more than 2 digits.
  • the year value has more than 4 digits.

Refer this help document to learn about the supported date-time formats.



currentDate = '31-Dec-2020';
dayNumber = currentDate.getDayOfYear();            // returns 366

Share this post : FacebookTwitter

Still can't find what you're looking for?

Write to us: