الفرق بين المراجعتين لصفحة: «Twig/number format»
< Twig
أسامه-دمراني (نقاش | مساهمات) 1.0: إضافة عنوان الصفحة | 2.0 محتوى الصفحة |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: المرشح number_format في Twig}}</noinclude> | <noinclude>{{DISPLAYTITLE: المرشح number_format في Twig}}</noinclude> | ||
المرشح number_format يعدل تنسيق الأعداد، وهو مغلِّف حول دالة <code>number_format</code> الخاصة بلغة PHP:<syntaxhighlight lang="twig"> | المرشح <code>number_format</code> يعدل تنسيق الأعداد، وهو مغلِّف حول دالة <code>[[PHP/number format|number_format]]</code> الخاصة بلغة [[PHP]]:<syntaxhighlight lang="twig"> | ||
{{ 200.35|number_format }} | {{ 200.35|number_format }} | ||
</syntaxhighlight>يمكن التحكم في عدد المواضع العشرية والنقاط العشرية وفواصل الآلاف باستخدام وسائط إضافية:<syntaxhighlight lang="twig"> | </syntaxhighlight>يمكن التحكم في عدد المواضع العشرية والنقاط العشرية وفواصل الآلاف باستخدام وسائط إضافية:<syntaxhighlight lang="twig"> | ||
{{ 9800.333|number_format(2, '.', ',') }} | {{ 9800.333|number_format(2, '.', ',') }} | ||
</syntaxhighlight>ولتنسيق الأرقام السالبة أو الحسابات الرياضية، تغلَّف التعليمة السابقة بقوسين، وهما مطلوبان بسبب [[Twig/templates|أسبقية العوامل في Twig]]:<syntaxhighlight lang="twig"> | </syntaxhighlight>ولتنسيق الأرقام السالبة أو الحسابات الرياضية، تغلَّف التعليمة السابقة بقوسين، وهما مطلوبان بسبب [[Twig/templates#.D8.A7.D9.84.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1.D8.A7.D8.AA|أسبقية العوامل في Twig]]:<syntaxhighlight lang="twig"> | ||
{{ -9800.333|number_format(2, '.', ',') }} {# outputs : -9 #} | {{ -9800.333|number_format(2, '.', ',') }} {# outputs : -9 #} | ||
{{ (-9800.333)|number_format(2, '.', ',') }} {# outputs : -9,800.33 #} | {{ (-9800.333)|number_format(2, '.', ',') }} {# outputs : -9,800.33 #} | ||
سطر 15: | سطر 15: | ||
* <code>,</code> كفاصلة للآلاف. | * <code>,</code> كفاصلة للآلاف. | ||
يمكن تغيير هذه القيم الافتراضية في | يمكن تغيير هذه القيم الافتراضية في توسعة النواة <code>core</code>:<syntaxhighlight lang="twig"> | ||
$twig = new \Twig\Environment($loader); | $twig = new \Twig\Environment($loader); | ||
$twig->getExtension(\Twig\Extension\CoreExtension::class)->setNumberFormat(3, '.', ','); | $twig->getExtension(\Twig\Extension\CoreExtension::class)->setNumberFormat(3, '.', ','); | ||
</syntaxhighlight>كذلك يمكن تخطي القيم الافتراضية في number_format عند كل استدعاء باستخدام معامِلات إضافية. | </syntaxhighlight>كذلك يمكن تخطي القيم الافتراضية في <code>number_format</code> عند كل استدعاء باستخدام معامِلات إضافية. | ||
== الوسائط == | == الوسائط == | ||
سطر 27: | سطر 27: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* [[Twig/intro|مقدمة عن محرك القوالب Twig | *[[Twig/intro|مقدمة عن محرك القوالب Twig]] | ||
* [[Twig/advanced|توسيع Twig | *[[Twig/advanced|توسيع Twig]] | ||
* [[Twig/internals|المكونات الداخلية لـ Twig | *[[Twig/internals|المكونات الداخلية لـ Twig]] | ||
* [[Twig/tags|الوسوم في Twig]] | *[[Twig/tags|الوسوم في Twig]] | ||
* [[ Twig/filters|المرشحات في Twig]] | *[[ Twig/filters|المرشحات في Twig]] | ||
== المصادر == | == المصادر == | ||
* [https://twig.symfony.com/doc/3.x/filters/number_format.html صفحة | * [https://twig.symfony.com/doc/3.x/filters/number_format.html صفحة المرشح number_format في توثيق Twig الرسمي] | ||
[[تصنيف:Twig]] | [[تصنيف:Twig]] | ||
[[تصنيف:Twig Filters]] | [[تصنيف:Twig Filters]] |
مراجعة 07:55، 6 مايو 2021
المرشح 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
: المحرف أو المحارف التي يجب استخدامها لفاصلة الآلاف.