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

VERSION
    This document describes CLDR::Number v0.00_03, built with Unicode CLDR
    v24. This is a development release without full documentation and
    functionality may change. 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)

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.

    locale
        Default: value of "default_locale" attribute if exists, otherwise
        "root"

        Valid: Unicode locale identifier

    default_locale
        Default: none

        Valid: Unicode locale identifier

    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

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 <patch@cpan.org>

    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 Nick Patch

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