<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.15.0 -",
    "tvOS: 13.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 6.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Foundation",
  "identifier" : "/documentation/Foundation/RelativeDateTimeFormatter/dateTimeStyle-swift.property",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "Foundation"
    ],
    "preciseIdentifier" : "c:objc(cs)NSRelativeDateTimeFormatter(py)dateTimeStyle"
  },
  "title" : "dateTimeStyle"
}
-->

# dateTimeStyle

The style to use when describing a relative date, for example “yesterday” or “1 day ago”.

```
var dateTimeStyle: RelativeDateTimeFormatter.DateTimeStyle { get set }
```

## Discussion

Default is `numeric`.

```swift
let components = DateComponents(weekOfMonth: -1)
let formatter = RelativeDateTimeFormatter()
formatter.dateTimeStyle = .numeric
print(formatter.localizedString(from: components))
// Outputs:  1 week ago
```

To display relative dates using named styles, set this property to `named`.

```swift
let components = DateComponents(weekOfMonth: -1)
let formatter = RelativeDateTimeFormatter()
formatter.dateTimeStyle = .named
print(formatter.localizedString(from: components))
// Outputs:  last week
```

---

Copyright &copy; 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)