The Excel WORKDAY.INTL Function

Related Functions:
NETWORKDAYS.INTL
WORKDAY

Basic Description

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.
[weekend]-

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:

[weekend]days counted
as weekend
1
(or omitted)
Sat & Sun
2Sun & Mon
3Mon & Tue
4Tue & Wed
5Wed & Thu
6Thu & Fri
7Fri & Sat
11Sunday only
12Monday only
13Tuesday only
14Wednesday only
15Thursday only
16Friday only
17Saturday only

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.

For example,

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:

or

- If you attempt to input these date arguments as text, Excel may misinterpret them, due to different date systems, or date interpretation settings.


Workday.Intl Examples

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, but the weekends and holidays are different in each case.

 Formulas:
Examples of use of the Excel Workday.Intl Function
 Results:
Excel Workday.Intl Function Results

Note that, in the above formulas:


Further examples of the Excel Workday.Intl function can be found on the Microsoft Office website.


Workday.Intl Errors

If you get an error from the Excel Workday.Intl function this is likely to be one of the following:

Common Errors
#NUM!-

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.
#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.