# date(byAdding:to:wrappingComponents:) 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 `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`. ## Return Value A new date, or nil if a date could not be calculated with the given input. ## Discussion --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)