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:

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

How 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

  2. Press CTRL+C.

  3. Create a blank workbook or worksheet.

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

  5. 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 Starter, Excel Online



Was this information helpful?

Yes No

How can we improve it?

255 characters remaining

To protect your privacy, please do not include contact information in your feedback. Review our privacy policy.

Thank you for your feedback!

Support resources

Change language