יחידה:תאריך/תיעוד

יחידה זו מיועדת לביצוע פעולות נפוצות על תאריכים.

• #חשב - מקבלת תאריך טקסטואלי ופורמט ומחלצת את מהתאריך את הפורמט הרצוי
• #חשב טווח - מקבלת טווח תאריכים ומחשבת את ההפרש ביניהם

חשב

פורמט	דוגמה	תוצאה
יום	{{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]|יום}}	3
יום	{{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]{{הערה|א}}|יום}}	3
חודש	{{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]|חודש}}	2
שנה	{{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]|שנה}}	2013
שנה	{{#invoke:תאריך|חשב|[[פברואר]] [[2013]]|שנה}}	2013
TS	{{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]|TS}}	2013-02-03

הערות:

• פורמט TS ניתן להעביר לפונקציות זמן של הוראות תנאי.
• ההמרה מתעלמת מסוגריים מרובעות של קישורים
• ניתן להוסיף פרמטר error והתוכן שלו יוצג במקרה של שגיאה בתאריך. (רצוי להכניס במקרה כזה את הדף לקטגוריה כלשהי שתאפשר מעקב אחרי דפים לא תקינים. ברירת המחדל היא קטגוריה:דפים עם שגיאות בתאריך)

חשב טווח

	דוגמה	תוצאה
פורמט ברירת מחדל: אוטומטי	{{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]}}	66 שנים
שנים	{{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]|שנים}}	66 שנים
גיל	{{#invoke:תאריך|חשב טווח|1 במרץ 1922 - 4 בנובמבר 1995|גיל}}	73
גיל	{{#invoke:תאריך|חשב טווח|1 במרץ 1922{{הערה|ב}} - 4 בנובמבר 1995|גיל}}	73
גיל	{{#invoke:תאריך|חשב טווח|1 במרץ 1994{{הערה|ב}} - 4 בנובמבר 1995|גיל}}	שנה
גיל	{{#invoke:תאריך|חשב טווח|1 במרץ 1993{{הערה|ב}} - 4 בנובמבר 1995|גיל}}	שנתיים
מספר	{{#invoke:תאריך|חשב טווח|1 במרץ 1922 - 4 בנובמבר 1995|מספר}}	73
מספר	{{#invoke:תאריך|חשב טווח|1 במרץ 1922{{הערה|ב}} - 4 בנובמבר 1995|מספר}}	73
מספר	{{#invoke:תאריך|חשב טווח|1 במרץ 1994{{הערה|ב}} - 4 בנובמבר 1995|מספר}}	1
מספר	{{#invoke:תאריך|חשב טווח|1 במרץ 1993{{הערה|ב}} - 4 בנובמבר 1995|מספר}}	2
שנים לפנה"ס	{{#invoke:תאריך|חשב טווח|[[3 בפברואר]] 1900 לפנה"ס - [[15 בספטמבר]] [[2013]]|שנים}}	3,913 שנים
ימים	{{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]|ימים}}	24,331 ימים
הפרש	{{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]|הפרש}}	2102198400
ללא תאריך יעד	{{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]]|שנים}}	77 שנים
לא כולל היום האחרון	{{#invoke:תאריך|חשב טווח|5 ביוני 1967 - 10 ביוני 1967}}	5 ימים
כולל היום האחרון	{{#invoke:תאריך|חשב טווח|5 ביוני 1967 - 10 ביוני 1967|כולל=כן}}	6 ימים
כולל היום האחרון	{{#invoke:תאריך|חשב טווח|14 ספטמבר 2014 - 14 ספטמבר 2014|כולל=כן}}
שנה ויום	{{#invoke:תאריך|חשב טווח|14 ספטמבר 2014 - 15 ספטמבר 2015|כולל=כן}}	שנה

הערות:

• כאשר לא ניתן תאריך יעד תאריך היעד נקבע כזמן הנוכחי
• הפרש - מציין את הפרש הזמנים בשניות וללא מילים. ניתן להשתמש בערך המוחזר בחלוקה מתאימה לקבלת יחידות זמן אחרות.
• ניתן להוסיף פרמטר כולל=כן, ואז נלקח בחשבון גם היום האחרון. כשמדובר על טווח זמן ארוך והפורמט נבחר אוטומטי או שמכיל שנים, מתקבלת תוצאה מקורבת.
• ניתן להוסיף פרמטר error והתוכן שלו יוצג במקרה של שגיאה בטווח התאריכים. (רצוי להכניס במקרה כזה את הדף לקטגוריה כלשהי שתאפשר מעקב אחרי דפים לא תקינים. ברירת המחדל היא קטגוריה:דפים עם שגיאות בתאריך)
• אם לא מצוין פורמט, הוא נבחר אוטומטית:
  • עד ל-3 שבועות הוא מוצג בימים
  • עד שנה הוא מוצג בימים ושבועות
  • עד ל-10 שנים בשנים ושבועות
  • מעבר לזה רק בשנים

בדיקות

דוגמאות לשימוש ביחידה ופלט לדוגמה מודגמים ביחידה:תאריך/בדיקות.