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
   *   UTS #35: Unicode LDML, Part 3: Numbers
       <http://www.unicode.org/reports/tr35/tr35-numbers.html>

   *   CLDR Translation Guidelines: Number Patterns
       <http://cldr.unicode.org/translation/number-patterns>

   *   CLDR Translation Guidelines: Number Symbols
       <http://cldr.unicode.org/translation/number-symbols>

AUTHOR
   Nick Patch <[email protected]>

   This project is brought to you by Perl CLDR
   <http://perl-cldr.github.io/> and Shutterstock
   <http://www.shutterstock.com/>. Additional open source projects from
   Shutterstock can be found at code.shutterstock.com
   <http://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.

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.