date(byAdding:to:wrappingComponents:)

Returns a new Date representing the date calculated by adding components to a given date.

iOS
8.0+
macOS
10.10+
tvOS
9.0+
watchOS
2.0+
func date(byAdding components: DateComponents, to date: Date, wrappingComponents: Bool = false) -> Date?

Parameters

components

A set of values to add to the date.

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.