יחידה:טווח זמנים/תיעוד
זהו דף התיעוד עבור יחידה:טווח זמנים
היחידה מיועדת לבנייה נוחה של תבניות עם טווחי זמנים.
טווח זמנים יהיה מהצורה של <תאריך התחלה> - <תאריך סיום> או <נקודת זמן>
הצגת משך זמן
[עריכת קוד מקור]כאשר עוסקים בפרט חשוב דיו לציון משך הזמן בין תאריך ההתחלה לסיום ניתן לציין "הצגת הפרשת זמנים=כן" שיחשב את משך הזמן מהתחלה לסיום או יסתמך על ויקינתונים לצורך זה. ניתן לציין בצורה מפורשת "משך" לציון ידני של משך הזמן.
דוגמאות שימוש
[עריכת קוד מקור]| פורמט | דוגמה | תוצאה | הערה |
|---|---|---|---|
| טווח פשוט | {{#invoke:טווח זמנים|טווח זמנים|תאריך התחלה=26 באוגוסט 2020|תאריך סיום=26 באוגוסט 2021}} | 26 באוגוסט 2020 – 26 באוגוסט 2021 | |
| אירוע פשוט | {{#invoke:טווח זמנים|טווח זמנים|נקודת זמן=26 באוגוסט 2020}} | 26 באוגוסט 2020 | |
| משך - פשוט יחד עם משך מפורש | {{#invoke:טווח זמנים|טווח זמנים|תאריך התחלה=26 באוגוסט 2020|תאריך סיום=26 באוגוסט 2021|הצגת הפרשת זמנים=כן|משך=שנה}} | 26 באוגוסט 2020 – 26 באוגוסט 2021 (שנה) | |
| הצגת הפרשת זמנים - פשוט יחד עם משך אוטומטי | {{#invoke:טווח זמנים|טווח זמנים|תאריך התחלה=26 באוגוסט 2020|תאריך סיום=26 באוגוסט 2021|הצגת הפרשת זמנים=כן}} | 26 באוגוסט 2020 – 26 באוגוסט 2021 (שנה) | |
| פשוט יחד עם משך אוטומטי (דוגמה נוספת) | {{#invoke:טווח זמנים|טווח זמנים|תאריך התחלה=10 בינואר 2005|תאריך סיום=23 בנובמבר 2005|הצגת הפרשת זמנים=כן}} | 10 בינואר 2005 – 23 בנובמבר 2005 (318 ימים) | |
| פורמט הצגה - כיצד להציג את משך הזמן | {{#invoke:טווח זמנים|טווח זמנים|תאריך התחלה=26 באוגוסט 2020|תאריך סיום=26 באוגוסט 2021|הצגת הפרשת זמנים=כן|פורמט הצגה=%s<br>%s}} | 26 באוגוסט 2020 – 26 באוגוסט 2021 (משך הזמן: שנה) |
|
| שימוש בוויקינתונים | {{#invoke:טווח זמנים|טווח זמנים}} | 1 בינואר 2011-2 בינואר 2012 | בהנחה שהוזנו הפרטים בוויקינתונים |
| תאריך התחלה-ויקינתונים, תאריך סיום-ויקינתונים - הגדרת המזהים אשר ימשכו מוויקינתונים | {{#invoke:טווח זמנים|טווח זמנים|תאריך התחלה-ויקינתונים=P2031|תאריך סיום-ויקינתונים=P2032}} | 1 בינואר 2011-2 בינואר 2012 | בהנחה שהוזנו הפרטים בוויקינתונים |
| qid - הגדרת הדף בויקינתונים ממנו נמשכים התאריכים | {{#invoke:טווח זמנים|טווח זמנים|qid=Q27020128}} | 1 בינואר 2011-2 בינואר 2012 | בהנחה שהוזנו הפרטים בוויקינתונים. ניתן להזין |qid=- על מנת למנוע משיכה מוויקינתונים
|
| הווה (ציון אירוע מתמשך) | {{#invoke:טווח זמנים|טווח זמנים|תאריך התחלה=21 בינואר 2020|תאריך סיום=מכהנת|הצגת הפרשת זמנים=כן|הווה=מולך,מולכת,מכהן,מכהנת,לא כיהן,נוכחי,נוכחית,הווה,ואילך}} | 21 בינואר 2020 – מכהנת (4 שנים) | הווה מאפשר לציין שהאירוע לא הסתיים והוא נמשך בהווה, ומאפשר להכניס ערכים שונים אשר היחידה תקרא כהווה |
| נמשך - הגדרת ברירת מחדל של תאריך סיום כהווה | {{#invoke:טווח זמנים|טווח זמנים|תאריך התחלה=26 ביולי 2020|נמשך=כן|הצגת הפרשת זמנים=כן}} | 26 ביולי 2020 – הווה (4 שנים) | באם יוזן תאריך סיום היחידה תתחשב בו |
| טקסט התחלה - טקסט להציג במקרה שבו ידוע רק תאריך התחלה ולא תאריך סיום. | {{#invoke:טווח זמנים|טווח זמנים|תאריך התחלה=26 ביולי 2020|טקסט התחלה= מ-%s}} | מ-26 ביולי 2020 | |
| טקסט סיום - הצגת תאריך הסיום במקרה בו לא יוזן תאריך התחלה (במקום ברירת המחדל של ?) | {{#invoke:טווח זמנים|טווח זמנים|תאריך סיום=26 ביולי 2020|טקסט סיום= נגמר ב-%s}} | נגמר ב-26 ביולי 2020 |