The style to use when describing a relative date, such as “1 day ago” or “yesterday”.
Initializerinit(presentation:
init(presentation:unitsStyle:locale:calendar:capitalizationContext:)
Creates a relative date format style with the specified presentation, units, locale, calendar, and capitalization context.
Availability 有効性
- iOS 15.0+
- iPadOS 15.0+
- macOS 12.0+
- Mac Catalyst 15.0+
- tvOS 15.0+
- watchOS 8.0+
- Xcode 13.0+
Technology
- Foundation ファウンデーション
Declaration 宣言
init(presentation: Date.RelativeFormatStyle .Presentation = .numeric, unitsStyle: Date.RelativeFormatStyle .UnitsStyle = .wide, locale: Locale = .autoupdatingCurrent, calendar: Calendar = .autoupdatingCurrent, capitalizationContext: FormatStyleCapitalizationContext = .unknown)Parameters パラメータ
presentationunitsStyleThe style to use when formatting the quantity or the name of the unit, such as “1 day ago” or “one day ago”. 単位の量または名前を書式設定する時に使う様式、たとえば “1 day ago” または “one day ago”。
localeThe locale to use when formatting the relative date.
calendarThe calendar to use when formatting the relative date.
capitalizationContextThe capitalization context to use when formatting the relative date.
Discussion 議論
The following example creates a format style applied to a relative date to create a string representation.
if let past = Calendar.current.date(byAdding: .day, value: -7, to: Date()) {
let formatStyle = Date.RelativeFormatStyle(
presentation: .named,
unitsStyle: .abbreviated,
locale: Locale(identifier: "en_US"),
calendar: Calendar.current,
capitalizationContext: .beginningOfSentence)
print(past.formatted(formatStyle)) // "Last wk."
}