インスタンスメソッド


date(byAdding:value:to:wrapping
Components:)


与えられた日付に特定のコンポーネントの量を追加して計算された日付を表す新しい Date を返します。


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 date(
byAdding component: Calendar.Component,
value: Int,
to date: Date,
wrappingComponents: Bool = false
) -> Date?





パラメータ


components

追加すべき単一のコンポーネント。


value

追加すべき指定されたコンポーネントの値。


date

開始すべき日付。


wrappingComponents

true の場合、コンポーネントは増分され、オーバーフロー時に 0/1 に包み込まれ、それより上位のコンポーネントは増分されません。デフォルト値は false です。



戻り値


新しい日付。与えられた入力で日付を計算できなかった場合は nil になります。





以下も見よ


コンポーネントから日付を計算


func date(from: DateComponents) -> Date?

指定されたコンポーネントから作成された日付を返します。


func date(byAdding: DateComponents, to: Date, wrappingComponents: Bool) -> Date?

与えられた日付にコンポーネントを追加して計算された日付を表す新しい Date を返します。


func date(bySetting: Calendar.Component, value: Int, of: Date) -> Date?

特定のコンポーネントを与えられた時刻に設定し、下位のコンポーネントを同じに保つようにして計算された日付を表す新しい Date を返します。コンポーネントにすでにその値がある場合、与えられた日付と同じ日付になる可能性があります。


func date(bySettingHour: Int, minute: Int, second: Int, of: Date, matchingPolicy: Calendar.MatchingPolicy, repeatedTimePolicy: Calendar.RepeatedTimePolicy, direction: Calendar.SearchDirection) -> Date?

指定された Date の与えられた時刻に時間、分、秒を設定して計算された日付を表す新しい Date を返します。














トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