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. 計算に対するオプション。可能な値として、NSCalendar.Optionsを見てください。

Return Value 戻り値

A new NSDate object. 新しいNSDateオブジェクト。

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. 一連の日付を計算するには、enumerateDates(startingAfter:matching:options:using:)メソッドを直前のループ反復の結果を使うループにおいてこのメソッドを呼び出す代わりに使ってください。

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. 日付計算においてオーバーフローを制御するために使われるレガシー定数。