date(byAdding:value:to:wrappingComponents:)

Returns a new Date representing the date calculated by adding an amount of a specific component to a given date.

iOS
8.0+
macOS
10.10+
tvOS
9.0+
watchOS
2.0+
func date(byAdding component: Calendar.Component, value: Int, to date: Date, wrappingComponents: Bool = false) -> Date?

Parameters

component

A single component to add.

value

The value of the specified component to add.

date

The starting date.

wrappingComponents

If true, the component should be incremented and wrap around to zero/one on overflow, and should not cause higher components to be incremented. The default value is false.

Returns

A new date, or nil if a date could not be calculated with the given input.