Class

NSDateComponents

An object that specifies a date or time in terms of calendar units that bridges to DateComponents; use NSDateComponents when you need reference semantics or other Foundation-specific behavior. あるオブジェクト、それはある日付または時刻をカレンダー単位の表現で指定します、それはDateComponentsにブリッジします；あなたが参照意味論や他のFoundation特有の挙動を必要とする場合にNSDateComponentsを使ってください。

Declaration 宣言

class NSDateComponents : NSObject

Overview 概要

NSDateComponents encapsulates the components of a date in an extendable, object-oriented manner. It's used to specify a date by providing the temporal components that make up a date and time: hour, minutes, seconds, day, month, year, and so on. You can also use it to specify a duration of time, for example, 5 hours and 16 minutes. An NSDateComponents object is not required to define all the component fields. When a new instance of NSDateComponents is created, the date components are set to NSDateComponentUndefined. NSDateComponentsは、ある日付の構成要素を、ある拡張可能な、オブジェクト指向の流儀でカプセル化します。それは、日付と時刻を作り上げる時間構成要素：時間、分、秒、日、月、年、などを提供することによって、ある日付を指定するのに使われます。あなたはまたそれを使ってある継続時間、例えば５時間と16分を指定できます。NSDateComponentsオブジェクトは、全ての構成要素情報を定義することを要求しません。ある新しいNSDateComponentsのインスタンスが作成される場合、日付構成要素それらはNSDateComponentUndefinedに設定されます。

An instance of NSDateComponents is not responsible for answering questions about a date beyond the information with which it was initialized. For example, if you initialize one with May 4, 2017, its weekday is NSDateComponentUndefined, not Thursday. To get the correct day of the week, you must create a suitable instance of NSCalendar, create an NSDate object using date(from:) and then use components(_:from:) to retrieve the weekday—as illustrated in the following example. NSDateComponentsのインスタンスは、それとともにそれが初期化された情報を越えて、ある日付について質問に応える責任はありません。例えば、あなたがそれをMay 4, 2017とともに初期化するならば、それのweekdayはNSDateComponentUndefinedです、Thursdayではなく。正しい曜日を得るには、あなたはNSCalendarの適切なインスタンスを作成して、NSDateをdate(from:)を使って作成して、それからcomponents(_:from:)を使って曜日を回収してください — 次の例で解説するように。

let dateComponents = NSDateComponents()
dateComponents.day = 4
dateComponents.month = 5
dateComponents.year = 2017


if let gregorianCalendar = NSCalendar(calendarIdentifier: .gregorian),
    let date = gregorianCalendar.date(from: dateComponents as DateComponents) {
    let weekday = gregorianCalendar.component(.weekday, from: date)
    print(weekday) // 5, which corresponds to Thursday in the Gregorian Calendar
}

For more details, see Calendars, Date Components, and Calendar Units in Date and Time Programming Guide. さらなる詳細として、Calendars, Date Components, and Calendar UnitsをDate and Time Programming Guideで見てください。

Topics 話題

Setting a Calendar and Time Zone カレンダーとタイムゾーンを設定する

var calendar: Calendar?

The calendar used to interpret the date components. この日付構成要素を解釈するのに使われるカレンダー。

var timeZone: TimeZone?

The time zone used to interpret the date components. この日付構成要素を解釈するのに使われるタイムゾーン。

Validating a Date 日付を検証する

var isValidDate: Bool

A Boolean value that indicates whether the current combination of properties represents a date which exists in the current calendar. 現在のプロパティの組み合わせが、現在のカレンダーに存在する日付を表すかどうかを指し示すブール値。

func isValidDate(in: Calendar) -> Bool

Returns a Boolean value that indicates whether the current combination of properties represents a date which exists in the specified calendar. 現在のプロパティの組み合わせが、指定されたカレンダーに存在する日付を表すかどうかを指し示すブール値を返します。

var date: Date?

The date calculated from the current components using the stored calendar. 現在の構成要素から格納カレンダーを使って計算される日付。