WorksheetFunction.WorkDay_Intl Method (Excel)
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.
Version Information
Version Added: Excel 2010
Syntax
expression .WorkDay_Intl(Arg1, Arg2, Arg3, Arg4)
expression A variable that represents a WorksheetFunction object.
Parameters
Name |
Required/Optional |
Data Type |
Description |
---|---|---|---|
Arg1 |
Required |
Variant |
Start_date - The start date, truncated to integer. |
Arg2 |
Required |
Variant |
Days - 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 0 (zero) value yields the start_date. Day-offset is truncated to an integer. |
Arg3 |
Optional |
Variant |
Weekend - 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
|
Arg4 |
Optional |
Variant |
Holidays - An optional set of one or more dates that are to be excluded from the working day calendar. Holidays is 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. |
Return Value
Double
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.