Instance Method インスタンスメソッド

nextDate(after:matching:matchingPolicy:repeatedTimePolicy:direction:)

Computes the next date which matches (or most closely matches) a given set of components. 与えられた一揃いの構成要素に合致する（または最も近くの合致する）次の日付を計算します。

Declaration 宣言

func nextDate(after date: Date, matching components: DateComponents, matchingPolicy: Calendar.MatchingPolicy, repeatedTimePolicy: Calendar.RepeatedTimePolicy = .first, direction: Calendar.SearchDirection = .forward) -> Date?

Parameters パラメータ

date: The starting date. 開始日付。
components: The components to search for. これらの構成要素を捜すことになります。
matchingPolicy: Specifies the technique the search algorithm uses to find results. Default value is .nextTime. 検索アルゴリズムが結果を見つけるために使うテクニックを指定します。省略時の値は.nextTimeです。
repeatedTimePolicy: Specifies the behavior when multiple matches are found. Default value is .first. 複数の合致するものが見つけられる場合の挙動を指定します。省略時の値は.firstです。
direction: Specifies the direction in time to search. Default is .forward. 時間での、検索する方向を指定します。省略時は.forwardです。

Return Value 戻り値

A Date representing the result of the search, or nil if a result could not be found. 検索の結果を表現しているDate、または結果が見つけられなかったならばnil。

Discussion 議論

The general semantics follow those of the enumerateDates function. To compute a sequence of results, use the enumerateDates function, rather than looping and calling this method with the previous loop iteration’s result. おおまかな意味論は、enumerateDates関数に従います。結果のシーケンスを計算するには、enumerateDates関数を使ってください、以前のループ反復の結果を使ってこの関数をループして呼び出す代わりにです。

See Also 参照

Scanning Dates 日付を走査する

func startOfDay(for: Date) -> Date

Returns the first moment of a given Date, as a Date. 与えられたDateの最初の瞬間を、Dateとして返します。

func enumerateDates(startingAfter: Date, matching: DateComponents, matchingPolicy: Calendar.MatchingPolicy, repeatedTimePolicy: Calendar.RepeatedTimePolicy, direction: Calendar.SearchDirection, using: (Date?, Bool, inout Bool) -> Void)

Computes the dates which match (or most closely match) a given set of components, and calls the closure once for each of them, until the enumeration is stopped. 与えられた一揃いの構成要素と合致する（または最も近くの合致する）日付それらを計算します、そしてそれらの各々で一度だけクロージャを呼び出します、列挙が停止されるまで。

enum Calendar.MatchingPolicy

A hint to the search algorithm to control the method used for searching for dates. 日付を検索するのに使われるメソッドを制御する検索アルゴリズムへのヒント。

enum Calendar.RepeatedTimePolicy

Determines which result to use when a time is repeated on a day in a calendar (for example, during a daylight saving transition when the times between 2:00am and 3:00am may happen twice). あるカレンダーのある日にある時間が繰り返される場合に使う結果を決定します（例えば、サマータイムの変わり目には、2:00amと3:00amの間の時間は２度起こるかもしれません）。