الگو:سن به سال، ماه و روز/توضیحات
 | این زیرصفحهٔ مستندات الگو:سن به سال، ماه و روز است. این شامل اطلاعات استفاده، الگوها، پیوندهای بین زبانی و سایر اطلاعات است که در اصل الگو صفحه قرار نمی‌گیرد. |
 | این الگو از ویژگی و دستورهای پیچیده استفاده می‌کند.
توصیه می‌شود پیش از ویرایش الگو با دستورهای الگو و توابع تجزیه‌کننده آشنا شوید. اگر ویرایش‌تان باعث بروز مشکلات غیرمنتظره شد، خواهشمند است آن را به‌سرعت برگردانید، زیرا ممکن است این الگو در شمار زیادی صفحه ظاهر شود. به‌یاد داشته باشید که شما می‌توانید آزمایش انجام دهید، اما باید همهٔ بهسازی‌ها را پیش از آن‌که در اینجا اعمال کنید، در صفحهٔ تمرین عمومی الگو یا فضای کاربری‌تان بیازمایید. |
استفاده
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|10|20|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
| خط | اختیاری |
جستارهای وابسته