Date and Time - WORKDAY.INTL Function



Description

The WORKDAY.INTL function returns the serial number of the date before or after a specified number of workdays with custom weekend parameters. Weekend parameters indicate which and how many days are weekend days. Weekend days and any days that are specified as holidays are not considered as workdays.

Syntax

WORKDAY.INTL (start_date, days, [weekend], [holidays])

Arguments

Argument Description Required/ Optional
Start_date The start date, truncated to integer. Required
Days

The number of workdays before or after the start_date.

  • A positive value yields a future date
  • A negative value yields a past date
  • A zero value yields the start_date

Day-offset is truncated to an integer.

Required
Weekend

Indicates the days of the week that are weekend days and are not considered working days.

Weekend is a weekend number or string that specifies when weekends occur.

Look at Weekend-Number-Days Table given below.

Weekend string values are seven characters long and each character in the string represents a day of the week, starting with Monday.

1 represents a non-workday and 0 represents a workday.

Only the characters 1 and 0 are permitted in the string.

Optional
Holidays An optional set of one or more dates that are to be excluded from the working day calendar. Holidays shall be a range of cells that contain the dates, or an array constant of the serial values that represent those dates. The ordering of dates or serial values in holidays can be arbitrary. Optional

Notes

  • If start_date is out of range for the current date base value, WORKDAY.INTL returns the #NUM! error value.

  • If any date in holidays is out of range for the current date base value, WORKDAY.INTL returns the #NUM! error value.

  • If start_date plus day-offset yields an invalid date, WORKDAY.INTL returns the #NUM! error value.

  • If weekend is an invalid numeric value, WORKDAY.INTL returns the #NUM! error value.

  • If a weekend string is of invalid length or contains invalid characters, WORKDAY.INTL returns the #VALUE! error value.

  • If start_date or any of the values in the holiday’s array are not valid dates, WORKDAY.INTL returns the #VALUE! error value.

  • If days is non-numeric, WORKDAY.INTL returns the #VALUE! error value.

Applicability

Excel 2010, Excel 2013, Excel 2016

Example

WORKDAY.INTL Function
advanced_excel_date_time_functions.htm
Advertisements