عدد¶

اگر به عملکرد NumberHelper در خارج از یک نمای نیاز دارید ، از کلاس شماره استفاده کنید:

نام برنامه  کنترلر; استفاده کنید کیک  i18n  شماره; طبقه کاربران تمدید کردن برنامه ساز  عمومی تابع شروع کردن(): خالی  والدین::شروع کردن(); این>اجزای بار("auth"); > عمومی تابع پس از سال()  $ ذخیره سازی = این>زبان>کاربر("ذخیره سازی"); if ($ ذخیره سازی > 5000000)  // به کاربران از سهمیه اطلاع دهید این>فلاش>موفقیت(__("شما از ذخیره سازی استفاده می کنید", عدد::شبهه($ ذخیره سازی))); > > > 

همه این توابع شماره فرمت شده را برمی گردانند. آنها به طور خودکار خروجی را در نمای تکرار نمی کنند.

قالب بندی مقادیر ارزی ¶

کیک i18n شماره :: ارز (ارزش $ مخلوط ، رشته $ ارز = تهی ، آرایه $ گزینه = [])

از این روش برای نمایش تعدادی در قالب های ارز مشترک (EUR ، GBP ، USD) بر اساس کد ارز ISO 4217 3 حرف استفاده می شود. استفاده در یک نمای مانند:

// به عنوان NumberHelper خوانده می شود پژواک این>عدد>واحد پول(ارزش $, ارز); // به عنوان شماره نامیده می شود پژواک عدد::واحد پول(ارزش $, ارز); 

اولین پارامتر ، مقدار $ ، باید یک شماره نقطه شناور باشد که میزان پولی را که بیان می کنید نشان می دهد. پارامتر دوم رشته ای است که برای انتخاب یک طرح قالب بندی ارز از پیش تعریف شده استفاده می شود:

1234. 56 ، با نوع ارز فرمت شده است

پارامتر سوم مجموعه ای از گزینه ها برای تعریف بیشتر خروجی است. گزینه های ذیل در دسترس هستند:

متن برای نمایش قبل از شماره ارائه شده.

متن برای نمایش بعد از شماره ارائه شده.

متن برای استفاده برای مقادیر صفر ؛می تواند یک رشته یا یک عدد باشد. یعنی0 ، "رایگان!"

تعداد مکان های اعشاری برای استفاده ، یعنی. 2

حداکثر تعداد اعشاری برای استفاده ، یعنی. 2

نام محلی برای استفاده برای شماره قالب بندی ، یعنی."fr_fr".

رشته برای استفاده برای شماره های کسری ، یعنی."سنت"

یا "قبل" یا "بعد" برای قرار دادن نماد کسری.

یک الگوی شماره ICU برای استفاده برای قالب بندی شماره IE.#,###. 00

برای جایگزینی نماد ارز با کد بین المللی ارز تنظیم کنید.

اگر مقدار ارز $ تهی باشد ، ارز پیش فرض از کیک i18n شماره :: پیش فرض Currency () بازیابی می شود. برای قالب بندی ارزها در قالب حسابداری باید قالب ارز را تنظیم کنید:

عدد::setDefaultCurrencyFormat(عدد::format_currency_accounting); 

تنظیم ارز پیش فرض

کیک i18n شماره :: setDefaultCurrency (ارز $)

تنظیم کننده برای ارز پیش فرض. این امر نیاز به انتقال همیشه ارز را به کیک i18n شماره :: ارز () و تغییر کلیه خروجی های ارزی با تنظیم پیش فرض دیگر را برطرف می کند. اگر ارز $ روی تهی تنظیم شود ، مقدار ذخیره شده در حال حاضر را پاک می کند.

دریافت ارز پیش فرض

کیک i18n شماره :: getDefaultCurrency ()

گیرنده برای ارز پیش فرض. اگر ارز پیش فرض زودتر با استفاده از setDefaultCurrency () تنظیم شده باشد ، این مقدار بازگردانده می شود. به طور پیش فرض ، در صورت تنظیم و "en_us" اگر نه ، مقدار intl. default_locale را بازیابی می کند.

