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

date(bySettingHour:minute:second:of:matchingPolicy:repeatedTimePolicy:direction:)

Returns a new Date representing the date calculated by setting hour, minute, and second to a given time on a specified Date. ある指定されたDate上のある与えられた時間に時、分、そして秒を設定することによって算出される日付を表している新しいDateを返します。

Declaration 宣言 

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

Parameters パラメータ

hour

A specified hour. 指定される時間。

minute

A specified minute. 指定される分。

second

A specified second. 指定される秒。

date

The date to start calculation with. 計算を開始することになる日付。

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 議論

If no such time exists, the next available time is returned (which could, for example, be in a different day than the nominal target date). The intent is to return a date on the same day as the original date argument. This may result in a date which is backward than the given date, of course. そのような時間が存在しないならば、次の利用可能な時間が返されます（それは例えば、名目上の目標日付とは別の日である可能性があります）。その意図は、元の日付引数と同じ日にち上での日付を返すことです。これは、もちろん、与えられた日付より過去にさかのぼった日付という結果になるかもしれません。

See Also 参照

Calculating Dates from Components 構成要素から日付を計算する

func date(from: DateComponents) -> Date?
Returns a date created from the specified components. 指定された構成要素から作成される日付を返します。
func date(byAdding: DateComponents, to: Date, wrappingComponents: Bool) -> Date?
Returns a new Date representing the date calculated by adding components to a given date. いくつかの構成要素をある与えられた日付に加えることによって計算される日付を表している新しいDateを返します。
func date(byAdding: Calendar.Component, value: Int, to: Date, wrappingComponents: Bool) -> Date?
Returns a new Date representing the date calculated by adding an amount of a specific component to a given date. ある量の特定の構成要素をある与えられた日付に加えることによって計算される日付を表している新しいDateを返します。
func date(bySetting: Calendar.Component, value: Int, of: Date) -> Date?
Returns a new Date representing the date calculated by setting a specific component to a given time, and trying to keep lower components the same. If the component already has that value, this may result in a date which is the same as the given date. 特定の構成要素をある与えられた時間に設定し、そしてより低い構成要素を同じに保つよう試みることによって計算される日付を表している新しいDateを返します。構成要素が既にその値を持つならば、これはその与えられた日付と同じ日付という結果になるでしょう。