Summary
The Excel WORKDAY.INTL function takes a date and returns the nearest working in the future or past, based on an offset value you provide. Unlike the WORKDAY function, WORKDAY.INTL allows you to customize which days are considered weekends (non-working days). You can use WORKDAY.INTL function to calculate completion dates, ship dates, etc. that take into account non-working days.
Purpose
Return value
Syntax
Arguments
- start_date – The start date.
- days – The end date.
- weekend – [optional] Setting for which days of the week should be considered weekends.
- holidays – [optional] A list of one or more dates that should be considered non-work days.
Usage notes
WORKDAY.INTL figures out a date that represents the “nearest” working day N days in the past or future. Use a positive number as days for future dates and a negative number for past dates. This function is more robust than the WORKDAY function because it lets you customize which days of the week are considered weekends.
Weekends
By default, WORKDAY.INTL will exclude weekends (Saturday and Sunday) . However, you can control which days are considered weekends, by supplying the codes that appear in the table below for the weekend argument.
Holidays
WORKDAY.INTL can also optionally take into account holidays. For the holidays argument, supply a range that contains holiday dates. These dates are treated as non-working days and will not be included in the result.
Weekend settings
Code | Weekend days |
1 (default) | 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 |
Notes:
- If start_date is invalid, WORKDAY.INTL returns the #NUM! error.
- If start_date + day is invalid, WORKDAY.INTL returns the #NUM! error.
- If any holiday is invalid, WORKDAY.INTL returns the #NUM! error.
- If weekend is invalid, WORKDAY.INTL returns the #VALUE! error.