پرش به محتوا

الگو:Formatnumber

الگو به طور دائم حفاظت‌شده است
از ویکی‌پدیا، دانشنامهٔ آزاد
توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

این الگو، جایگزینی است برای دستور {{formatnum:...}} در مدیاویکی. کاربرد این الگو وقتی است که ورودی، یک عدد نباشد بلکه رشته‌ای غیرعددی شامل باشد که شامل ارقام است.

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

دستور formatnum ورودی‌هایی که عدد نباشند ولی حاوی ارقام باشند را هم تحمل می‌کند. مثلاً رشتهٔ «12:34» یک عدد نیست، بلکه حاصل ترکیب دو عدد 12 و 34 با استفاده از یک نویسهٔ غیر عددی (دونقطه) است. با این حال، {{formatnum:12:34}} کماکان کار می‌کند و خروجی‌اش «۱۲:۳۴» است. منتها از نوامبر ۲۰۲۰ به بعد، هر جا ورودی formatnum عدد نباشد، صفحه در یک رده قرار می‌گیرد تا کاربران ویکی‌پدیا نسبت به استفادهٔ نادرست از formatnum آگاه شوند و آن را بعداً اصلاح کنند.

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

استفاده

برای تبدیل ارقام ورودی از انگلیسی به فارسی از {{formatnumber|...}} استفاده کنید که به جای ... ورودی را قرار می‌دهید.

برای تبدیل ارقام ورودی از فارسی به انلگیسی از {{formatnumber|...|R}} استفاده کنید که به جای ... ورودی را قرار می‌دهید.

نکات مهم

توجه کنید که formatnumber یک الگو است، لذا پس از نامش یک خط عمودی قرار می‌گیرد: {{formatnumber|...}} اما formatnum یک دستور داخلی مدیاویکی است و پس از نامش یک دونقطه قرار می‌گیرد، مثل {{formatnum:...}}.

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

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

الگوهای وابسته