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.

See Also

Concepts

WorksheetFunction Object

WorksheetFunction Object Members