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

יחידה זו מיועדת לביצוע פעולות נפוצות על תאריכים.
*[[#חשב]] - מקבלת תאריך טקסטואלי ופורמט ומחלצת את מהתאריך את הפורמט הרצוי
*[[#חשב טווח]] - מקבלת טווח תאריכים ומחשבת את ההפרש ביניהם

==חשב==
{| class="wikitable"
! פורמט !! דוגמה !! תוצאה
|-
|יום
| <nowiki>{{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]|יום}}</nowiki>
| {{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]|יום}}
|-
|יום
| <nowiki>{{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]{{הערה|א}}|יום}}</nowiki>
| {{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]{{הערה|א}}|יום}}
|-
| חודש
| <nowiki>{{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]|חודש}}</nowiki>
| {{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]|חודש}}
|-
|שנה 
| <nowiki>{{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]|שנה}}</nowiki>
| {{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]|שנה}}
|-
|שנה 
| <nowiki>{{#invoke:תאריך|חשב|[[פברואר]] [[2013]]|שנה}}</nowiki>
| {{#invoke:תאריך|חשב|[[פברואר]] [[2013]]|שנה}}
|-
| TS
| <nowiki>{{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]|TS}}</nowiki>
| {{#invoke:תאריך|חשב|[[3 בפברואר]] [[2013]]|TS}}
|}

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

==חשב טווח==
{| class="wikitable"
!  !! דוגמה !! תוצאה
|-
|פורמט ברירת מחדל: אוטומטי
| <nowiki>{{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]}}</nowiki>
| {{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]}}
|-
| שנים
| <nowiki>{{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]|שנים}}</nowiki>
| {{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]|שנים}}
|-
| גיל
| <nowiki>{{#invoke:תאריך|חשב טווח|1 במרץ 1922 - 4 בנובמבר 1995|גיל}}</nowiki>
| {{#invoke:תאריך|חשב טווח|1 במרץ 1922 - 4 בנובמבר 1995]|גיל}}
|-
| גיל
| <nowiki>{{#invoke:תאריך|חשב טווח|1 במרץ 1922{{הערה|ב}} - 4 בנובמבר 1995|גיל}}</nowiki>
| {{#invoke:תאריך|חשב טווח|1 במרץ 1922{{הערה|ב}} - 4 בנובמבר 1995]|גיל}}
|-
| גיל
| <nowiki>{{#invoke:תאריך|חשב טווח|1 במרץ 1994{{הערה|ב}} - 4 בנובמבר 1995|גיל}}</nowiki>
| {{#invoke:תאריך|חשב טווח|1 במרץ 1994{{הערה|ב}} - 4 בנובמבר 1995]|גיל}}
|-
| גיל
| <nowiki>{{#invoke:תאריך|חשב טווח|1 במרץ 1993{{הערה|ב}} - 4 בנובמבר 1995|גיל}}</nowiki>
| {{#invoke:תאריך|חשב טווח|1 במרץ 1993{{הערה|ב}} - 4 בנובמבר 1995]|גיל}}
|-
| מספר
| <nowiki>{{#invoke:תאריך|חשב טווח|1 במרץ 1922 - 4 בנובמבר 1995|מספר}}</nowiki>
| {{#invoke:תאריך|חשב טווח|1 במרץ 1922 - 4 בנובמבר 1995]|מספר}}
|-
| מספר
| <nowiki>{{#invoke:תאריך|חשב טווח|1 במרץ 1922{{הערה|ב}} - 4 בנובמבר 1995|מספר}}</nowiki>
| {{#invoke:תאריך|חשב טווח|1 במרץ 1922{{הערה|ב}} - 4 בנובמבר 1995]|מספר}}
|-
| מספר
| <nowiki>{{#invoke:תאריך|חשב טווח|1 במרץ 1994{{הערה|ב}} - 4 בנובמבר 1995|מספר}}</nowiki>
| {{#invoke:תאריך|חשב טווח|1 במרץ 1994{{הערה|ב}} - 4 בנובמבר 1995]|מספר}}
|-
| מספר
| <nowiki>{{#invoke:תאריך|חשב טווח|1 במרץ 1993{{הערה|ב}} - 4 בנובמבר 1995|מספר}}</nowiki>
| {{#invoke:תאריך|חשב טווח|1 במרץ 1993{{הערה|ב}} - 4 בנובמבר 1995]|מספר}}
|-
| שנים לפנה"ס
| <nowiki>{{#invoke:תאריך|חשב טווח|[[3 בפברואר]] 1900 לפנה"ס - [[15 בספטמבר]] [[2013]]|שנים}}</nowiki>
| {{#invoke:תאריך|חשב טווח|[[3 בפברואר]] 1900 לפנה"ס - [[15 בספטמבר]] [[2013]]|שנים}}
|-
| ימים
| <nowiki>{{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]|ימים}}</nowiki>
| {{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]|ימים}}
|-
| הפרש
| <nowiki>{{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]|הפרש}}</nowiki>
| {{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]] - [[15 בספטמבר]] [[2013]]|הפרש}}
|-
| ללא תאריך יעד
| <nowiki>{{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]]|שנים}}</nowiki>
| {{#invoke:תאריך|חשב טווח|[[3 בפברואר]] [[1947]]|שנים}}
|-
| לא כולל היום האחרון
| <nowiki>{{#invoke:תאריך|חשב טווח|5 ביוני 1967 - 10 ביוני 1967}}</nowiki>
| {{#invoke:תאריך|חשב טווח|5 ביוני 1967 - 10 ביוני 1967}}
|-
| כולל היום האחרון
| <nowiki>{{#invoke:תאריך|חשב טווח|5 ביוני 1967 - 10 ביוני 1967|כולל=כן}}</nowiki>
| {{#invoke:תאריך|חשב טווח|5 ביוני 1967 - 10 ביוני 1967|כולל=כן}}
|-
| כולל היום האחרון
| <nowiki>{{#invoke:תאריך|חשב טווח|14 ספטמבר 2014 - 14 ספטמבר 2014|כולל=כן}}</nowiki>
| {{#invoke:תאריך|חשב טווח|14 ספטמבר 2014 - 14 ספטמבר 2014|כולל=כן}}
|-
| שנה ויום
| <nowiki>{{#invoke:תאריך|חשב טווח|14 ספטמבר 2014 - 15 ספטמבר 2015|כולל=כן}}</nowiki>
| {{#invoke:תאריך|חשב טווח|14 ספטמבר 2014 - 15 ספטמבר 2015|כולל=כן}}
|}
הערות:
*כאשר לא ניתן תאריך יעד תאריך היעד נקבע כזמן הנוכחי
* הפרש - מציין את הפרש הזמנים בשניות וללא מילים. ניתן להשתמש בערך המוחזר בחלוקה מתאימה לקבלת יחידות זמן אחרות.
*ניתן להוסיף פרמטר '''כולל=כן''', ואז נלקח בחשבון גם היום האחרון. כשמדובר על טווח זמן ארוך והפורמט נבחר אוטומטי או שמכיל שנים, מתקבלת תוצאה מקורבת.
*ניתן להוסיף פרמטר error והתוכן שלו יוצג במקרה של שגיאה בטווח התאריכים. (רצוי להכניס במקרה כזה את הדף לקטגוריה כלשהי שתאפשר מעקב אחרי דפים לא תקינים. ברירת המחדל היא [[:קטגוריה:דפים עם שגיאות בתאריך]])
*אם לא מצוין פורמט, הוא נבחר אוטומטית:
**עד ל-3 שבועות הוא מוצג בימים
**עד שנה הוא מוצג בימים ושבועות
**עד ל-10 שנים בשנים ושבועות
**מעבר לזה רק בשנים

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