/ 
CLDR-Number-0.04
⭐ Starred 8 / CLDR::Number

NAME

CLDR::Number - Localized number formatters using the Unicode CLDR

VERSION

This document describes CLDR::Number v0.04, built with the Unicode CLDR v24. This is an early release without full documentation. See CLDR::Number::TODO.

SYNOPSIS

use CLDR::Number;

my $cldr = CLDR::Number->new(locale => 'es');

# decimals
my $decf = $cldr->decimal_formatter;

say $decf->format(1234.5);  # '1 234,5' (Spanish)

$decf->locale('es-MX');
say $decf->format(1234.5);  # '1,234.5' (Mexican Spanish)

# percents
my $perf = $cldr->percent_formatter(locale => 'tr');

say $perf->format(0.05);  # '%5' (Turkish)

# currencies
my $curf = $cldr->currency_formatter(
    locale        => 'en',
    currency_code => 'USD',
);

say $curf->format(9.99);  # '$9.99' (English / USD)

$curf->locale('en-CA');
say $curf->format(9.99);  # 'US$9.99' (Canadian English / USD)

$curf->locale('fr-CA');
say $curf->format(9.99);  # '9,99 $US' (Canadian French / USD)

DESCRIPTION

Software localization includes much more than just translations. Numbers, prices, and even percents should all be localized based the user’s language, script, and region. Fortunately, the Unicode Common Locale Data Repository (CLDR) provides locale data and specifications for formatting numeric data to use with many of the world’s locales.

This class provides common attributes shared among the supported formatter classes as well as methods to instantiate decimal, percent, and currency formatter objects. The value for any attribute (such as locale) will be passed to the formatter objects on instantiation but can be overwritten by manually passing another value for the attribute or calling a setter method on the formatter object.

Methods

decimal_formatter

Returns a decimal formatter, which is a CLDR::Number::Format::Decimal object instantiated with all of the attributes from your CLDR::Number object as well as any attributes passed to this method.

percent_formatter

Returns a percent formatter, which is a CLDR::Number::Format::Percent object instantiated with all of the attributes from your CLDR::Number object as well as any attributes passed to this method.

currency_formatter

Returns a currency formatter, which is a CLDR::Number::Format::Currency object instantiated with all of the attributes from your CLDR::Number object as well as any attributes passed to this method.

Common Attributes

Common attributes among all formatter objects. All string attributes are expected to be character strings, not encoded byte strings.

locale

Default: value of default_locale attribute if exists, otherwise root

Valid: Unicode locale identifier

Examples: es (Spanish), es-ES (European Spanish), es-419 (Latin American Spanish), zh-Hant (Traditional Chinese), zh-Hans (Simplified Chinese), chr (Cherokee)

The locale is case-insensitive and can use either - (hyphen-minus) or _ (low line) as a separator.

default_locale

Default: none

Valid: Unicode locale identifier

Use this if you want a locale other than the generic root if the locale attribute is not set or not valid.

decimal_sign

Default: . when root locale

group_sign

Default: , when root locale

plus_sign

Default: + when root locale

minus_sign

Default: - when root locale

cldr_version

Value: 24

This is a read-only attribute that will always reflect the currently supported Unicode CLDR version.

NOTES

The Unicode private-use characters U+F8F0 through U+F8F4 are used internally and are therefore not supported in custom patterns and signs.

SEE ALSO

AUTHOR

Nick Patch <patch@cpan.org>

This project is brought to you by Perl CLDR and Shutterstock. Additional open source projects from Shutterstock can be found at code.shutterstock.com.

COPYRIGHT AND LICENSE

© 2013–2014 Shutterstock, Inc.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.