---
title: "date(from:)"
framework: foundation
role: symbol
role_heading: Instance Method
path: "foundation/calendar/date(from:)"
---

# date(from:)

Returns a date created from the specified components.

## Declaration

```swift
func date(from components: DateComponents) -> Date?
```

## Parameters

- `components`: Used as input to the search algorithm for finding a corresponding date.

## Return Value

Return Value A new Date, or nil if a date could not be found which matches the components.

## See Also

### Calculating Dates from Components

- [date(byAdding:to:wrappingComponents:)](foundation/calendar/date(byadding:to:wrappingcomponents:).md)
- [date(byAdding:value:to:wrappingComponents:)](foundation/calendar/date(byadding:value:to:wrappingcomponents:).md)
- [date(bySetting:value:of:)](foundation/calendar/date(bysetting:value:of:).md)
- [date(bySettingHour:minute:second:of:matchingPolicy:repeatedTimePolicy:direction:)](foundation/calendar/date(bysettinghour:minute:second:of:matchingpolicy:repeatedtimepolicy:direction:).md)