This pod is a (hopefully) very small library to short format numbers like this: http://cldr.unicode.org/translation/numbers-currency/number-patterns#TOC-Compact-decimal-formatting-Short-Numbers.
It's main purpose is for formatting pricing information (though it will format any number) - for example 1,100,000 would become £1.1M in en_GB, but would become £110万 in ja_JP.
It should
- deal with localisation (i.e. some locales group by 4 digits, not 3)
- deal with pricing correctly (i.e. put the right currency symbol in the right place)
- deal with long/short versions i.e. 1M vs. 1 million.
Long term, this should just be handled in Foundation - there shouldn't really be a need for this pod.
To run the example project, clone the repo and look in Example/.
nmbr is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'nmbr'Create a NMBRFormatter
let formatter = NMBRFormatter()Configure the formatter
// This defaults to 2
formatter.precision = 1
// This is optional - it defaults to the current device locale
formatter.locale = NSLocale(identifier: "en_GB")
// If you want a currency symbol, set the currency code. If not, leave it as `nil`
formatter.currencyCode = "GBP"Use the formatter
myLabel.text = formatter.string(123.456) // "£123.46"Reuse formatters whenever you can - they aren't going to be free to create (at the moment they are fairly cheap, but we reserve the right to make creating them slower if it will improve the speed when you actually format a number)
Formatting a number isn't going to be free either - I probably wouldn't use a formatter in a tableview / collectionview cell for example - I would cache the text result somewhere (MVVM to the resuce, if that's your thing ;)
deanWombourne, [email protected]
nmbr is available under the MIT license. See the LICENSE file for more info.