The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
CLDR-Number-0.00_03
River stage one • 7 direct dependents • 9 total dependents
9 ++
/ CLDR::Number

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

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

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