قالب بندی شماره های نقطه شناور

کیک i18n شماره :: دقت (مقدار شناور $ ، int $ دقت = 3 ، آرایه $ گزینه ها = [])

این روش یک عدد را با مقدار مشخصی از دقت (مکان های اعشاری) نشان می دهد. به منظور حفظ سطح دقت تعریف شده ، دور می شود.

// به عنوان NumberHelper خوانده می شود پژواک این>عدد>دقت، درستی(456. 91873645, 2); // خروجی ها 456. 92 // به عنوان شماره نامیده می شود پژواک عدد::دقت، درستی(456. 91873645, 2); 

قالب بندی درصد

کیک i18n شماره :: topercentage (مقدار مخلوط $ ، int $ Precision = 2 ، Array $ گزینه ها = []) ¶

بولی برای نشان دادن اینکه آیا مقدار باید 100 برابر شود. برای درصد اعشاری مفید است.

مانند کیک i18n شماره :: دقیق () ، این روش با توجه به دقت عرضه شده ، یک عدد را تشکیل می دهد (جایی که شماره ها برای مطابقت با دقت مشخص شده گرد هستند). این روش همچنین تعداد را به عنوان درصد بیان می کند و خروجی را با یک درصد درصد ضمیمه می کند.

// به عنوان NumberHelper نامیده می شود. خروجی: 45. 69 ٪ پژواک این>عدد>مرکز دهی(45. 691873645); // به عنوان شماره نامیده می شود. خروجی: 45. 69 ٪ پژواک عدد::مرکز دهی(45. 691873645); // با ضرب. خروجی: 45. 7 ٪ پژواک عدد::مرکز دهی(0. 45691, 1, [ 'تکثیر کردن' => درست است، واقعی ]); 

تعامل با ارزشهای قابل خواندن انسان ¶

کیک i18n شماره :: toreadablesize (رشته $ اندازه)

این روش اندازه داده ها را به اشکال قابل خواندن در انسان قالب بندی می کند. این یک روش میانبر برای تبدیل بایت به KB ، MB ، GB و سل را فراهم می کند. اندازه با توجه به اندازه داده های عرضه شده با یک سطح دقیق دو رقمی نمایش داده می شود (یعنی اندازه های بالاتر با اصطلاحات بزرگتر بیان می شود):

// به عنوان NumberHelper خوانده می شود پژواک این>عدد>شبهه(0); // 0 بایت پژواک این>عدد>شبهه(1024); // 1 KB پژواک این>عدد>شبهه(1321205. 76); // 1. 26 مگابایت پژواک این>عدد>شبهه(5368709120); // 5 گیگابایت // به عنوان شماره نامیده می شود پژواک عدد::شبهه(0); // 0 بایت پژواک عدد::شبهه(1024); // 1 KB پژواک عدد::شبهه(1321205. 76); // 1. 26 مگابایت پژواک عدد::شبهه(5368709120); // 5 گیگابایت 

قالب بندی شماره ها

کیک i18n شماره :: فرمت (مقدار $ مخلوط ، آرایه $ گزینه ها = [])

این روش کنترل بیشتری را در قالب بندی اعداد برای استفاده در نماهای شما به شما می دهد (و توسط بیشتر روشهای شماره شماره دیگر به عنوان روش اصلی استفاده می شود). استفاده از این روش ممکن است به نظر برسد:

// به عنوان NumberHelper خوانده می شود این>عدد>قالب(ارزش $, گزینه های $); // به عنوان شماره نامیده می شود عدد::قالب(ارزش $, گزینه های $); 

پارامتر $ Value شماره ای است که شما در حال برنامه ریزی برای قالب بندی برای خروجی هستید. بدون ارائه گزینه های $ ، شماره 1236. 334 به عنوان 1،236 تولید می شود. توجه داشته باشید که دقت پیش فرض مکان های اعشاری صفر است.

پارامتر $ گزینه ها جایی است که جادوی واقعی این روش در آن قرار دارد.

