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

date(byAdding:value:to:options:)

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

Declaration 宣言 

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

Parameters パラメータ

unit

The unit to use for the calculation. For possible values, see NSCalendar.Unit. 計算に使うための単位。可能な値として、NSCalendar.Unitを見てください。

value

The value for the given unit. 与えられた単位に対する値。

date

The date to use to perform the calculation. 計算を実行するために使う日付。

options オプション

Options for the calculation. See NSCalendar.Options for possible values. 計算に対するオプション。可能な値のためにNSCalendar.Optionsを見てください。

If you specify a “wrap” option (wrapComponents), the specified components are incremented and wrap around to zero/one on overflow, but do not cause higher units to be incremented. When the wrap option is false, overflow in a unit carries into the higher units, as in typical addition. あなたが “wrap” オプション（wrapComponents）を指定するならば、指定された構成要素は漸増されて、オーバーフローに関して０／１ラップアラウンドをします、しかしより高位の単位の漸増を引き起こしません。ラップオプションがfalseである場合、ある単位におけるオーバーフローはより高位の単位にまで至ります、典型的な加算におけるように。

Return Value 戻り値

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

See Also 参照

Calculating Dates 日付を計算する

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. 与えられた構成要素それらをある与えられた日付に加えることによって計算される絶対時間を表している日付を返します。
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. 与えられた日付の後の次の週末期間の開始日付と期間範囲を参照によって返します。