Back to Twig

``currency_names``

doc/functions/currency_names.rst

3.24.01.2 KB
Original Source

currency_names

.. versionadded:: 3.5

The ``currency_names`` function was added in Twig 3.5.

The currency_names function returns the names of the currencies:

.. code-block:: twig

{# Afghan Afghani, Afghan Afghani (1927–2002), ... #}
{{ currency_names()|join(', ') }}

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

.. code-block:: twig

{# afghani (1927–2002), afghani afghan, ... #}
{{ currency_names('fr')|join(', ') }}

.. note::

The ``currency_names`` function is part of the ``IntlExtension`` which is not
installed by default. Install it first:

.. code-block:: bash

    $ composer require twig/intl-extra

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

.. code-block:: bash

    $ composer require twig/extra-bundle

Otherwise, add the extension explicitly on the Twig environment::

    use Twig\Extra\Intl\IntlExtension;

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

Arguments

  • locale: The locale code as defined in RFC 5646_

.. _RFC 5646: https://www.rfc-editor.org/info/rfc5646