NAME

CLDR::Number::Format::Percent - Localized percent formatter using the Unicode CLDR

VERSION

This document describes CLDR::Number v0.00_02, built with Unicode CLDR v24. This is a development release without full documentation and functionality may change. See CLDR::Number::TODO.

SYNOPSIS

# either
use CLDR::Number::Format::Percent;
my $perf = CLDR::Number::Format::Percent->new(locale => 'eu');

# or
use CLDR::Number;
my $cldr = CLDR::Number->new(locale => 'tr');
my $perf = $cldr->percent_formatter;

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

$perf->locale('es');
say $perf->format(0.05);  # '5 %' (French percent)

$perf->permil(1);
say $perf->format(0.05);  # '50 ‰' (French per mil)

METHODS

format

Accepts a number and returns a formatted percent, localized with the current locale. If the permil attribute is true, returns per mil instead of percent.

ATTRIBUTES

See also the common attributes in CLDR::Number.

permil

Default: false (0)

percent_sign

Default: % when root locale

permil_sign

Default: ‰ when root locale

pattern

Default: #,##0% when root locale

minimum_integer_digits

Default: 1 when root locale

minimum_fraction_digits

Default: 0 when root locale

maximum_fraction_digits

Default: 0 when root locale

primary_grouping_size

Default: 3 when root locale

secondary_grouping_size

Default: not set when root locale

rounding_increment

Default: 0 when root locale

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.