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

components(in:from:)

Returns all the date components of a date, as if in a given time zone (instead of the receiving calendar’s time zone). ある日付の日付構成要素すべてを返します、まるで与えられたタイムゾーンの中であるかのように（受け取っているカレンダーの持つタイムゾーンの代わりに）。

Declaration 宣言 

func components(in timezone: TimeZone, 
           from date: Date) -> DateComponents

Parameters パラメータ

timezone

The time zone to use when returning the components. This value overrides the time zone of the receiving NSCalendar. 構成要素を返す場合に使うタイムゾーン。この値は、受け取っているNSCalendarのタイムゾーンをオーバーライドします。

date

The date for which to perform the calculation. それに対して計算を実行することになる日付。

Return Value 戻り値

An NSDateComponents object containing all the components from the given date, calculated using the given time zone. NSDateComponentsオブジェクト、与えられた日付からの構成要素の全てを含んでいます、与えられたタイムゾーンを使って計算されます。

Discussion 議論

If you want "date information in a given time zone" for the purpose to displaying it, you should use DateFormatter to format the date. あなたが表示する目的で「ある与えられたタイムゾーンにおける日付情報」を望むならば、あなたはDateFormatterを使ってその日付を書式設定すべきです。

See Also 参照

Extracting Components 構成要素の抽出

func date(Date, matchesComponents: DateComponents) -> Bool
Returns whether a given date matches all of the given date components. 与えられた日付がその与えられた日付構成要素の全てと合致するかどうかを返します。
func component(NSCalendar.Unit, from: Date) -> Int
Returns the specified date component from a given date. 指定された日付構成要素をある与えられた日付から返します。
func components(NSCalendar.Unit, from: Date) -> DateComponents
Returns the date components representing a given date. 与えられた日付を表している日付構成要素を返します。
func components(NSCalendar.Unit, from: Date, to: Date, options: NSCalendar.Options) -> DateComponents
Returns the difference between two supplied dates as date components. ２つの提供された日付の間の差を日付構成要素として返します。
func components(NSCalendar.Unit, from: DateComponents, to: DateComponents, options: NSCalendar.Options) -> DateComponents
Returns the difference between start and end dates given as date components. 日付構成要素として与えられた開始および終了日付の間の差を返します。
func getEra(UnsafeMutablePointer<Int>?, year: UnsafeMutablePointer<Int>?, month: UnsafeMutablePointer<Int>?, day: UnsafeMutablePointer<Int>?, from: Date)
Returns by reference the era, year, week of year, and weekday component values for a given date. 参照によって紀年、年、年内週番号、そして曜日構成要素をある与えられた日付に対して返します。
func getEra(UnsafeMutablePointer<Int>?, yearForWeekOfYear: UnsafeMutablePointer<Int>?, weekOfYear: UnsafeMutablePointer<Int>?, weekday: UnsafeMutablePointer<Int>?, from: Date)
Returns by reference the era, year, week of year, and weekday component values for a given date. 参照によって紀年、年、年内週番号、そして曜日構成要素をある与えられた日付に対して返します。
func getHour(UnsafeMutablePointer<Int>?, minute: UnsafeMutablePointer<Int>?, second: UnsafeMutablePointer<Int>?, nanosecond: UnsafeMutablePointer<Int>?, from: Date)
Returns by reference the hour, minute, second, and nanosecond component values for a given date. 参照によって時間、分、秒、そしてナノ秒構成要素をある与えられた日付に対して返します。