Instance Method

nextDate(after:matching:options:)

Returns the next date after a given date matching the given components.

Declaration

func nextDate(after date: Date, matching comps: DateComponents, options: NSCalendar.Options = []) -> Date?

Parameters

date

The date for which to perform the calculation.

comps

The date components to match.

options

Options for the calculation. For possible values, see NSCalendar.Options.

Return Value

A new NSDate object.

Discussion

To compute a sequence of dates, use the enumerateDates(startingAfter:matching:options:using:) method instead of calling this method in a loop with the previous loop iteration's result.

See Also

Scanning Dates

func startOfDay(for: Date) -> Date

Returns the first moment of a given date as a date instance.

func enumerateDates(startingAfter: Date, matching: DateComponents, options: NSCalendar.Options, using: (Date?, Bool, UnsafeMutablePointer<ObjCBool>) -> Void)

Computes the dates that match (or most closely match) a given set of components, and calls the block once for each of them, until the enumeration is stopped.

func nextDate(after: Date, matchingHour: Int, minute: Int, second: Int, options: NSCalendar.Options) -> Date?

Returns the next date after a given date that matches the given hour, minute, and second, component values.

func nextDate(after: Date, matching: NSCalendar.Unit, value: Int, options: NSCalendar.Options) -> Date?

Returns the next date after a given date matching the given calendar unit value.

struct NSCalendar.Options

The options for arithmetic operations involving calendars.

NSWrapCalendarComponents

A legacy constant used to control overflow in date calculations.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software