الگو:سن به سال، ماه و روز/توضیحات: تفاوت میان نسخه‌ها
(ساخت الگو) |
بدون خلاصۀ ویرایش |
||
| خط ۱: | خط ۱: | ||
{{زیرصفحه توضیحات}} | {{زیرصفحه توضیحات}} | ||
{{الگوی پیچیده}} | {{الگوی پیچیده}} | ||
<!-- لطفاً رده‌ها را جایی که در پایین این صفحه اشاره شده‌است قرار دهید و | <!-- لطفاً رده‌ها را جایی که در پایین این صفحه اشاره شده‌است قرار دهید و میان‌داده‌ها را هم در انبارداده ([[اسلامیکال:انبارداده]] را ببینید) --> | ||
== استفاده == | == استفاده == | ||
{{چپ‌چین}} | {{چپ‌چین}} | ||
This template returns the number of full years, then surplus months, then surplus days between two specified dates. If the second set of parameters is not included, it will return the number of years, months and days between a specified date and today's date. The words "year", "month" and "day" are plural when appropriate. | This template returns the number of full years, then surplus months, then surplus days between two specified dates. If the second set of parameters is not included, it will return the number of years, months and days between a specified date and today's date. The words "year", "month" and "day" are plural when appropriate. | ||
The years and months are separated by a comma. Since [[ | The years and months are separated by a comma. Since [[اسلامیکال:شیوه‌نامه]] and use varies, this template does not automatically place a comma after the months. If a serial comma is desired, adding {{پارا|sc|y}} to the template invocation will include one. | ||
{{پایان چپ‌چین}} | {{پایان چپ‌چین}} | ||
| خط ۹۴: | خط ۹۴: | ||
<includeonly>{{#ifeq:{{SUBPAGENAME}}|تمرین | | | <includeonly>{{#ifeq:{{SUBPAGENAME}}|تمرین | | | ||
<!-- رده‌ها زیر این خط، لطفاً؛ | <!-- رده‌ها زیر این خط، لطفاً؛ میان‌داده در انبارداده --> | ||
[[رده:الگو:محاسبه تاریخ]] | [[رده:الگو:محاسبه تاریخ]] | ||
}}</includeonly> | }}</includeonly> | ||
نسخهٔ کنونی تا ۲۵ ژانویهٔ ۲۰۲۳، ساعت ۰۸:۲۳
 | این زیرصفحهٔ مستندات الگو:سن به سال، ماه و روز است. این شامل اطلاعات استفاده، الگوها، پیوندهای بین زبانی و سایر اطلاعات است که در اصل الگو صفحه قرار نمی‌گیرد. |
 | این الگو از ویژگی و دستورهای پیچیده استفاده می‌کند.
توصیه می‌شود پیش از ویرایش الگو با دستورهای الگو و توابع تجزیه‌کننده آشنا شوید. اگر ویرایش‌تان باعث بروز مشکلات غیرمنتظره شد، خواهشمند است آن را به‌سرعت برگردانید، زیرا ممکن است این الگو در شمار زیادی صفحه ظاهر شود. به‌یاد داشته باشید که شما می‌توانید آزمایش انجام دهید، اما باید همهٔ بهسازی‌ها را پیش از آن‌که در اینجا اعمال کنید، در صفحهٔ تمرین عمومی الگو یا فضای کاربری‌تان بیازمایید. |
استفاده
This template returns the number of full years, then surplus months, then surplus days between two specified dates. If the second set of parameters is not included, it will return the number of years, months and days between a specified date and today's date. The words "year", "month" and "day" are plural when appropriate.
The years and months are separated by a comma. Since اسلامیکال:شیوه‌نامه and use varies, this template does not automatically place a comma after the months. If a serial comma is desired, adding |sc=y to the template invocation will include one.
ترکیب
{{سن به سال، ماه و روز|year= |month= |day= }}و یا{{سن به سال، ماه و روز|yyyy|mm|dd|yyyy2|mm2|dd2}}
نمونه‌ها
{{سن به سال، ماه و روز|year=2001|month=1|day=15}}بازمی‌گرداند به "۲۳ سال، ۱۰ ماه و ۷ روز"{{سن به سال، ماه و روز|2001|01|15|2008|09|05}}بازمی‌گرداند به "۷ سال، ۷ ماه و ۲۱ روز"{{سن به سال، ماه و روز|2016|8|4|2016|9|5}}بازمی‌گرداند به "۱ ماه و ۱ روز"
ملاحظات
این الگو می تواند با یک تاریخ شروع مبهم به کار برود:
{{سن به سال، ماه و روز|year=2010|month=9}}بازمی‌گرداند به "۱۴ سال و ۱ یا ۲ ماه"{{سن به سال، ماه و روز|2009|6||2011|2|21}}بازمی‌گرداند به "۱ سال و ۷ یا ۸ ماه"
اما تاریخ پایانِ نامحتمل را نمی‌پذیرد:
{{سن به سال، ماه و روز|2012|11|2|2016|4}}بازمی‌گرداند به "خطا: زمان نامعتبر است. ۳ سال، ۵ ماه و ۲۰ روز"{{سن به سال، ماه و روز|2012|11|2|2017}}بازمی‌گرداند به "خطا: زمان نامعتبر است. ۵ سال و ۲۰ روز"
از آنجایی که طول یک ماه، برحسب روز، متفاوت است، تعداد روزها در خروجی، به عدد ماه درج شده، بستگی دارد.
{{سن به سال، ماه و روز|2007|3|12|2015|6|11}}بازمی‌گرداند به "۸ سال، ۲ ماه و ۳۰ روز"{{سن به سال، ماه و روز|2007|3|12|2015|7|11}}بازمی‌گرداند به "۸ سال، ۳ ماه و ۲۹ روز"
{{سن به سال، ماه و روز|2016|11|8|sc=y}}بازمی‌گرداند به "۸ سال و ۱۴ روز"
داده‌های الگو
الگوداده سن به سال، ماه و روز
این الگو تعداد سال‌ها (کامل‌شده)، ماه‌ها و روزهای باقی‌مانده بین دو تاریخ را برمی‌گرداند. اگر بخش دوم از پارامترها تنظیم نشده باشد، آن را به تعداد سال، ماه و روز بین تاریخ تعیین شده و تاریخ امروز باز خواهد گرداند.
| پارامتر | توضیحات | نوع | وضعیت | |
|---|---|---|---|---|
| Year ('from' date) | 1 year | سال تاريخ (اول) | شماره | ضروری |
| Month ('from' date) | 2 month | شماره ماه تاريخ (اول) | شماره | ضروری |
| Day of month ('from' date) | 3 day | روز ماه تاريخ (اول) | شماره | اختیاری |
| Year ('to' date) | 4 | The year of the 'to' date, if required
| شماره | اختیاری |
| Month ('to' date) | 5 | Number of the month of the 'to' date, if required
| شماره | اختیاری |
| Day of month ('to' date) | 6 | The day of the month of the 'to' date, if required
| شماره | اختیاری |
| Serial comma | sc | Enter 'y' to turn on the serial comma after the months
| خط | اختیاری |
جستارهای وابسته