format_currency

You are reading the documentation for Twig 2.x. Switch to the documentation for Twig 1.x, 3.x.

Warning Twig version 2.x is no longer maintained.

Questions & Feedback

Found a typo or an error?
Want to improve this document? Edit it.

Need support or have a technical question?
Ask support on Stack Overflow.

License

Twig documentation is licensed under the new BSD license.

`format_currency`

2.12

The format_currency filter was added in Twig 2.12.

The format_currency filter formats a number as a currency:

        1
2
        {# €1,000,000.00 #}
{{ '1000000'|format_currency('EUR') }}
    

You can pass attributes to tweak the output:

        1
2
3
4
5
        {# €12.34 #}
{{ '12.345'|format_currency('EUR', {rounding_mode: 'floor'}) }}

{# €1,000,000.0000 #}
{{ '1000000'|format_currency('EUR', {fraction_digit: 4}) }}
    

The list of supported options:

grouping_used;
decimal_always_shown;
max_integer_digit;
min_integer_digit;
integer_digit;
max_fraction_digit;
min_fraction_digit;
fraction_digit;
multiplier;
grouping_size;
rounding_mode;
rounding_increment;
format_width;
padding_position;
secondary_grouping_size;
significant_digits_used;
min_significant_digits_used;
max_significant_digits_used;
lenient_parse.

By default, the filter uses the current locale. You can pass it explicitly:

        1
2
        {# 1.000.000,00 € #}
{{ '1000000'|format_currency('EUR', locale='de') }}
    

Note

The format_currency filter is part of the IntlExtension which is not installed by default. Install it first:

        1
        $ composer require twig/intl-extra
    

Then, on Symfony projects, install the twig/extra-bundle:

        1
        $ composer require twig/extra-bundle
    

Otherwise, add the extension explicitly on the Twig environment:

        1
2
3
4
        use Twig\Extra\Intl\IntlExtension;

$twig = new \Twig\Environment(...);
$twig->addExtension(new IntlExtension());
    

Arguments

currency: The currency
attrs: A map of attributes
locale: The locale