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

dateComponents(_:from:to:)

Returns the difference between two dates specified as DateComponents. DateComponentsとして指定された２つの日付の間の差を返します。

Declaration 宣言 

func dateComponents(_ components: Set<Calendar.Component>, from start: DateComponents, to end: DateComponents) -> DateComponents

Parameters パラメータ

components

Which components to compare. 比較するのはどの構成要素か。

start

The starting date components. 開始する日付構成要素。

end

The ending date components. 終了する日付構成要素。

Return Value 戻り値

The result of calculating the difference from start to end. 開始から終了までの差を計算した結果。

Discussion 議論

For components which are not specified in each DateComponents, but required to specify an absolute date, the base value of the component is assumed. For example, for an DateComponents with just a year and a month specified, a day of 1, and an hour, minute, second, and nanosecond of 0 are assumed. Calendrical calculations with unspecified year or year value prior to the start of a calendar are not advised. For each DateComponents, if its timeZone property is set, that time zone is used for it. If the calendar property is set, that is used rather than the receiving calendar, and if both the calendar and timeZone are set, the timeZone property value overrides the time zone of the calendar property. 各DateComponentsにおいて指定されない、しかし絶対日付を指定するのに必要分ある構成要素に対して、その構成要素の基本値が仮定されます。例えば、ただyearとmonthを指定されるだけのDateComponentsに対して、１のday、そして０のhour、minute、second、そしてnanosecondが仮定されます。指定されないyearまたはそのカレンダーの始まりより前のyear値を持つカレンダー関連計算は、勧められません。各DateComponentsに対して、それのtimeZoneプロパティが設定されるならば、そのタイムゾーンがそれに対して使われます。calendarプロパティが設定されるならば、受け手側のカレンダーではなくてそれが使われます、そしてcalendarとtimeZoneの両方が設定されるならば、timeZoneプロパティ値がcalendarプロパティのタイムゾーンをオーバーライドします。

See Also 参照

Extracting Components 構成要素の抽出

func date(Date, matchesComponents: DateComponents) -> Bool
Determines if the date has all of the specified date components. 指定された日付構成要素のすべてを、この日付が持つかどうかを判定します。
func component(Calendar.Component, from: Date) -> Int
Returns the value for one component of a date. ある日付の１つの構成要素に対する値を返します。
func dateComponents(Set<Calendar.Component>, from: Date) -> DateComponents
Returns all the date components of a date, using the calendar time zone. ある日付の日付構成要素のすべてを返します、そのカレンダーのタイムゾーンを使います。
func dateComponents(Set<Calendar.Component>, from: Date, to: Date) -> DateComponents
Returns the difference between two dates. ２つの日付の間の差を返します。
func dateComponents(in: TimeZone, from: Date) -> DateComponents
Returns all the date components of a date, as if in a given time zone (instead of the Calendar time zone). ある日付の日付構成要素のすべてを返します、与えられたタイムゾーンを使います（Calendarタイムゾーンの代わりに）。
enum Calendar.Component
An enumeration for the various components of a calendar date. あるカレンダー日付の様々な構成要素に対する列挙。