• اگر یک عدد صحیح را منتقل کنید ، این مقدار دقت یا مکان هایی برای عملکرد می شود.
• اگر یک آرایه مرتبط را منتقل کنید ، می توانید از کلیدهای زیر استفاده کنید:

تعداد مکان های اعشاری برای استفاده ، یعنی. 2

حداکثر تعداد اعشاری برای استفاده ، یعنی. 2

یک الگوی شماره ICU برای استفاده برای قالب بندی شماره IE.#,###. 00

نام محلی برای استفاده برای شماره قالب بندی ، یعنی."fr_fr".

متن برای نمایش قبل از شماره ارائه شده.

متن برای نمایش بعد از شماره ارائه شده.

// به عنوان NumberHelper خوانده می شود پژواک این>عدد>قالب('123456. 7890', [ "مکان ها" => 2, 'قبل از' => '¥ ', 'بعد از' => ' !' ]); // خروجی "123،456. 79!"! پژواک این>عدد>قالب('123456. 7890', [ "محلی" => 'fr_fr' ]); // خروجی '123 456،79!' // به عنوان شماره نامیده می شود پژواک عدد::قالب('123456. 7890', [ "مکان ها" => 2, 'قبل از' => '¥ ', 'بعد از' => ' !' ]); // خروجی "123،456. 79!"! پژواک عدد::قالب('123456. 7890', [ "محلی" => 'fr_fr' ]); // خروجی '123 456،79!' 

کیک i18n شماره :: ترتیب (مقدار مخلوط $ ، گزینه های array $ = [])

این روش یک شماره معمولی را تولید می کند.

پژواک عدد::مرتد(1); // خروجی '1' پژواک عدد::مرتد(2); // خروجی '2' پژواک عدد::مرتد(2, [ "محلی" => 'fr_fr' ]); // خروجی '2e' پژواک عدد::مرتد(410); // خروجی '410th' 

تفاوت های قالب

کیک i18n شماره :: formatdelta (مقدار $ مخلوط ، آرایه $ گزینه ها = [])

این روش تفاوت در مقدار را به عنوان یک شماره امضا شده نشان می دهد:

// به عنوان NumberHelper خوانده می شود این>عدد>Formaldelta(ارزش $, گزینه های $); // به عنوان شماره نامیده می شود عدد::Formaldelta(ارزش $, گزینه های $); 

پارامتر $ Value شماره ای است که شما در حال برنامه ریزی برای قالب بندی برای خروجی هستید. بدون ارائه گزینه های $ ، شماره 1236. 334 به عنوان 1،236 تولید می شود. توجه داشته باشید که دقت پیش فرض مکان های اعشاری صفر است.

پارامتر گزینه های $ همان کلیدها را به عنوان شماره :: خود () می گیرد:

تعداد مکان های اعشاری برای استفاده ، یعنی. 2

حداکثر تعداد اعشاری برای استفاده ، یعنی. 2

نام محلی برای استفاده برای شماره قالب بندی ، یعنی."fr_fr".

متن برای نمایش قبل از شماره ارائه شده.

متن برای نمایش بعد از شماره ارائه شده.

// به عنوان NumberHelper خوانده می شود پژواک این>عدد>Formaldelta('123456. 7890', [ "مکان ها" => 2, 'قبل از' => '[', 'بعد از' => ']' ]); // خروجی '[+123،456. 79]' // به عنوان شماره نامیده می شود پژواک عدد::Formaldelta('123456. 7890', [ "مکان ها" => 2, 'قبل از' => '[', 'بعد از' => ']' ]); // خروجی '[+123،456. 79]' 

پیکربندی Formatters¶

کیک i18n شماره :: پیکربندی (رشته $ locale ، int $ type = numberFormatter :: اعشاری ، array $ گزینه ها = []) ¶

این روش به شما امکان می دهد پیش فرض های Formatter را پیکربندی کنید که در تماس با روش های مختلف باقی مانده است.

عدد::پیکربندی('en_in',  numberformatter::واحد پول, [ 'الگو' => '#,##,##0 ' ]);