The Excel WORKDAY.INTL Function
The Excel Workday.Intl function returns a date that is a supplied number of working days (excluding weekends and holidays) ahead of a given start date. The function allows the user to specify which days of the week are counted as weekends.
The function is new in Excel 2010 and so is not available in earlier versions of Excel. However, it is similar to the Workday function, which is available in earlier versions of Excel.
The format of the Workday.Intl function is:
WORKDAY.INTL( start_date, days, [weekend], [holidays] )
where the arguments are as follows:
|start_date||-||The initial date, from which to count the number of workdays.|
|days||-||The number of workdays to add onto start_date.|
An optional argument, which specifies which weekdays should be counted as the weekend. This can be either a number or a string, as explained below:
Possible number values for the [weekend] argument are:
|Sat & Sun|
|2||Sun & Mon|
|3||Mon & Tue|
|4||Tue & Wed|
|5||Wed & Thu|
|6||Thu & Fri|
|7||Fri & Sat|
Possible string values for the [weekend] argument consist of a series of seven 0's and 1's which represent the seven weekdays, starting from Monday.
Each 1 denotes a day that should be counted as a weekend and each 0 represents a working day.
|0000100||-||denotes Fridays only counted as weekend days|
|0001100||-||denotes Thursdays and Fridays counted as weekend days|
|0000111||-||denotes Fridays, Saturdays and Sundays counted as weekend days|
The string "1111111" is not valid.
|[holidays]||-||An optional argument, which specifies an array of dates (in addition to weekends) that are not to be counted as working days.|
Note that the start_date and [holidays] arguments should be input as either:
- References to cells containing dates
- Dates returned from formulas.
If you attempt to input Excel date arguments as text, Excel may misinterpret them, depending on the date system, or date interpretation settings, on your computer.
The spreadsheets below show three examples of the Excel Workday.Intl function. In all three examples, the function is used to calculate the date that is 25 work days after 01-Dec-2015. However, the weekends and holidays are different in each case.
Note that, in the above formulas:
- In the example in cell A7, the weekends have the default setting (falling on Saturdays and Sundays), and so the [weekend] argument can be omitted from the function;
- In the examples in cells A7 and A9, no additional holidays are to be included in the calculations, and so the [holidays] argument is omitted from the functions;
- In the example in cell A9, the text string "0000111" defines the weekends to be Fridays, Saturdays and Sundays.
Further examples of the Excel Workday.Intl function are provided on the Microsoft Office website.
If you get an error from the Excel Workday.Intl function this is likely to be one of the following:
Occurs if either:
- The supplied start_date plus the supplied days argument results in an invalid date;
- The supplied [weekend] argument is an invalid numeric value.
Occurs if either:
- The supplied start_date or any of the values in the supplied [holidays] array are not valid dates;
- the supplied [weekend] argument is an invalid text string;
- The supplied days argument is non-numeric.