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

date(byAdding:to:options:)

Returns a date representing the absolute time calculated by adding given components to a given date. 与えられた構成要素それらをある与えられた日付に加えることによって計算される絶対時間を表している日付を返します。

Declaration 宣言

func date(byAdding comps: DateComponents, 
       to date: Date, 
  options opts: NSCalendar.Options = []) -> Date?

Parameters パラメータ

comps: The components to add to date. dateに追加する構成要素。
date: The date to which comps are added. それに対してcompsが追加される日付。
opts: Options for the calculation. See NSCalendar.Options for possible values. 計算に対するオプション。可能な値のためにNSCalendar.Optionsを見てください。

If you specify no options, overflow in a unit carries into the higher units (as in typical addition). あなたがオプションを指定しないならば、ある単位におけるオーバーフローはより高位の単位にまで至ります（典型的な加算におけるように）。

Return Value 戻り値

A new NSDate object representing the absolute time calculated by adding to date the calendrical components specified by comps using the options specified by opts. Returns nil if date falls outside the defined range of the receiver or if the computation cannot be performed. 新しいNSDateオブジェクト、それはdateに、compsによって指定される与えられたカレンダー関連構成要素を、optsによって指定されるオプションを使って加えることによって計算される絶対時間を表しています。nilを返します、もしdateがレシーバの定義された範囲に収まらないならばまたは計算が実行できないならば。

Discussion 議論

Some operations can be ambiguous, and the behavior of the computation is calendar-specific, but generally components are added in the order specified. いくつかの演算は曖昧である可能性があります、そして計算の挙動はカレンダー特有です、しかし一般的に構成要素は指定された順序で加えられます。

The following example shows how to add 2 months and 3 days to the current date and time using an existing calendar (gregorian): 以下の例は、２ヶ月と３日を現在の日付と時刻へと既存のカレンダー（gregorian）を使って加える方法を示します：

NSDate *currentDate = [NSDate date];
NSDateComponents *comps = [[NSDateComponents alloc] init];
[comps setMonth:2];
[comps setDay:3];
NSDate *date = [gregorian dateByAddingComponents:comps toDate:currentDate options:0];
[comps release];

Note that some computations can take a relatively long time. いくつかの計算は比較的長い時間をとる可能性があることに注意してください。

See Also 参照

Calculating Dates 日付を計算する

func date(from: DateComponents) -> Date?

Returns a date representing the absolute time calculated from given components. 与えられた構成要素から計算される絶対時間を表している日付を返します。

func date(byAdding: NSCalendar.Unit, value: Int, to: Date, options: NSCalendar.Options) -> Date?

Returns a date representing the absolute time calculated by adding the value of a given component to a given date. ある与えられた構成要素をある与えられた日付に加えることによって計算される絶対時間を表している日付を返します。

func date(bySettingHour: Int, minute: Int, second: Int, of: Date, options: NSCalendar.Options) -> Date?

Creates a new date calculated with the given time. 与えられた時間で計算される新しい日付を作成します。

func date(bySettingUnit: NSCalendar.Unit, value: Int, of: Date, options: NSCalendar.Options) -> Date?

Returns a new date representing the date calculated by setting a specific component of a given date to a given value, while trying to keep lower components the same. 与えられた日付の指定構成要素をある与えられた値に設定して、一方でより低い構成要素を同じままに保とうとすることによって計算された日付を表している新しい日付を返します。

func date(era: Int, year: Int, month: Int, day: Int, hour: Int, minute: Int, second: Int, nanosecond: Int) -> Date?

Returns a date created with the given components. 与えられた構成要素それらで作成される日付を返します。

func date(era: Int, yearForWeekOfYear: Int, weekOfYear: Int, weekday: Int, hour: Int, minute: Int, second: Int, nanosecond: Int) -> Date?

Returns a new date created with the given components base on a week-of-year value. 年内週番号値に基づき、ある与えられた構成要素それらで作成される新しい日付を返します。

func nextWeekendStart(AutoreleasingUnsafeMutablePointer<NSDate?>?, interval: UnsafeMutablePointer<TimeInterval>?, options: NSCalendar.Options, after: Date) -> Bool

Returns by reference the starting date and time interval range of the next weekend period after a given date. 与えられた日付の後の次の週末期間の開始日付と期間範囲を参照によって返します。