WorksheetFunction.WorkDay Method
Returns a number that represents a date that is the indicated number of working days before or after a date (the starting date). Working days exclude weekends and any dates identified as holidays. Use WORKDAY to exclude weekends or holidays when you calculate invoice due dates, expected delivery times, or the number of days of work performed.
Namespace: Microsoft.Office.Interop.Excel
Assembly: Microsoft.Office.Interop.Excel (in Microsoft.Office.Interop.Excel.dll)
Syntax
'Declaration
Function WorkDay ( _
Arg1 As Object, _
Arg2 As Object, _
Arg3 As Object _
) As Double
'Usage
Dim instance As WorksheetFunction
Dim Arg1 As Object
Dim Arg2 As Object
Dim Arg3 As Object
Dim returnValue As Double
returnValue = instance.WorkDay(Arg1, Arg2, _
Arg3)
double WorkDay(
Object Arg1,
Object Arg2,
Object Arg3
)
Parameters
Arg1
Type: System.ObjectStart_date - a date that represents the start date.
Arg2
Type: System.ObjectDays - the number of nonweekend and nonholiday days before or after start_date. A positive value for days yields a future date; a negative value yields a past date.
Arg3
Type: System.ObjectHolidays - an optional list of one or more dates to exclude from the working calendar, such as state and federal holidays and floating holidays. The list can be either a range of cells that contain the dates or an array constant of the serial numbers that represent the dates.
Return Value
Type: System.Double
Remarks
Important
Dates should be entered by using the DATE function, or as results of other formulas or functions. For example, use DATE(2008,5,23) for the 23rd day of May, 2008. Problems can occur if dates are entered as text .
Microsoft Excel stores dates as sequential serial numbers so they can be used in calculations. By default, January 1, 1900 is serial number 1, and January 1, 2008 is serial number 39448 because it is 39,448 days after January 1, 1900. Microsoft Excel for the Macintosh uses a different date system as its default.
If any argument is not a valid date, WorkDay returns the #VALUE! error value.
If start_date plus days yields an invalid date, WorkDay returns the #NUM! error value.
If days is not an integer, it is truncated.