תבנית:זמן
המידע מטה מוצג מתוך הדף תבנית:זמן/תיעוד.
תבנית זו מיועדת להציג זמן נתון, ובאה להקל ולחסוך את השימוש בהוראת התנאי "#זמןמ".
הפונקציה הזו מאפשרת גישה למערכת הזמן, בדרך כלל כדי לקבל את הזמן הנוכחי. היא עובדת בשעון הוויקי, ובמקרה של האתרים העבריים - בשעון ישראל.
תחביר
התבנית מקבלת את הנתונים הבאים:
{{תבנית להצגת הזמן|התאריך שיש לעבוד עליו|תוספת זמן יחסי|סוג תוספת|קוד שפה}}
כאשר שמות הפרמטרים הם:
{{פורמט|תאריך|הפרש|סוג הפרש|קוד שפה}}
ניתן גם להכניס את הפרמטרים כמספרים, או לפי סדר בלי השמות:
{{1|2|3|4|5}}
הפרמטר השני (תאריך) אינו חובה, ובו ניתן לציין תאריך ושעה שיש להשתמש בהם (לדוגמה, להציג את הזמן כפי שהיה לפני 24 שעות). ערך ברירת המחדל שלו הוא {{CURRENTTIMESTAMP}}, כלומר הזמן בו העמוד נטען בפעם האחרונה.
התאריך העברי מתחלף בחצות.
תוספת xh לפני כל קוד הופכת אותו למבוטא בספרות עבריות.
הפרמטר השני יכול להיות יחסי, למשל "- 5". במקרה כזה, יש צורך למלא בפרמטר הרביעי (סוג ההפרש) אם ההפרש הוא בימים, שנים וכו', האפשרויות: יום, חודש, שנה, שעה, דקה, שניה, שבוע.
כדי לשים בפורמט טקסט חופשי, ניתן להשתמש במרכאות. למשל, {{#זמןמ:year Y}} יחזיר 17Asia/JerusalempmMon, 14 Aug 2017 23:23:32 +0300 2017,
"year" Y יחזיר year 2017. כמו כן, xx יחזיר x.
הפרמטר החמישי הוא קוד השפה בה יש להציג את התוצאה, כשברירת המחדל היא he.
ראו גם עזרה:מילות מפתח#משתני זמן.
| פורמט | הסבר | ערך נוכחי |
|---|---|---|
| Y | שנה מלאה | 2017 |
| y | שנה קצרה | 17 |
| L | 1 אם שנה לועזית מעוברת, 0 אחרת | 0 |
| n | מספר חודש (1 עד 12) | 8 |
| m | מספר חודש (01 עד 12) | 08 |
| M | השם המקוצר של החודש | אוג' |
| M | השם האנגלי המקוצר של החודש (הפרמטר השני en) | Aug |
| F | השם המלא של החודש | אוגוסט |
| F | השם המלא של החודש (הפרמטר השני en) | August |
| xg | שם עברי של חודש כולל האות "ב" בהתחלה | באוגוסט |
| W | מספר סידורי של שבוע בשנה | 33 |
| j | יום בחודש (1 עד 31) | 14 |
| d | יום בחודש (01 עד 31) | 14 |
| z | מספר של יום בשנה, החל מ-0 | 225 |
| D | השם המקוצר של היום | ב' |
| D | השם המקוצר של היום (הפרמטר השני en) | Mon |
| l | השם המלא של היום | שני |
| l | השם המלא של היום (הפרמטר השני en) | Monday |
| w | מספר של יום בשבוע, החל מ-מיום ראשון (0 עד 6) | 1 |
| N | מספר של יום בשבוע, החל מיום שני (1 עד 7) | 1 |
| a | am או pm | pm |
| A | AM או PM | PM |
| g | שעה (1 עד 12) | 11 |
| h | שעה (01 עד 12) | 11 |
| G | שעה (0 עד 23) | 23 |
| H | שעה (00 עד 23) | 23 |
| i | דקה | 23 |
| s | שנייה | 32 |
| U | שניות שעברו מ-1 בינואר 1970 | 1502742212 |
| e | מזהה אזור זמן | Asia/Jerusalem |
| I | 1 אם יש שעון קיץ, 0 אחרת | 1 |
| O | הבדל משעון גריניץ' | +0300 |
| P | הבדל משעון גריניץ' כולל נקודתיים | +03:00 |
| T | קיצור אזור זמן | IDT |
| Z | הפרש אזור זמן בשניות | 10800 |
| t | מספר ימים בחודש נוכחי | 31 |
| c | זמן מפורמט במספרים באנגלית | 2017-08-14T23:23:32+03:00 |
| r | זמן מפורמט במילים באנגלית | Mon, 14 Aug 2017 23:23:32 +0300 |
| xjj | יום בחודש עברי | 22 |
| xhxjj | יום בחודש עברי באותיות עבריות | כ"ב |
| xjF | חודש עברי | אב |
| xjt | מספר ימים בחודש עברי | 30 |
| xjx | חודש עברי בסמיכות | באב |
| xjn | מספר חודש עברי | 11 |
| xjY | שנה עברית | 5777 |
| xhxjY | שנה עברית באותיות עבריות | ה'תשע"ז |
דוגמאות
כתיבת תאריך לועזי מקוצר: {{זמן|d-m-y}} תוצאה: 14-08-17
כתיבת תאריך לועזי מלא: {{זמן|d-M-Y}} תוצאה: 14-אוג'-2017
כתיבת תאריך לועזי מלא: {{זמן|d-M-Y||||en}} תוצאה: 14-Aug-2017
כתיבת תאריך לועזי ושעה: {{זמן|G:i:s - j/m/Y}} תוצאה: 23:23:32 - 14/08/2017
כתיבת תאריך לועזי ושעה בעוד 3 שעות: {{זמן|G:i:s - j/m/Y|הפרש=+3|סוג הפרש=שעה}} תוצאה: 2:23:32 - 15/08/2017
כתיבת תאריך עברי: {{זמן|xhxjj xjx xhxjY}} תוצאה: כ"ב באב ה'תשע"ז
המרת תאריך לועזי לתאריך עברי: {{זמן|xhxjj xjx xhxjY|31-08-1973}} תוצאה: ג' באלול ה'תשל"ג
הטווח המורשה לתאריכים הוא 1 בינואר 0111 עד 31 בדצמבר 9999. שנה 10 תקרא כ-2010.