در حال ویرایش الگو:Formatnumber/توضیحات

{{زیرصفحه توضیحات}}
<!-- لطفاً رده‌ها را جایی که در پایین این صفحه اشاره شده‌است قرار دهید و میان‌ویکی‌ها را هم در ویکی‌داده ([[ویکی‌هزاره:ویکی‌داده]] را ببینید) -->
{{Lua|پودمان:Numeral converter}}
این الگو، جایگزینی است برای دستور <code dir=ltr><nowiki>{{formatnum:...}}</nowiki></code> در مدیاویکی. کاربرد این الگو وقتی است که ورودی، یک عدد نباشد بلکه رشته‌ای غیرعددی شامل باشد که شامل ارقام است.

دستور ''formatnum'' (یا معادل فارسی‌اش: ''آرایش‌عدد'') وقتی به کار می‌رود که یک عدد را از زبانی به زبان دیگر بازآرایی می‌کنیم. مثلاً برای تبدیل عدد انگلیسی 123 به معادلش در الفبای فارسی می‌توانیم از دستور <code dir=ltr><nowiki>{{formatnum:123}}</nowiki></code> یا <code><nowiki>{{آرایش‌عدد:123}}</nowiki></code> استفاده کنیم که خروجی هر دوی آن‌ها {{آرایش‌عدد:123}} خواهد بود. دستور ''formatnum'' همچنین تبدیل برعکس را هم پشتیبانی می‌کند، یعنی اگر در ویکی‌هزاره <code dir=ltr><nowiki>{{formatnum:۱۲۳|R}}</nowiki></code> را استفاده کنید، خروجی‌اش عدد {{formatnum:۱۲۳|R}} با ارقام انگلیسی خواهد بود. (برای توضیحات بیشتر راجع به ''formatnum'' می‌توانید [[mw:Help:Magic_words#Formatting]] را ببینید).

دستور ''formatnum'' ورودی‌هایی که عدد نباشند ولی حاوی ارقام باشند را هم تحمل می‌کند. مثلاً رشتهٔ «12:34» یک عدد نیست، بلکه حاصل ترکیب دو عدد 12 و 34 با استفاده از یک نویسهٔ غیر عددی (دونقطه) است. با این حال، <code dir=ltr><nowiki>{{formatnum:12:34}}</nowiki></code> کماکان کار می‌کند و خروجی‌اش «۱۲:۳۴» است. منتها از نوامبر ۲۰۲۰ به بعد، هر جا ورودی ''formatnum'' عدد نباشد، صفحه در یک [[:رده:صفحه‌های دارای تابع تجزیه‌گر آرایش‌عدد با آرگومان غیرعددی|رده]] قرار می‌گیرد تا کاربران ویکی‌هزاره نسبت به استفادهٔ نادرست از ''formatnum'' آگاه شوند و آن را بعداً اصلاح کنند.

در مواردی از این دست، الگوی ''formatnumber'' (که اسمش عمداً شبیه به ''formatnum'' انتخاب شده) به کار می‌آید. این الگو، اساساً برای تبدیل رشته‌های حاوی ارقام از زبانی به زبان دیگر طراحی شده‌است و اهمیت نمی‌دهد که آیا ورودی‌اش یک عدد است یا نه.

== استفاده ==
برای تبدیل ارقام ورودی از انگلیسی به فارسی از <code dir=ltr><nowiki>{{formatnumber|...}}</nowiki></code> استفاده کنید که به جای ... ورودی را قرار می‌دهید.

برای تبدیل ارقام ورودی از فارسی به انلگیسی از <code dir=ltr><nowiki>{{formatnumber|...|R}}</nowiki></code> استفاده کنید که به جای ... ورودی را قرار می‌دهید.

== نکات مهم ==
توجه کنید که ''formatnumber'' یک الگو است، لذا پس از نامش یک خط عمودی قرار می‌گیرد: <code dir=ltr><nowiki>{{formatnumber</nowiki><span style="color:red">|</span><nowiki>...}}</nowiki></code> اما ''formatnum'' یک دستور داخلی مدیاویکی است و پس از نامش یک دونقطه قرار می‌گیرد، مثل <code dir=ltr><nowiki>{{formatnum</nowiki><span style="color:red">:</span><nowiki>...}}</nowiki></code>.

همچنین توجه کنید که ''formatnum'' را فقط وقتی با ''formatnumber'' جایگزین کنید که انتظار دارید ورودی حاوی ارقام باشد اما عدد نباشد. وقتی ورودی عدد است (مثل سال، شمار صفحه‌ها، و ...) از همان ''formatnum'' استفاده کنید.

همچنین توجه کنید که ''formatnum'' ویژگی‌های دیگری نیز دارد که برای کار با ارقام مناسب است (مثلاً می‌توانید مشخص کنید که آیا برای اعداد چهاررقم به بالا از جداکنندهٔ هزارگان استفاده کند یا نه) ولی الگوی ''formatnumber'' اساساً نسبت به اعداد بی‌تفاوت است و صرفاً به جایگزین نویسه‌های ارقام از زبانی به زبان دیگر می‌پردازد. این نیز باز دلیلی است برای آن که از ''formatnumber'' فقط وقتی استفاده کنید که ورودی، عدد نیست. مثال‌هایی از رشته‌های حاوی رقم که عدد نیستند عبارتند از: موقعیت زمانی یک مطلب در پروندهٔ صوتی یا تصویری (مثل 24:03 که به معنای دقیقهٔ ۲۴ و ثانیهٔ ۳ است)، موقعیت‌های جغرافیایی که به صورت درجه و دقیقه و ثانیه ذکر شده باشند، و غیره.

=== الگوهای وابسته ===
* {{الگو|عدد به فارسی}}
* {{الگو|Formatnum}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|تمرین | |
<!-- رده‌ها و میان‌ویکی‌ها را در اینجا اضافه کنید، ممنون -->

[[رده:الگو:اعداد]]
}}</includeonly>