الگو:Formatnumber/توضیحات: تفاوت میان نسخهها
صفحهای تازه حاوی «{{زیرصفحه توضیحات}} <!-- لطفاً ردهها را جایی که در پایین این صفحه اشاره شدهاست قرار دهید و میانویکیها را هم در ویکیداده (ویکیپدیا:ویکیداده را ببینید) --> {{Lua|پودمان:Numeral converter}} این الگو، جایگزینی است برای دستور <code dir=ltr><nowiki>{{formatnum:...}}</nowi...» ایجاد کرد |
بدون خلاصۀ ویرایش |
||
| خط ۱: | خط ۱: | ||
{{زیرصفحه توضیحات}} | {{زیرصفحه توضیحات}} | ||
<!-- لطفاً ردهها را جایی که در پایین این صفحه اشاره شدهاست قرار دهید و میانویکیها را هم در ویکیداده ([[ | <!-- لطفاً ردهها را جایی که در پایین این صفحه اشاره شدهاست قرار دهید و میانویکیها را هم در ویکیداده ([[ویکیهزاره:ویکیداده]] را ببینید) --> | ||
{{Lua|پودمان:Numeral converter}} | {{Lua|پودمان:Numeral converter}} | ||
این الگو، جایگزینی است برای دستور <code dir=ltr><nowiki>{{formatnum:...}}</nowiki></code> در مدیاویکی. کاربرد این الگو وقتی است که ورودی، یک عدد نباشد بلکه رشتهای غیرعددی شامل باشد که شامل ارقام است. | این الگو، جایگزینی است برای دستور <code dir=ltr><nowiki>{{formatnum:...}}</nowiki></code> در مدیاویکی. کاربرد این الگو وقتی است که ورودی، یک عدد نباشد بلکه رشتهای غیرعددی شامل باشد که شامل ارقام است. | ||
دستور ''formatnum'' (یا معادل فارسیاش: ''آرایشعدد'') وقتی به کار میرود که یک عدد را از زبانی به زبان دیگر بازآرایی میکنیم. مثلاً برای تبدیل عدد انگلیسی 123 به معادلش در الفبای فارسی میتوانیم از دستور <code dir=ltr><nowiki>{{formatnum:123}}</nowiki></code> یا <code><nowiki>{{آرایشعدد:123}}</nowiki></code> استفاده کنیم که خروجی هر دوی آنها {{آرایشعدد:123}} خواهد بود. دستور ''formatnum'' همچنین تبدیل برعکس را هم پشتیبانی میکند، یعنی اگر در | دستور ''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'' ورودیهایی که عدد نباشند ولی حاوی ارقام باشند را هم تحمل میکند. مثلاً رشتهٔ «12:34» یک عدد نیست، بلکه حاصل ترکیب دو عدد 12 و 34 با استفاده از یک نویسهٔ غیر عددی (دونقطه) است. با این حال، <code dir=ltr><nowiki>{{formatnum:12:34}}</nowiki></code> کماکان کار میکند و خروجیاش «۱۲:۳۴» است. منتها از نوامبر ۲۰۲۰ به بعد، هر جا ورودی ''formatnum'' عدد نباشد، صفحه در یک [[:رده:صفحههای دارای تابع تجزیهگر آرایشعدد با آرگومان غیرعددی|رده]] قرار میگیرد تا کاربران ویکیهزاره نسبت به استفادهٔ نادرست از ''formatnum'' آگاه شوند و آن را بعداً اصلاح کنند. | ||
در مواردی از این دست، الگوی ''formatnumber'' (که اسمش عمداً شبیه به ''formatnum'' انتخاب شده) به کار میآید. این الگو، اساساً برای تبدیل رشتههای حاوی ارقام از زبانی به زبان دیگر طراحی شدهاست و اهمیت نمیدهد که آیا ورودیاش یک عدد است یا نه. | در مواردی از این دست، الگوی ''formatnumber'' (که اسمش عمداً شبیه به ''formatnum'' انتخاب شده) به کار میآید. این الگو، اساساً برای تبدیل رشتههای حاوی ارقام از زبانی به زبان دیگر طراحی شدهاست و اهمیت نمیدهد که آیا ورودیاش یک عدد است یا نه. | ||
نسخهٔ کنونی تا ۳۰ دسامبر ۲۰۲۵، ساعت ۲۲:۳۴
 | این زیرصفحهٔ مستندات الگو: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 که به معنای دقیقهٔ ۲۴ و ثانیهٔ ۳ است)، موقعیتهای جغرافیایی که به صورت درجه و دقیقه و ثانیه ذکر شده باشند، و غیره.
الگوهای وابسته
- {{عدد به فارسی}}
- {{Formatnum}}