# formatted(_:referenceDate:) Formats the subscription period using a format style that takes a date range as an input. ``` @backDeployed(before: iOS 16.0, macOS 13.0, tvOS 16.0, watchOS 9.0, macCatalyst 16.0) func formatted(_ format: S, referenceDate: Date = .now) -> S.FormatOutput where S : FormatStyle, S.FormatInput == Range ``` ## Parameters `format` A format style that has a date range input. The format style for a product is [`subscriptionPeriodFormatStyle`](/documentation/StoreKit/Product/subscriptionPeriodFormatStyle). `referenceDate` The lower bound date for a date range representing the subscription period. The default value is . ## Discussion Use the [`formatted(_:referenceDate:)`](/documentation/StoreKit/Product/SubscriptionPeriod/formatted(_:referenceDate:)-3t7wd) method with [`subscriptionPeriodFormatStyle`](/documentation/StoreKit/Product/subscriptionPeriodFormatStyle) to format the subscription period for the App Store locale, as the following example shows. ```swift // Get a human-readable representation of a subscription period. subscriptionPeriod.formatted(product.subscriptionPeriodFormatStyle, referenceDate: /* some date */) ``` --- 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)