Instance Method
date(byAdding:to:wrappingComponents:)
iOS 8.0+
iPadOS 8.0+
Mac Catalyst 8.0+
macOS 10.10+
tvOS 9.0+
watchOS 2.0+
Returns a new Date representing the date calculated by adding components to a given date.
func date(byAdding components: DateComponents, to date: Date, wrappingComponents: Bool = false) -> Date?Parameters
componentsA set of values to add to the date.
dateThe starting date.
wrappingComponentsIf
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.