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

date:matchesComponents:

Returns whether a given date matches all of the given date components. 与えられた日付がその与えられた日付構成要素の全てと合致するかどうかを返します。

Declaration 宣言

- (BOOL)date:(NSDate *)date 
matchesComponents:(NSDateComponents *)components;

Parameters パラメータ

date: The date for which to perform the calculation. それに対して計算を実行することになる日付。
comps: The date components to match. 照合する日付構成要素。

Return Value 戻り値

YES if the given date matches the given components, otherwise NO. 与えられた日付がこの与えられた構成要素と合致するならばYES、そうでなければNO。

Discussion 議論

This method is useful for determining whether dates calculated by methods like nextDateAfterDate:matchingUnit:value:options: or enumerateDatesStartingAfterDate:matchingComponents:options:usingBlock: are exact, or required an adjustment due to a nonexistent time.

See Also 参照

Extracting Components 構成要素の抽出

- component:fromDate:

Returns the specified date component from a given date. 指定された日付構成要素をある与えられた日付から返します。

- components:fromDate:

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

- components:fromDate:toDate:options:

Returns the difference between two supplied dates as date components. ２つの提供された日付の間の差を日付構成要素として返します。

- components:fromDateComponents:toDateComponents:options:

Returns the difference between start and end dates given as date components. 日付構成要素として与えられた開始および終了日付の間の差を返します。

- componentsInTimeZone:fromDate:

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

- getEra:year:month:day:fromDate:

Returns by reference the era, year, week of year, and weekday component values for a given date. 参照によって紀年、年、年内週番号、そして曜日構成要素をある与えられた日付に対して返します。

- getEra:yearForWeekOfYear:weekOfYear:weekday:fromDate:

- getHour:minute:second:nanosecond:fromDate:

Returns by reference the hour, minute, second, and nanosecond component values for a given date. 参照によって時間、分、秒、そしてナノ秒構成要素をある与えられた日付に対して返します。