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

date(_:matchesComponents:)

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

Declaration 宣言 

func date(_ date: Date, 
matchesComponents components: DateComponents) -> Bool

Parameters パラメータ

date

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

comps

The date components to match. 照合する日付構成要素。

Return Value 戻り値

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

Discussion 議論

This method is useful for determining whether dates calculated by methods like nextDate(after:matching:value:options:) or enumerateDates(startingAfter:matching:options:using:) are exact, or required an adjustment due to a nonexistent time.

See Also 参照

Extracting 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 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 nextDate(after: Date, matching: NSCalendar.Unit, value: Int, options: NSCalendar.Options) -> Date?
Returns the next date after a given date matching the given calendar unit value. 与えられた日付の後の与えられたカレンダー単位値に合致する次の日付を返します。
func enumerateDates(startingAfter: Date, matching: DateComponents, options: NSCalendar.Options, using: (Date?, Bool, UnsafeMutablePointer<ObjCBool>) -> Void)
Computes the dates that match (or most closely match) a given set of components, and calls the block once for each of them, until the enumeration is stopped. ある与えられた構成要素一揃いに合致する（または最もぴったりと合致する）日付それらを算出します、そしてそれらの各々で一度だけブロックを、列挙が停止されるまで呼び出します。