unitsStyle
TypeScriptget unitsStyle(): Date_RelativeFormatStyle_UnitsStyleSwift declarationvar unitsStyle: Date.AnchoredRelativeFormatStyle.UnitsStyle { get set }struct · iOS 18.0+ · SDK 27.1
struct AnchoredRelativeFormatStyleA relative format style that is detached from the system time, and instead formats an anchor date relative to the format input.
get unitsStyle(): Date_RelativeFormatStyle_UnitsStyleSwift declarationvar unitsStyle: Date.AnchoredRelativeFormatStyle.UnitsStyle { get set }set unitsStyle(value: Date_RelativeFormatStyle_UnitsStyle)Swift declarationvar unitsStyle: Date.AnchoredRelativeFormatStyle.UnitsStyle { get set }get presentation(): Date_RelativeFormatStyle_PresentationSwift declarationvar presentation: Date.AnchoredRelativeFormatStyle.Presentation { get set }set presentation(value: Date_RelativeFormatStyle_Presentation)Swift declarationvar presentation: Date.AnchoredRelativeFormatStyle.Presentation { get set }get allowedFields(): Array<Date_ComponentsFormatStyle_Field>Swift declarationvar allowedFields: Set<Date.AnchoredRelativeFormatStyle.Field> { get set }The fields that can be used in the formatted output.
set allowedFields(value: Array<Date_ComponentsFormatStyle_Field>)Swift declarationvar allowedFields: Set<Date.AnchoredRelativeFormatStyle.Field> { get set }The fields that can be used in the formatted output.
discreteInputAfter(input: globalThis.Date): (globalThis.Date) | nullSwift declarationfunc discreteInput(after input: Date) -> Date?The next discretization boundary after the given input. Use this function to determine the next "greater" input that warrants updating the formatted output. The following example prints all possible outputs the format style can produce upwards starting from the `startInput`: ```swift var previousInput = startInput while let nextInput = style.discreteInput(after: previousInput) { print(style.format(nextInput)) previousInput = nextInput } ``` - Returns: For most `input`s, the method returns the "smallest" value "greater" than `input` for which the style produces a different ``FormatStyle/FormatOutput``, or `nil` if no such value exists. For some input values, the function may also return a value "greater" than `input` for which the style still produces the same ``FormatStyle/FormatOutput`` as for `input`.
discreteInputBefore(input: globalThis.Date): (globalThis.Date) | nullSwift declarationfunc discreteInput(before input: Date) -> Date?The next discretization boundary before the given input. Use this function to determine the next "smaller" input that warrants updating the formatted output. The following example prints all possible outputs the format style can produce downwards starting from the `startInput`: ```swift var previousInput = startInput while let nextInput = style.discreteInput(before: previousInput) { print(style.format(nextInput)) previousInput = nextInput } ``` - Returns: For most `input`s, the method returns the "greatest" value "smaller" than `input` for which the style produces a different ``FormatStyle/FormatOutput``, or `nil` if no such value exists. For some input values, the function may also return a value "smaller" than `input` for which the style still produces the same ``FormatStyle/FormatOutput`` as for `input`.
get capitalizationContext(): FormatStyleCapitalizationContextSwift declarationvar capitalizationContext: FormatStyleCapitalizationContext { get set }set capitalizationContext(value: FormatStyleCapitalizationContext)Swift declarationvar capitalizationContext: FormatStyleCapitalizationContext { get set }inputAfter(input: globalThis.Date): (globalThis.Date) | nullSwift declarationfunc input(after input: Date) -> Date?The next input value after the given input. Use this function to determine if the return value provided by ``discreteInput(before:)`` is precise enough for your use case for any input `y`: ```swift guard let x = style.discreteInput(before: y) else { return } let z = style.input(after: x) ?? y ``` If the distance between `x` and `z` is too large for the precision you require, you may want to manually probe ``FormatStyle/format(_:)`` at a higher rate in that interval, as there is no guarantee for what the output will be in that interval. - Returns: The next "greater" input value that can be represented by ``FormatStyle/FormatInput`` or an underlying representation the format style uses internally.
inputBefore(input: globalThis.Date): (globalThis.Date) | nullSwift declarationfunc input(before input: Date) -> Date?The next input value before the given input. Use this function to determine if the return value provided by ``discreteInput(after:)`` is precise enough for your use case for any input `y`: ```swift guard let x = style.discreteInput(after: y) else { return } let z = style.input(before: x) ?? y ``` If the distance between `z` and `x` is too large for the precision you require, you may want to manually probe ``FormatStyle/format(_:)`` at a higher rate in that interval, as there is no guarantee for what the output will be in that interval. - Returns: The next "smalller" input value that can be represented by ``FormatStyle/FormatInput`` or an underlying representation the format style uses internally.
static initAnchorPresentationUnitsStyleLocaleCalendarCapitalizationContext(anchor: globalThis.Date, presentation?: Date_RelativeFormatStyle_Presentation, unitsStyle?: Date_RelativeFormatStyle_UnitsStyle, locale?: Locale, calendar?: Calendar, capitalizationContext?: FormatStyleCapitalizationContext): Date_AnchoredRelativeFormatStyleSwift declarationinit(anchor: Date, presentation: Date.AnchoredRelativeFormatStyle.Presentation = .numeric, unitsStyle: Date.AnchoredRelativeFormatStyle.UnitsStyle = .wide, locale: Locale = .autoupdatingCurrent, calendar: Calendar = .autoupdatingCurrent, capitalizationContext: FormatStyleCapitalizationContext = .unknown)Create a relative format style that is detached from the system time, and instead formats an anchor date relative to the format input. - Parameter anchor: The date the formatted output is referring to.
static initAnchorAllowedFieldsPresentationUnitsStyleLocaleCalendarCapitalizationContext(anchor: globalThis.Date, allowedFields: Array<Date_ComponentsFormatStyle_Field>, presentation?: Date_RelativeFormatStyle_Presentation, unitsStyle?: Date_RelativeFormatStyle_UnitsStyle, locale?: Locale, calendar?: Calendar, capitalizationContext?: FormatStyleCapitalizationContext): Date_AnchoredRelativeFormatStyleSwift declarationinit(anchor: Date, allowedFields: Set<Date.AnchoredRelativeFormatStyle.Field>, presentation: Date.AnchoredRelativeFormatStyle.Presentation = .numeric, unitsStyle: Date.AnchoredRelativeFormatStyle.UnitsStyle = .wide, locale: Locale = .autoupdatingCurrent, calendar: Calendar = .autoupdatingCurrent, capitalizationContext: FormatStyleCapitalizationContext = .unknown)Create a relative format style that is detached from the system time, and instead formats an anchor date relative to the format input. - Parameter anchor: The date the formatted output is referring to.
get anchor(): globalThis.DateSwift declarationvar anchor: DateThe date the formatted output refers to from the perspective of the input values.
set anchor(value: globalThis.Date)Swift declarationvar anchor: DateThe date the formatted output refers to from the perspective of the input values.
format(input: globalThis.Date): stringSwift declarationfunc format(_ input: Date) -> StringFormats a value, using this style. Use this method when you want to create a single style instance, and then use it to format multiple values. - Parameter value: The value to format. - Returns: A representation of `value`, in the ``FormatOutput`` type, formatted according to the style's configuration.
get locale(): LocaleSwift declarationvar locale: Locale { get set }set locale(value: Locale)Swift declarationvar locale: Locale { get set }locale88239(locale: Locale): Date_AnchoredRelativeFormatStyleSwift declarationfunc locale(_ locale: Locale) -> Date.AnchoredRelativeFormatStyleModifies the format style to use the specified locale. Use this format style to change the locale used by an existing format style. - Parameter locale: The locale to apply to the format style. - Returns: A format style modified to use the provided locale.
get calendar(): CalendarSwift declarationvar calendar: Calendar { get set }set calendar(value: Calendar)Swift declarationvar calendar: Calendar { get set }No declarations were skipped in this snapshot.