How to format currency in Swift with locale using Format?

Use the Currency enum with the format extension, e.g., `99.format(Currency.USD, locale: customLocale)` to get locale-aware strings with correct symbols and separators, simplifying international displays.

Format vs NumberFormatter for iOS: which should I use?

Format offers a cleaner, more concise API for common tasks like currency and decimals with built-in locale handling, but NumberFormatter provides more granular control and customization for complex formatting scenarios.

How to convert a hex color string to UIColor with Format?

Call `ColorFormatter().format("hexCode")` to get a UIColor; it defaults to black for empty strings or white for invalid inputs, ensuring no crashes in UI code.

Does Format support date or time formatting?

No, Format does not include date or time formatting; you'll need to use Apple's DateFormatter or other libraries for those types, as it's focused on numbers, addresses, and colors.

How to handle address formatting in iOS with Format without warnings?

For iOS 9.0+, use `AddressFormatter().format(...)` for custom addresses to avoid CLPlacemark deprecation warnings, but note it still has locale limitations and version constraints.

Is Format compatible with SwiftUI?

Yes, Format can be used in SwiftUI projects for formatting strings and UIColor, but it's primarily designed for UIKit/macOS, so integration might require bridging for some SwiftUI-specific types.

Open-Awesome

Format

MITSwift0.5.0

A Swift formatter kit providing simple formatting syntax for numbers, currency, addresses, and colors.

GitHub

1.2k stars43 forks0 contributors

What is Format?

Format is a Swift formatter kit that provides a simple and intuitive API for formatting various data types in iOS and macOS applications. It solves the problem of verbose and complex formatting code by offering extensions for numbers, currency, addresses, and colors with built-in locale support.

Target Audience

iOS and macOS developers who need to format numbers, currency, addresses, or colors in their Swift applications, especially those working on internationalized apps requiring locale-aware formatting.

Value Proposition

Developers choose Format for its clean, extension-based syntax that reduces boilerplate, its comprehensive support for common formatting tasks, and its seamless integration with Swift's type system and locale handling.

Overview

A Swift Formatter Kit

Use Cases

Best For

Formatting currency values with locale-specific symbols and separators
Converting hexadecimal color strings from APIs into UIColors
Displaying addresses in the correct format for different countries
Formatting numbers with consistent decimal places or ordinal suffixes
Internationalizing apps with locale-aware number and distance formatting
Reducing boilerplate code when working with Foundation formatters

Not Ideal For

Projects supporting iOS versions below 9.0 that require address formatting
Applications needing extensive date or time formatting not covered by the kit
Teams prioritizing zero-deprecation warnings and strict adherence to Apple's latest APIs
High-performance apps where abstraction layers might introduce unnecessary overhead

Pros & Cons

Pros

Clean Extension Syntax

Provides intuitive format extensions on all number types, drastically reducing boilerplate compared to using Foundation's NumberFormatter directly.

Built-in Locale Support

Defaults to the user's current locale and allows easy customization with Locale objects, simplifying internationalization for numbers, currency, and distances.

Comprehensive Common Formats

Covers decimal numbers, currency, mass, addresses, ordinal numbers, and hex colors in one package, addressing most everyday formatting needs.

Error Handling for Colors

Color formatter defaults to black or white for invalid or empty hex strings, preventing crashes and ensuring UI stability.

Cons

Deprecated Address APIs

The address formatting function relies on CLPlacemark's addressDictionary with deprecated AddressBook keys, causing warnings and potential future breakage.

Limited Data Type Coverage

Does not support formatting for dates or times, common in apps, forcing developers to use separate solutions like DateFormatter.

iOS Version Constraints

Address formatting is only available for iOS 9.0+, making it unsuitable for apps that need to support older versions without workarounds.

Frequently Asked Questions

Related Projects

YYText

Powerful text framework for iOS to display and edit rich text.

Stars8,862

Forks1,845

Last commit2 years ago

Nimbus

The iOS framework that grows only as fast as its documentation

Stars6,402

Forks1,269

Last commit2 years ago

DTCoreText

Methods to allow using HTML code with CoreText

Stars6,391

Forks1,180

Last commit3 months ago

PhoneNumberKit

A Swift framework for parsing, formatting and validating international phone numbers. Inspired by Google's libphonenumber.

Stars5,392

Forks850

Last commit5 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub