المرشح number_format في Twig

من موسوعة حسوب

المرشح number_format يعدل تنسيق الأعداد، وهو مغلِّف حول دالة number_format الخاصة بلغة PHP:

{{ 200.35|number_format }}

يمكن التحكم في عدد المواضع العشرية والنقاط العشرية وفواصل الآلاف باستخدام وسائط إضافية:

{{ 9800.333|number_format(2, '.', ',') }}

ولتنسيق الأرقام السالبة أو الحسابات الرياضية، تغلَّف التعليمة السابقة بقوسين، وهما مطلوبان بسبب أسبقية العوامل في Twig:

{{ -9800.333|number_format(2, '.', ',') }} {# outputs : -9 #}
{{ (-9800.333)|number_format(2, '.', ',') }} {# outputs : -9,800.33 #}
{{  1 + 0.2|number_format(2) }} {# outputs : 1.2 #}
{{ (1 + 0.2)|number_format(2) }} {# outputs : 1.20 #}

إذا لم تتوفر خيارات صياغة فسيستخدم Twig خيارات التنسيق الافتراضية، وهي:

  • لا توجد مواضع عشرية.
  • . كفاصلة عشرية.
  • , كفاصلة للآلاف.

يمكن تغيير هذه القيم الافتراضية في توسعة النواة core:

$twig = new \Twig\Environment($loader);
$twig->getExtension(\Twig\Extension\CoreExtension::class)->setNumberFormat(3, '.', ',');

كذلك يمكن تخطي القيم الافتراضية في number_format عند كل استدعاء باستخدام معامِلات إضافية.

الوسائط

  • decimal: عدد المواضع العشرية التي يجب عرضها.
  • decimal_point: المحرف أو المحارف التي يجب استخدامها للفاصلة العشرية.
  • thousand_sep: المحرف أو المحارف التي يجب استخدامها لفاصلة الآلاف.

انظر أيضًا

المصادر