XCode 15.0 日本語化計画：New Human Interface Guideline
指定された Date の与えられた時刻に時間、分、秒を設定して計算された日付を表す新しい Date を返します。
hour
指定された時間。
minute
指定された分。
second
指定された病。
date
そこで計算を開始すべき日付。
matchingPolicy
検索アルゴリズムが結果を見つけるために使用する手法を指定します。デフォルト値は .nextTime です。
repeatedTimePolicy
複数の一致が見つかった場合の動作を指定します。デフォルト値は .first です。
direction
検索すべき時間の方向を指定します。デフォルトは .forward です。
検索結果を表す Date。結果が見つからなかった場合は nil になります。
そのような時間が存在しない場合は、次に利用可能な時間が返されます (たとえば、名目上の目標日とは異なる日になる場合があります)。目的は、元の日付引数と同じ日の日付を返すことです。もちろん、これにより、与えられた日付よりも前の日付が返される可能性があります。
func date(from: DateComponents) -> Date?
指定されたコンポーネントから作成された日付を返します。
func date(byAdding: DateComponents, to: Date, wrappingComponents: Bool) -> Date?
与えられた日付にコンポーネントを追加して計算された日付を表す新しい Date を返します。
func date(byAdding: Calendar.Component, value: Int, to: Date, wrappingComponents: Bool) -> Date?
与えられた日付に特定のコンポーネントの量を追加して計算された日付を表す新しい Date を返します。
func date(bySetting: Calendar.Component, value: Int, of: Date) -> Date?
特定のコンポーネントを与えられた時刻に設定し、下位のコンポーネントを同じに保つようにして計算された日付を表す新しい Date を返します。コンポーネントにすでにその値がある場合、与えられた日付と同じ日付になる可能性があります。