عرض مصدر Twig/format currency

{{DISPLAYTITLE: المرشح format_currency في Twig}}<noinclude>{{DISPLAYTITLE: المرشح format_currency في Twig}}</noinclude>
يه{{DISPLAYTITLE: المرشح format_currency في Twig}}يئ المرشح <code>format_currency</code> العدد ليكون على صيغة العملة:<syntaxhighlight lang="twig">
{# €1,000,000.00 #}
{{ '1000000'|format_currency('EUR') }}
</syntaxhighlight>
يمكن تمرير سمات (attributes) من أجل تعديل الخرج:
<syntaxhighlight lang="twig">
{# €12.34 #}
{{ '12.345'|format_currency('EUR', {rounding_mode: 'floor'}) }}

{# €1,000,000.0000 #}
{{ '1000000'|format_currency('EUR', {fraction_digit: 4}) }}
</syntaxhighlight>
القائمة التالية تحتوي على الخيارات المدعومة:

* <code>grouping_used</code>
* <code>decimal_always_shown</code>
* <code>max_integer_digit</code>
* <code>min_integer_digit</code>
* <code>integer_digit</code>
* <code>max_fraction_digit</code>
* <code>min_fraction_digit</code>
* <code>fraction_digit</code>
* <code>multiplier</code>
* <code>grouping_size</code>
* <code>rounding_mode</code>
* <code>rounding_increment</code>
* <code>format_width</code>
* <code>padding_position</code>
* <code>secondary_grouping_size</code>
* <code>significant_digits_used</code>
* <code>min_significant_digits_used</code>
* <code>max_significant_digits_used</code>
* <code>lenient_parse</code>

يستخدم المرشح الإعدادات المحلية افتراضيًا، ويمكن تمريرها صراحة إليه:
<syntaxhighlight lang="twig">
{# 1.000.000,00 £ #}
{{ '1000000'|format_currency('EGP', locale='eg') }}
</syntaxhighlight>
لاحظ أن المرشح <code>format_currency</code> جزء من <code>IntlExtension</code> وهذا لا يكون مثبتًا افتراضيًا، لذا ثبته أولًا:
<syntaxhighlight lang="twig">
$ composer require twig/intl-extra
</syntaxhighlight>
ثم ثبت <code>twig/extra-bundle</code> في حالة مشاريع Symfony:
<syntaxhighlight lang="twig">
$ composer require twig/extra-bundle
</syntaxhighlight>
أما غير ذلك فأضف التوسيع صراحة إلى بيئة Twig:
<syntaxhighlight lang="php">
use Twig\Extra\Intl\IntlExtension;

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

== الوسائط ==

* <code>currency</code>: العملة.
* <code>attrs</code>: خريطة للسمات.
* <code>locale</code>: الإعدادات المحلية.

== انظر أيضًا ==
* [[Twig/intro|مقدمة عن محرك القوالب Twig]]
* [[Twig/advanced|توسيع Twig]]
* [[Twig/internals|المكونات الداخلية لـ Twig]]
* [[Twig/tags|الوسوم في Twig]]
* [[ Twig/filters|المرشحات في Twig]]
== المصادر ==
* [https://twig.symfony.com/doc/3.x/filters/format_currency.html صفحة توثيق المرشح format_currency في توثيق Twig الرسمي].

[[تصنيف:Twig]]
[[تصنيف:Twig Filters]]