インスタンスメソッド


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


与えられたコンポーネントのセットに一致する (または最も近い) 次の日付を計算します。


iOS 8.0+ iPadOS 8.0+ Mac Catalyst 13.0+ macOS 10.10+

tvOS 9.0+ VisionOS 1.0+ WatchOS 2.0+ Xcode 6.0.1+


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




パラメータ


start

開始すべき日付。


components

検索すべきコンポーネント。


matchingPolicy

検索アルゴリズムが結果を見つけるために使用する手法を指定します。デフォルト値は .nextTime です。


repeatedTimePolicy

複数の一致が見つかった場合の動作を指定します。デフォルト値は .first です。


direction

検索する時間方向を指定します。デフォルトは .forward です。



戻り値


検索結果を表す Date。結果が見つからなかった場合は nil になります。


議論


一般的な意味は enumerateDates 関数の意味に従います。結果のシーケンスを計算するには、ループして前のループ反復の結果でこのメソッドを呼び出すのではなく、enumerateDates 関数を使用して下さい。





以下も見よ


日付のスキャン


func startOfDay(for: Date) -> Date

与えられた日付の最初の瞬間を日付として返します。


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

与えられたコンポーネントのセットに一致する (または最も近い) 日付を計算し、列挙が停止されるまで、各日付に対してクロージャを 1 回呼び出します。


enum Calendar.MatchingPolicy

日付の検索に使用するメソッドを制御するための検索アルゴリズムのヒント。


enum Calendar.RepeatedTimePolicy

カレンダーの日に時間が繰り返される場合 (たとえば、夏時間への移行時に午前 2 時から午前 3 時までの時間が 2 回発生する場合など) に使用する結果を決定します。














トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