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.
Declaration
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 isfalse.
Return Value
A new date, or nil if a date could not be calculated with the given input.