Function Dates Times Class

NextDayOfWeek

Returns the date of the next specific day of the week (for example, the next Saturday).

Signature (Visual Basic / VBA)

Public Function NextDayOfWeek( _
      ByVal vDate As Variant _
    , ByVal vDayOfWeek As Variant _
    ) As Variant

Code Example

    Format$(#4/15/1996#, "ddd") = "Mon"
    NextDayOfWeek(#4/15/1996#, vbTuesday) = #4/16/1996#
    NextDayOfWeek(#4/15/1996#, vbFriday)  = #4/19/1996#
    NextDayOfWeek(#4/15/1996#, vbSunday)  = #4/21/1996#
    NextDayOfWeek(#4/15/1996#, vbMonday)  = #4/22/1996#
    NextDayOfWeek(#4/15/1996#, #4/15/1996#)  = #4/22/1996#

Parameters

Parameter Description
vDate The date whose next specific day of the week is returned. Function returns Null if vDate is Null or cannot be fixed up to a Date.
vDayOfWeek Date or numeric value which represents the day of the week (Sunday, Monday, etc.). Function returns Null if vDayOfWeek is Null or cannot be fixed up to either a date or a number. Function first checks numeric values to see if they are one of the vb constants that represent the days of the week (vbSunday, vbMonday, vbTuesday, vbWednesday, vbThursday, vbFriday, or vbSaturday). Otherwise, numeric values are interpreted as date values. Function examines the date component of date/time values to determine its weekday.