PHP money_format() Function












❮ مرجع رشته PHP




مثال


قالب بین المللی en_US:




$number = 1234.56;

setlocale(LC_MONETARY,en_US");

echo money_format("قیمت %i است"، $number)؛

?>

خروجی کد بالا این خواهد بود:



قیمت 1234.56 دلار آمریکا است






تعریف و استفاده


عملکرد money_format() یک رشته فرمت شده به عنوان رشته ارز را برمی گرداند.


این تابع یک عدد قالب‌بندی شده را درج می‌کند که در آن علامت درصد (%) در رشته اصلی وجود دارد.


توجه: عملکرد money_format() روی پلتفرم‌های ویندوز کار نمی‌کند.


نکته: این تابع اغلب همراه با استفاده می شود
تابع setlocale().


نکته: برای مشاهده همه کدهای زبان موجود، به مرجع کد زبان ما بروید.




نحو



قالب_پول (رشته، عدد)


مقادیر پارامتر













درج شود

پارامتر توضیح
رشته لازم است. رشته ای که باید قالب بندی شود و نحوه قالب بندی متغیرهای موجود در آن را مشخص می کند.

مقادیر قالب احتمالی:



پرچم و پر کردن:



  • =f - کاراکتر (f) را برای استفاده به عنوان بالشتک مشخص می کند (مثال: %=t از "t" به عنوان بالشتک استفاده می کند). پیش فرض فاصله
    • است
  • ^ - استفاده از کاراکترهای گروه بندی را حذف می کند

  • + یا ( - نحوه نمایش اعداد مثبت و منفی را مشخص می کند. در صورت استفاده از "+"، تنظیمات محلی برای + و - استفاده می شود (معمولاً علامتی در جلوی اعداد منفی و هیچ چیز در مقابل اعداد مثبت وجود ندارد. اگر از "(" استفاده شود، اعداد منفی در پرانتز قرار می گیرند. پیش فرض "+" است

  • ! - استفاده از نمادهای ارز در رشته خروجی
    • را متوقف می کند
  • - اگر از "-" استفاده شود، تمام فیلدها به سمت چپ توجیه می شوند. پیش فرض درست توجیه شده است



عرض فیلد:



  • x - حداقل عرض فیلد (x) را مشخص می کند. پیش فرض 0
    • است
  • C#x - حداکثر تعداد (x) ارقام مورد انتظار در سمت چپ نقطه اعشار را مشخص می کند. این برای تراز نگه داشتن خروجی فرمت شده در همان ستون ها استفاده می شود. اگر تعداد ارقام بزرگتر از x باشد، این مشخصات نادیده گرفته می شود

  • .x - حداکثر تعداد (x) ارقام مورد انتظار در سمت راست نقطه اعشار را مشخص می کند. اگر x 0 باشد، اعشار و اعداد سمت راست آن نشان داده نمی شوند. پیش فرض تنظیمات محلی است



کاراکترهای تبدیل:



  • i - شماره به فرمت ارز بین‌المللی قالب‌بندی شده است

  • n - شماره به قالب پول ملی قالب‌بندی شده است

  • % - نویسه % را برمی‌گرداند



توجه: اگر چندین مقدار قالب استفاده می شود، باید به همان ترتیبی باشد که در بالا نشان داده شده است.


توجه: این عملکرد تحت تأثیر تنظیمات محلی است.
شماره لازم است. عددی که باید در علامت %- در رشته قالب










جزئیات فنی





می شود





مقدار بازگشتی: رشته فرمت شده را برمی گرداند. کاراکترهای قبل و بعد از رشته قالب‌بندی بدون تغییر برگردانده می‌شوند. عدد غیر عددی باعث برگرداندن NULL و انتشار E_WARNING
نسخه PHP: 4.3.0+




نمونه های بیشتر



مثال


قالب بین المللی (آلمان) با 2 اعشار:




$number = 1234.56;

setlocale(LC_MONETARY,"de_DE");

echo money_format("%.2n"، $number);

?>

خروجی کد بالا این خواهد بود:



1 234,56 یورو




مثال


عدد منفی، قالب ملی ایالات متحده با () برای نشان دادن اعداد منفی و
2 رقم با دقت درست و "*" به عنوان کاراکتر پر:




$number = -1234.5672;

echo money_format("%=*(C#10.2n",$number);

?>

خروجی کد بالا این خواهد بود:



(*******1234.57)




❮ مرجع رشته PHP