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

זהו דף התיעוד עבור יחידה:תאריך

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

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

חשב

פורמט	דוגמה	תוצאה
יום	{{#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-03Z

הערות:

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

חשב טווח

	דוגמה	תוצאה
פורמט ברירת מחדל: אוטומטי	{{#invoke:תאריך\|חשב טווח\|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]}}	66 שנים
פורמט ברירת מחדל: אוטומטי (דוגמה עם שנים וסימן מינוס)	{{#invoke:תאריך\|חשב טווח\|1947 - 2013}}	כ־66 שנים
פורמט ברירת מחדל: אוטומטי (דוגמה עם שנים וסימן קו מפריד)	{{#invoke:תאריך\|חשב טווח\|1947–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 שנים בשנים ושבועות
- מעבר לזה רק בשנים

בדיקות

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

^ א
^ ב
^ ב
^ ב
^ ב
^ ב
^ ב

[1] א

[2] ב

[3] ב

[4] ב

[5] ב

[6] ב

[7] ב