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

components(_:from:)

Returns the date components representing a given date. 与えられた日付を表している日付構成要素を返します。

Declaration 宣言 

func components(_ unitFlags: NSCalendar.Unit, 
           from date: Date) -> DateComponents

Parameters パラメータ

unitFlags

The components into which to decompose date. それへとdateを分解することになる構成要素いくつか。

date

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

Return Value 戻り値

An NSDateComponents object containing date decomposed into the components specified by unitFlags. Returns nil if date falls outside of the defined range of the receiver or if the computation cannot be performed. あるNSDateComponentsオブジェクト、含んでいるのはdateで、unitFlagsによって指定される構成要素それらへと分解されます。nilを返します、もしdateがその定義されるレシーバの範囲外ならばまたは計算が実行されることができないならば。

Discussion 議論

The Weekday ordinality, when requested, refers to the next larger (than Week) of the requested units. Some computations can take a relatively long time. Weekday序数性は、要請される場合、要請された単位の次により大きい（Weekより）ものを参照します。いくつかの計算は、相対的に長い時間がかかることがあります。

The following example shows how to use this method to determine the current year, month, and day, using an existing calendar (gregorian): 次の例は、このメソッドを使って現在の年、月、そして日を、既存のカレンダー（gregorian）を使って決定する方法を示します： 


unsigned unitFlags = NSYearCalendarUnit | NSMonthCalendarUnit |  NSDayCalendarUnit;
NSDate *date = [NSDate date];
NSDateComponents *comps = [gregorian components:unitFlags fromDate:date];

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, 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 components(in: TimeZone, from: Date) -> DateComponents
Returns all the date components of a date, as if in a given time zone (instead of the receiving calendar’s time zone). ある日付の日付構成要素すべてを返します、まるで与えられたタイムゾーンの中であるかのように（受け取っているカレンダーの持つタイムゾーンの代わりに）。
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. 参照によって時間、分、秒、そしてナノ秒構成要素をある与えられた日付に対して返します。

Related Documentation 関連文書

func date(from: DateComponents) -> Date?
Returns a date representing the absolute time calculated from given components. 与えられた構成要素から計算される絶対時間を表している日付を返します。
func date(byAdding: DateComponents, to: Date, options: NSCalendar.Options) -> Date?
Returns a date representing the absolute time calculated by adding given components to a given date. 与えられた構成要素それらをある与えられた日付に加えることによって計算される絶対時間を表している日付を返します。