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])

The WORKDAY.INTL function syntax has the following arguments (argument: A value that provides information to an action, an event, a method, a property, a function, or a procedure.):

  • Start_date    Required. The start date, truncated to integer.
  • Days    Required. 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.
  • Weekend    Optional. 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.

Weekend number values indicate the following weekend days:

weekend-number Weekend days
1 or omitted Saturday, Sunday
2 Sunday, Monday
3 Monday, Tuesday
4 Tuesday, Wednesday
5 Wednesday, Thursday
6 Thursday, Friday
7 Friday, Saturday
11 Sunday only
12 Monday only
13 Tuesday only
14 Wednesday only
15 Thursday only
16 Friday only
17 Saturday only

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. 1111111 is an invalid string.

For example, 0000011would result in a weekend that is Saturday and Sunday.

  • Holidays    Optional. 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.

Remarks

  • 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 a weekend string is of invalid length or contains invalid characters, WORKDAY.INTL returns the #VALUE! error value.

Example

The example may be easier to understand if you copy it to a blank worksheet.

ShowHow do I copy an example?

  1. Select the example in this article. If you are copying the example in Excel Online, copy and paste one cell at a time.
    Important: Do not select the row or column headers.

Selecting an example from Help

Selecting an example from Help

  1. Press CTRL+C.
  2. Create a blank workbook or worksheet.
  3. In the worksheet, select cell A1, and press CTRL+V. If you are working in Excel Online, repeat copying and pasting for each cell in the example.
    Important: For the example to work properly, you must paste it into cell A1 of the worksheet.
  4. To switch between viewing the results and viewing the formulas that return the results, press CTRL+` (grave accent), or on the Formulas tab, in the Formula Auditing group, click the Show Formulas button.

After you copy the example to a blank worksheet, you can adapt it to suit your needs.

 
1

2


3


4


5


6


7
A B
Formula Description
=WORKDAY.INTL(DATE(2006,1,1),0) Results in a serial value corresponding to 1-Jan-2006
=WORKDAY.INTL(DATE(2006,1,1),10) Results in a serial value corresponding to 13-Jan-2006
=WORKDAY.INTL(DATE(2006,1,1),10,7) Results in a serial value corresponding to 15-Jan-2006
=WORKDAY.INTL(DATE(2006,1,1),-10) Results in a serial value corresponding to 19-Dec-2005
=WORKDAY.INTL(DATE(2006,1,1),20,1,{"2006/1/2","2006/1/16"}) Results in a serial value corresponding to 31-Jan-2006
=WORKDAY.INTL(DATE(2006,1,1),20,"0000011",{"2006/1/2","2006/1/16"}) Results in a serial value corresponding to 31-Jan-2006

 Tip    In the Excel desktop application, to format the numbers that are returned as dates, select them, and then on the Home tab, in the Number group, click the Dialog Box Launcher Button image. On the Number tab, in the Category list, click Date, and then in the Type list, click the date format that you want to use. In Excel Online, to view the result as a date select the cell, and then on the Home tab, in the Number group, click the arrow next to Number Format, and click Short Date or Long Date.

 
 
Applies to:
Excel 2010, Excel Web App