XL98: Sample Code to Use a Date Range with NETWORKDAYS (192946)

SUMMARY

When you use the Networkdays function to use a range of dates for the Holidays argument, you must either enter the dates in a range of cells or enclose the dates with array {} brackets.

This article includes a Visual Basic for Applications function that allows you to enter a beginning date and ending date for a consecutive range of dates. The function will return the entire array of dates between the beginning and ending dates and can be used with the Holidays argument of the Networkdays function.

For additional information about the Networkdays function, please see the following article in the Microsoft Knowledge Base:

89507 XL: How to Use NETWORKDAYS() with Multiple Holidays

MORE INFORMATION

Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements. The following function macro returns an array of datevalues from the beginning date (BegDate) through the ending date (EndDate).

Function DateSpan(BegDate As Date, EndDate As Date) As Variant
   Dim DateArray() As Variant, i As Integer, Span As Integer
   BegDate = DateValue(BegDate)
   EndDate = DateValue(EndDate)
   Span = EndDate - BegDate + 1
   ReDim DateArray(1 To Span)
   For i = 1 To Span
      DateArray(i) = BegDate + i - 1
   Next
   DateSpan = DateArray
End Function

Example Using the Function with Networkdays

This example will return the number of workdays (weekdays) between December 1, 1998 and January 1, 1999 with the dates between December 24 and January 1 indicated as holidays.

NOTE: Before using the Networkdays function, you must install the Analysis Toolpak add-in.

In a new workbook, type the custom function DateSpan (illustrated above) into a new module sheet.

For additional information, please see the following article in the Microsoft Knowledge Base:
181058 OFF98: How to Run Sample Code from Knowledge Base Articles
In Sheet1, type the following formula into cell A1:
=NETWORKDAYS(DATEVALUE("12/1/98"), DATEVALUE("1/1/99"), DateSpan("12/24/98","1/1/99"))

The result will be 17 days, the number of days excluding weekends and holidays between the specified date range.

REFERENCES

For more information about the Networkdays function, click Contents And Index on the Help menu (or on the Balloon Help menu if you are using a version of the Macintosh operating system earlier than 8.0), click the Index button in Excel 98 Help, type the following text

networkdays

and then click Show Topics. Select the "NETWORKDAYS worksheet function" topic, and click Go To. If you are unable to find the information you need, ask the Office Assistant.