ויקיפדיה

עזרה:הוראות תנאי – הבדלי גרסאות

עיון אינטראקטיבי בהיסטוריה
→ העריכה הקודמתהעריכה הבאה ←
תוכן שנמחק תוכן שנוסף
חזותיקוד ויקי
מ ←‏פתיח: , תיקון קישור
באישור משתמש:ערן
שורה 1:
'''הוראות תנאי''' (או [[mw:Help:Extension:ParserFunctions|ParserFunctions]]) הן הוראות שמאפשרות ליצור [[עזרה:תבניות|תבניות]] מתוחכמות המבצעות פעולות מתמטיות ולוגיות שונות הכוללות את הפונקציות "[[#חשב|חשב]]", "[[#תנאי|תנאי]]", "[[#שווה|שווה]]", "[[#חשבבדיקת תנאי|שגיאה]]", "[[#חשב תנאי]]", "[[#בחר|בחר]]", "[[#קיים|קיים]]", "[[#זמןמ|זמןמ]]", "[[#זמן|זמן]]" ומספר"[[#rel2abs|כתובת פעולותהדף]]" נוספותו"[[#titleparts|חלוקת שלא נכללות בהסבר זההכתובת]]". ניתן לעשות שימוש גם בשמן הלועזי של הפונקציות, אם כי ויקיפדיה העברית דוגלת בשמות העבריים.
 
תחביר הפונקציות הוא '''<nowiki>{{</nowiki>#שם הפונקציה:פרמטרים המופרדים בסימן<nowiki>|</nowiki> {{!}}ביניהם}}'''.
{{הגבלת תוכן עניינים|רמה=3}}
 
== הפונקציות ==
=== חשב ===
הפונקציה הזו מאפשרת לחשב ביטויים מתמטיים ולוגיים. הפונקציה מוציאה הודעת שגיאה בחלוקות ב־0 וכדומה. בביטויים הלוגיים '''0''' הוא ערך שקר, כל ביטוי לא ריק אחר (כשברירת המחדל היא '''1''') הוא ערך אמת.
 
* '''שם עברי:''' #חשב
* '''שם אנגלי:''' ‎#expr
* '''תחביר:''' <nowiki>{{</nowiki>ל}}#חשב:החישוב}}
 
אופרטורים זמינים:
שורה 22 ⟵ 23:
!
| הצגת המספרים
| <nowiki>{{ל}}#חשב:25}}</nowiki><br /><nowiki>{{ש}}{{ל}}#חשב:123456789012345}}</nowiki><br /><nowiki>{{ש}}{{ל}}#חשב:0.000001}}</nowiki>
| {{#חשב:25}}<br />{{ש}}{{#חשב:123456789012345}}<br />{{ש}}{{#חשב:0.000001}}
|-
! ( )
| קיבוץ פעולות
| <nowiki>{{ל}}#חשב:{{משמאל לימין|(30 + 7) * 7}}</nowiki>}}
| {{#חשב:(30 + 7) * 7}}
|-
! +
| מספר חיובי
| <nowiki>{{ל}}#חשב:{{משמאל לימין|+30 * +7}}</nowiki>}}
| {{#חשב:+30 * +7}}
|-
! -
| מספר שלילי
| <nowiki>{{ל}}#חשב:{{משמאל לימין|-30 * -7}}</nowiki>}}
| {{#חשב:-30 * -7}}
|-
! not
| אופרטור "NOT" לוגי
| <nowiki>{{#חשב:not 0 * 7}}</nowiki><br /><nowiki>{{#חשב:not 30 + 7}}</nowiki>
| {{#חשב:not 0 * 7}}<br />{{#חשב:not 30+7}}
|-
! *
| כפל
| <nowiki>{{ל}}#חשב:{{משמאל לימין|30 * 7}}</nowiki>}}
| {{#חשב:30 * 7}}
|-
! /
| חילוק, זהה ל־'''div'''
| <nowiki>{{ל}}#חשב:{{משמאל לימין|30 / 7}}</nowiki>}}
| {{#חשב:30 / 7}}
|-
! div
| חילוק, זהה ל־'''/'''<br />(ללא חלוקת מספרים שלמים)
| {{ל}}#חשב:{{משמאל לימין|30 div 7}}}}
| <nowiki>{{#חשב:30 div 7}}</nowiki><br /><nowiki>{{#חשב:5 div 2 * 2 + 5 mod 2}}</nowiki>
| {{#חשב:30 div 7}}<br />{{#חשב:5 div 2 * 2 + 5 mod 2}}
|-
! mod
| "מודולוס", השארית של החלוקה לאחר הפיכת שני המספרים למספרים שלמים.<br />{{ש}}אזהרה: '''div''' ו־'''mod''' שונים מכלמרוב שפות התכנות.
| <nowiki>{{ל}}#חשב:{{משמאל לימין|30 mod 7}}</nowiki><br /><nowiki>}}{{ש}}{{ל}}#חשב:{{משמאל לימין|-8 mod -3}}</nowiki><br /><nowiki>}}{{ש}}{{ל}}#חשב:{{משמאל לימין|-8 mod +3}}</nowiki><br /><nowiki>}}{{ש}}{{ל}}#חשב:{{משמאל לימין|8 mod 2.7}}</nowiki><br /><nowiki>}}{{ש}}{{ל}}#חשב:{{משמאל לימין|8 mod 3.2}}</nowiki><br /><nowiki>}}{{ש}}{{ל}}#חשב:{{משמאל לימין|8.9 mod 3}}</nowiki>}}{{ש}}{{ל}}#חשב:{{משמאל לימין|5 div 2 * 2 + 5 mod 2}}}}
| {{#חשב:30 mod 7}}<br{{ש}}{{משמאל />לימין|{{#חשב:-8 mod -3}}<br}}{{ש}}{{משמאל />לימין|{{#חשב:-8 mod +3}}<br />}}{{ש}}{{#חשב:8 mod 2.7}}<br />{{ש}}{{#חשב:8 mod 3.2}}<br />{{ש}}{{#חשב:8.9 mod 3}}{{ש}}{{#חשב:5 div 2 * 2 + 5 mod 2}}
|-
! +
| חיבור
| <nowiki>{{ל}}#חשב:{{משמאל לימין|30 + 7}}</nowiki>}}
| {{#חשב:30 + 7}}
|-
! -
| חיסור
| <nowiki>{{ל}}#חשב:{{משמאל לימין|30 - 7}}</nowiki>}}
| {{#חשב:30 - 7}}
|-
! ^
| חזקה
| {{ל}}#חשב:{{משמאל לימין|2 ^ 5}}}}
| {{#חשב:2 ^ 5}}
|-
! round
| מעגל את המספר הראשון למספר השני של הספרות אחרי הנקודה.{{ש}}אם יש חלק דצימלי במספר השני, הוא לא יילקח בחשבון.
| <nowiki>{{ל}}#חשב:{{משמאל לימין|30 / 7 round 3}}</nowiki><br /><nowiki>}}{{ש}}{{ל}}#חשב:{{משמאל לימין|30 / 7 round 0}}</nowiki><br /><nowiki>}}{{ש}}{{ל}}#חשב:{{משמאל לימין|3456 round -2}}</nowiki>}}
| {{#חשב:30 / 7 round 3}}<br />{{ש}}{{#חשב:30 / 7 round 0}}<br />{{ש}}{{#חשב:3456 round -2}}
|-
! ceil
| מעגל את המספר כלפי מעלה
| {{ל}}#חשב:{{משמאל לימין|ceil 3.5}}}}{{ש}}{{ל}}#חשב:{{משמאל לימין|ceil -3.5}}}}
| {{#חשב:ceil 3.5}}{{ש}}{{משמאל לימין|{{#חשב:ceil -3.5}}}}
|-
! floor
| מעגל את המספר כלפי מטה
| {{ל}}#חשב:{{משמאל לימין|floor 3.5}}}}{{ש}}{{ל}}#חשב:{{משמאל לימין|floor -3.5}}}}
| {{#חשב:floor 3.5}}{{ש}}{{משמאל לימין|{{#חשב:floor -3.5}}}}
|-
! trunc
| מוחק את החלק הדצימלי של המספר
| {{ל}}#חשב:{{משמאל לימין|trunc 3.5}}}}{{ש}}{{ל}}#חשב:{{משמאל לימין|trunc -3.5}}}}
| {{#חשב:trunc 3.5}}{{ש}}{{משמאל לימין|{{#חשב:trunc -3.5}}}}
|-
! =
| שוויון (מספרי ולוגי)
| <nowiki>{{ל}}#חשב:<nowiki>{{משמאל לימין|30 {{=}} 7</nowiki>}}</nowiki>}}
| {{#חשב:30 = 7}}
|-
! <>
| אי־שוויון, זהה ל־'''{{משמאל לימין|!{{=}}}}'''
| <nowiki>{{ל}}#חשב:{{משמאל לימין|30 <> 7}}</nowiki>}}
| {{#חשב:30 <> 7}}
|-
! {{משמאל לימין|!{{=}}}}
! !=
| אי־שוויון, זהה ל־'''<>''', "XOR" לוגי
| <nowiki>{{ל}}#חשב:<nowiki>{{משמאל לימין|1 !{{=}} 0</nowiki>}}</nowiki>}}
| {{#חשב:1 != 0}}
|-
! {{משמאל לימין|<}}
! <
| קטן מ־
| <nowiki>{{ל}}#חשב:{{משמאל לימין|30 < 7}}</nowiki>}}
| {{#חשב:30 < 7}}
|-
! {{משמאל לימין|>}}
! >
| גדול מ־
| <nowiki>{{ל}}#חשב:{{משמאל לימין|30 > 7}}</nowiki>}}
| {{#חשב:30 > 7}}
|-
! {{משמאל לימין|<{{=}}}}
! <=
| קטן מ־ או שווה ל־
| <nowiki>{{ל}}#חשב:{{משמאל לימין|30 <{{=}} 7}}</nowiki>}}
| {{#חשב:30 <= 7}}
|-
! {{משמאל לימין|>{{=}}}}
! >=
| גדול מ־ או שווה ל־
| <nowiki>{{ל}}#חשב:{{משמאל לימין|30 >{{=}} 7}}</nowiki>}}
| {{#חשב:30 >= 7}}
|-
! not
| אופרטור "NOT" לוגי
| {{ל}}#חשב:{{משמאל לימין|not 0 * 7}}}}{{ש}}{{ל}}#חשב:{{משמאל לימין|not 30 + 7}}}}
| {{#חשב:not 0 * 7}}{{ש}}{{#חשב:not 30+7}}
|-
! and
| "AND" לוגי
| <nowiki>{{ל}}#חשב:{{משמאל לימין|4 < 5 and 4 mod 2}}</nowiki>}}
| {{#חשב:4 < 5 and 4 mod 2}}
|-
! or
| "OR" לוגי
| <nowiki>{{ל}}#חשב:{{משמאל לימין|4 < 5 or 4 mod 2}}</nowiki>}}
| {{#חשב:4 < 5 or 4 mod 2}}
|-
! e
| e
| {{ל}}#חשב:e}}
| {{#חשב:e}}
|-
! pi
| pi
| {{ל}}#חשב:pi}}
| {{#חשב:pi}}
|}
 
כמו כן, ניתן להשתמש בפונקציות אונאריות '''abs''' ,'''exp''' ,'''ln''' ,'''sin''' ,'''cos''' ,'''tan''' ,'''acos''' ,'''asin''' ,'''atan'''.
 
=== תנאי ===
הפונקציה הזו מאפשרת בחירה בין שתי אפשרויות: אם ביטוי שהועבר להכולל קייםלא רק שטח ריק (כלומר רווחים, לא ריקשורות ולאריקות 0וכדומה), היא מחזירה משהו אחד; אם לא, היא מחזירה משהו אחר.
 
* '''שם עברי:''' #תנאי
* '''שם אנגלי:''' ‎#if
* '''תחביר:''' <nowiki>{{</nowiki>ל}}#תנאי:הביטוי לבדיקה|מה לכתוב אם הביטוי קיים|מה לכתוב אם הביטוי אינו קיים}}
 
הפונקציה נמצאת בשימוש בעיקר בתבניות, כדי לבדוק האם הועבר להן פרמטר מסוים, אך ייתכנו שימושים נוספים רבים.
 
הפונקציה אינה מחשבת את הביטוי שהועבר לה; לשם כך קיימת הפונקציה "[[#חשב תנאי]]".
 
אם רוצים רק לבדוק האם הועבר לתבנית פרמטר מסוים, אם כן להדפיסו, ואם לא להדפיס ערך אחר, עדיף להשתמש בצורת הכתיבה: {{ל}}{שם הפרמטר|ערך ברירת המחדל}}}, ולא בצורה הארוכה יותר {{ל}}#תנאי:{{ל}}{שם הפרמטר|}}}|{{{שם הפרמטר}}}|ערך ברירת המחדל}}. לעומת זאת, אם רוצים להדפיס בנוסף לפרמטר גם משהו אחר אם הוא קיים, יש להשתמש ב"תנאי".
 
ניתן לקנן ביטויי תנאי, בדרך כלל עד שבע רמות.
אם רוצים רק לבדוק האם הועבר לתבנית פרמטר מסוים, אם כן להדפיסו, ואם לא להדפיס ערך אחר, עדיף להשתמש בצורת הכתיבה: <nowiki>{{{שם הפרמטר|ערך ברירת המחדל}}}</nowiki>, ולא בצורה הארוכה יותר <nowiki>{{#תנאי:{{{שם הפרמטר|}}}|{{{שם הפרמטר}}}|ערך ברירת המחדל}}</nowiki>. לעומת זאת, אם רוצים להדפיס בנוסף לפרמטר גם משהו אחר אם הוא קיים, יש להשתמש ב"תנאי".
 
====דוגמאות====
 
'''כתיבה:''' <nowiki>{{ל}}#תנאי: |אמת|שקר}}</nowiki> -->>{{חץ}} '''תוצאה:''' {{#תנאי: |אמת|שקר}}
 
'''כתיבה:''' <nowiki>{{ל}}#תנאי:1=9|אמת|שקר}}</nowiki> -->>{{חץ}} '''תוצאה:''' {{#תנאי:1=9|אמת|שקר}}
 
=== שווה ===
הפונקציה הזו היא כמו "[[#תנאי]]", אך היא בוררת בין האפשרויות על בסיס השוואה בין שני ביטויים שהועברו לה. במידה ושני הביטויים אריתמטיים, גם ההשוואה היא כזאת, כלומר 1=01. כדי לפרש מספרים כמחרוזות, יש להשתמש בגרשיים כפולים: "01".
 
* '''שם עברי:''' #שווה
* '''שם אנגלי:''' ‎#ifeq
* '''תחביר:''' <nowiki>{{</nowiki>ל}}#שווה:הביטוי הראשון להשוואה|הביטוי השני להשוואה|מה לכתוב אם הביטויים שווים|מה לכתוב אם הביטויים אינם שווים}}
 
====דוגמאות====
 
'''כתיבה:''' <nowiki>{{ל}}#שווה: A|A|שתי האותיות שוות|שתי האותיות שונות}}</nowiki>
 
'''תוצאה:''' {{#שווה: A|A|שתי האותיות שוות|שתי האותיות שונות}}
 
'''כתיבה:''' <nowiki>{{ל}}#שווה: a|A|שתי האותיות שוות|שתי האותיות שונות}}</nowiki>
 
'''תוצאה:''' {{#שווה: a|A|שתי האותיות שוות|שתי האותיות שונות}}
 
=== בדיקת שגיאה ===
הפונקציה בודקת האם הביטוי שהתקבל הינו שגיאה. במידה וכן, מוחזר הפרמטר הראשון (או ריק כברירת מחדל), אחרת הפרמטר השני (או הביטוי עצמו כברירת מחדל).
 
* '''שם אנגלי:''' ‎#iferror
* '''תחביר:''' {{ל}}{{משמאל לימין|#iferror}}:הביטוי הנבדק|מה לכתוב אם יש שגיאה|מה לכתוב אם אין שגיאה}}
 
====דוגמאות====
 
'''כתיבה:''' {{ל}}{{משמאל לימין|#iferror}}:{{ל}}#חשב:3+X}}|טעות|נכון}}
 
'''תוצאה:''' {{#iferror:{{#חשב:3+X}}|טעות|נכון}}
 
'''כתיבה:''' {{ל}}{{משמאל לימין|#iferror}}:{{ל}}#חשב:3+5}}|טעות|נכון}}
 
'''תוצאה:''' {{#iferror:{{#חשב:3+5}}|טעות|נכון}}
 
'''כתיבה:''' {{ל}}{{משמאל לימין|#iferror}}:{{ל}}#חשב:3+5}}|טעות}}
 
'''תוצאה:''' {{#iferror:{{#חשב:3+5}}|טעות}}
 
=== חשב תנאי ===
הפונקציה הזו היא כמו "[[#תנאי]]", אך בוררת בין האפשרויות על בסיס בדיקה האם החישוב שהועבר לה (הנכתב בתחביר זהה לזה של הפונקציה "[[#חשב]]") קיים (כלומר לא 0), או לא.
 
* '''שם עברי:''' #חשב תנאי
* '''שם אנגלי:''' ‎#ifexpr
* '''תחביר:''' <nowiki>{{</nowiki>ל}}#חשב תנאי:החישוב|מה לכתוב אם תוצאת החישוב שונה מ-0|מה לכתוב אם תוצאת החישוב 0}}
 
====דוגמה====
 
בחישוב תנאי בדוגמה נעשה נעשה שימוש בפקודה <nowiki>{{ל}}#זמןמ:w}}</nowiki> שמחזירה את היום בשבוע, בין 0 ל־6.
 
'''כתיבה:''' <nowiki>{{ל}}#חשב תנאי:{{ל}}#זמןמ:w{{כ}}+1{{=}}6}}}}|היום יום ששי, זה הזמן לעשות סידורים.| היום יום עבודה רגיל או יום שבת.}}</nowiki>
 
'''תוצאה:''' {{#חשב תנאי:{{#זמןמ:w}}+1=6|היום יום ששי, זה הזמן לעשות סידורים.| היום יום עבודה רגיל או יום שבת.}}
שורה 184 ⟵ 239:
 
הפונקציה נכתבת באופן הבא:
<nowiki>{{</nowiki>ל}}#בחר:הביטוי לבדיקה|<br />{{ש}}
ערך לדוגמה=מה לכתוב אם זהו ערך הביטוי|<br />{{ש}}
ערך לדוגמה=מה לכתוב אם זהו ערך הביטוי|<br />{{ש}}
ערך לדוגמה=מה לכתוב אם זהו ערך הביטוי|<br />{{ש}}
<nowiki>{{כ}}#</nowiki>ברירת מחדל=מה לכתוב אם ערך הביטוי אינו אחד הערכים שנכתבו לעיל}}
 
אם הביטוי לבדיקה והערך שיש להשוותו שניהם מספרים, ההשוואה היא מספרית, כלומר 01 שווה ל-1.
 
ערך לדוגמה יכול להיות ריק ("|="), והוא נקרא כמחרוזת ריקה.
 
במידה וכמה ערכים מתאימים, רק הראשון תופס.
 
ניתן להשמיט את סימן ה-= ואת התוצאה לאחריו, אז יוחזר הביטוי הבא (ראו דוגמאות בסוף). כך ניתן לקבץ אפשרויות.
 
השם האנגלי של "#ברירת מחדל" הוא ‎#default, וגם בו ניתן להשתמש. ניתן גם להשמיטו, ואז לא נכתב כלום אם הביטוי הוא לא אחד מהערכים הנ"ל.
 
ניתן למקם את ברירת המחדל בכל מקום בביטוי, לא רק בסוף.
ניתן לרשום ברירת מחדל ללא #default=/#ברירת מחדל= כאשר מוסיפים קו חוצץ, כך:
 
ניתן לרשום ברירת מחדל ללא {{משמאל לימין|#default}}=/#ברירת מחדל= כאשר מוסיפים קו חוצץ, כך:
<nowiki>{{</nowiki>#בחר:הביטוי לבדיקה|<br />
 
ערך לדוגמה=מה לכתוב אם זהו ערך הביטוי|<br />
{{ל}}#בחר:הביטוי לבדיקה|{{ש}}
ערך לדוגמה=מה לכתוב אם זהו ערך הביטוי|{{ש}}
ערך לדוגמה=מה לכתוב אם זהו ערך הביטוי|מה לכתוב אם ערך הביטוי אינו אחד הערכים שנכתבו לעיל}}
 
כל שימוש בסימן "=" בפעולה הזאת שלא כחלק מהתחביר הנ"ל חייב להיות מוחלף ב{{תב|{{=}}}}.
 
ניתן כמובן להשתמש בכמה ערכים אפשריים של הביטוי שרוצים – ניתן להשתמש בערך אחד, ולעומת זאת ניתן להשתמש במאה ערכים. (השימוש בערך אחד בלבד אינו מומלץ, שכן לשם כך בדיוק קיימת הפונקציה "[[#שווה]]".)
 
אחד השימושים בתבנית הוא כדי לבדוק את ערכו של פרמטר מסוים שהועבר לתבנית ולהחזיר ערך על בסיסו, ואפשר גם להשתמש בתבנית כדי לקבל ערך שונה כ[[עזרה:מילות מפתח|שמשתנה מערכת]] משתנה, למשל כשהיום משתנה, או החודש משתנה.
 
ההוראה מקבילה ל [[#שווה]] בתוך #שווהמקונן ועדיפה על פניה בגלל אורכה הקצר.
====דוגמה====
'''כתיבה:''' <nowiki>{{#בחר:{{#זמןמ:xjn}}|1=תשרי|2=חשון|3=כסלו|4=טבת|5=שבט|6=אדר|7=ניסן|8=אייר|9=סיוון|10=תמוז|11=אב|12=אלול}}</nowiki>
 
====דוגמאות====
'''תוצאה:''' {{#בחר:{{#זמןמ:xjn}}|1=תשרי|2=חשון|3=כסלו|4=טבת|5=שבט|6=אדר|7=ניסן|8=אייר|9=סיוון|10=תמוז|11=אב|12=אלול}}
'''כתיבה:''' {{ל}}#בחר:{{#זמןמ:xjn}}|1=תשרי|2=חשון|3=כסלו|4=טבת|5=שבט|6=אדר|7=ניסן|8=אייר|9=סיוון|10=תמוז|11=אב|12=אלול|4=אפריל}}
 
'''תוצאה:''' {{#בחר:{{#זמןמ:xjn}}|1=תשרי|2=חשון|3=כסלו|4=טבת|5=שבט|6=אדר|7=ניסן|8=אייר|9=סיוון|10=תמוז|11=אב|12=אלול|4=אפריל}}
 
'''כתיבה:''' {{ל}}#בחר:{{#זמןמ:xjn}}|1=תשרי|2=חשון|3=כסלו|4|5|6=אדר|7=ניסן|8=אייר|9=סיוון|10=תמוז|11=אב|12=אלול}}
 
'''תוצאה:''' {{#בחר:{{#זמןמ:xjn}}|1=תשרי|2=חשון|3=כסלו|4|5|6=אדר|7=ניסן|8=אייר|9=סיוון|10=תמוז|11=אב|12=אלול}}
 
=== קיים ===
הפונקציה הזו היא כמו "[[#תנאי]]", אך בוררת בין האפשרויות על בסיס בדיקה האם שם הדף שהועבר לה קיים, או לא.
 
* '''שם עברי:''' #קיים
* '''שם אנגלי:''' ‎#ifexist
* '''תחביר:''' <nowiki>{{</nowiki>ל}}#קיים:שם הדף|מה לכתוב אם הדף קיים|מה לכתוב אם הדף אינו קיים}}
 
את שם הדף לבדיקה יש לכתוב '''ללא''' סוגריים מרובעות.
 
ניתן להשתמש בתבנית, למשל, כדי להציג קישור לערך רק אם הוא קיים.
 
הדף קיים אם היה אפשר לכתוב אותו באמצעות קישור פנימי שהיה הופך לכחול. גם דפים שלא קיימים פיזית אך ניתנים לגישה, כמו הרחבות מדיה-וויקי נחשבות לקיימות.
 
לבדיקת קיום תמונה יש להשתמש במרחב השם "media". מרחבי השם "קובץ" או "תמונה" יבדקו את קיומו של התאור המקורי בלבד.
 
יש להכניס מספר קטן ככל האפשר של פעולות "קיים" לדף אחד. אחרת, הן מפסיקות לפעול והדף מקוטלג אוטומטית ל[[:קטגוריה:דפים עם יותר מדי קריאות למשתנים הגוזלים משאבים]].
 
====דוגמה====
'''כתיבה:''' <nowiki>{{ל}}#קיים:אריה|הערך [[אריה]] קיים. כדאי לבדוק אם הוא טעון הרחבה.|הערך [[אריה]] לא קיים. יש לך הזדמנות לפתוח אותו.}}</nowiki>
 
'''תוצאה:''' {{#קיים:אריה|הערך [[אריה]] קיים. כדאי לבדוק אם הוא טעון הרחבה.|הערך [[אריה]] לא קיים. יש לך הזדמנות לפתוח אותו.}}
שורה 230 ⟵ 307:
* '''שם עברי:''' #זמןמ
* '''שם אנגלי:''' ‎#timel
* '''תחביר:''' <nowiki>{{</nowiki>ל}}#זמןמ:תבנית להצגת הזמן|התאריך שיש לעבוד עליו|קוד שפה}}
 
התבניות הזמינות מפורטות [http://www.php.net/manual/en/function.date.php כאן], וניתן להשתמש גם בתבנית xg, שנותנת את צורת הקניין של החודש ("בינואר"), וכן xx לתו X רגיל. הפרמטר השני אינו חובה, ובו ניתן לציין תאריך ושעה שיש להשתמש בהם (לדוגמה, להציג את הזמן כפי שהיה לפני 24 שעות). ערך ברירת המחדל שלו הוא {{ל}}CURRENTTIMESTAMP}}:{{כ}} {{CURRENTTIMESTAMP}}, כלומר, הזמן בו העמוד נטען בפעם האחרונה.
 
התאריך העברי מתחלף בחצות.
====דוגמאות:====
 
תוספת xh לפני כל קוד הופכת אותו למבוטא בספרות עבריות.
'''כתיבת תאריך לועזי מקוצר:''' <nowiki>{{#זמןמ:d-m-y}}</nowiki> '''תוצאה:''' {{#זמןמ:d-m-y}}
 
הפרמטר השני יכול להיות יחסי, למשל "{{משמאל לימין|- 5 days}}".
'''כתיבת תאריך לועזי ושעה:''' <nowiki>{{#זמןמ:G:i:s - j/m/Y}}</nowiki> '''תוצאה:''' {{#זמןמ:G:i:s - j/m/Y}}
 
הפרמטר השלישי הוא קוד השפה בה יש להציג את התוצאה, כשברירת המחדל היא he.
'''כתיבת תאריך לועזי מלא:''' <nowiki>{{#זמןמ:r}}</nowiki> '''תוצאה:''' {{#זמןמ:r}}
 
{| class="wikitable sortable"
'''כתיבת יום בשבוע:''' <nowiki>{{#זמןמ:l}}</nowiki> '''תוצאה:''' {{#זמןמ:l}}
|-
! פורמט !! הסבר !! ערך נוכחי
|-
| Y|| שנה מלאה|| {{#זמןמ:Y}}
|-
| y|| שנה קצרה|| {{#זמןמ:y}}
|-
| L||{{כ}} 1 אם שנה לועזית מעוברת, 0 אחרת|| {{#זמןמ:L}}
|-
| n|| מספר חודש (1 עד 12)|| {{#זמןמ:n}}
|-
| m|| מספר חודש (01 עד 12)|| {{#זמןמ:m}}
|-
| M|| השם המקוצר של החודש || {{#זמןמ:M}}
|-
| M|| השם האנגלי המקוצר של החודש (הפרמטר השני en) || {{#זמןמ:M||en}}
|-
| F|| השם המלא של החודש|| {{#זמןמ:F}}
|-
| F|| השם המלא של החודש (הפרמטר השני en)|| {{#זמןמ:F||en}}
|-
| xg|| שם עברי של חודש כולל האות "ב" בהתחלה|| {{#זמןמ:xg}}
|-
| W|| מספר סידורי של שבוע בשנה|| {{#זמןמ:W}}
|-
| j|| יום בחודש (1 עד 31)|| {{#זמןמ:j}}
|-
| d|| יום בחודש (01 עד 31)|| {{#זמןמ:d}}
|-
| z|| מספר של יום בשנה, החל מ-0|| {{#זמןמ:z}}
|-
| D|| השם המקוצר של היום|| {{#זמןמ:D}}
|-
| D|| השם המקוצר של היום (הפרמטר השני en)|| {{#זמןמ:D||en}}
|-
| l|| השם המלא של היום|| {{#זמןמ:l}}
|-
| l|| השם המלא של היום (הפרמטר השני en)|| {{#זמןמ:l||en}}
|-
| w|| מספר של יום בשבוע, החל מ-0|| {{#זמןמ:w}}
|-
| a||{{כ}} am או pm|| {{#זמןמ:a}}
|-
| A||{{כ}} AM או PM|| {{#זמןמ:A}}
|-
| g|| שעה (1 עד 12)|| {{#זמןמ:g}}
|-
| h|| שעה (01 עד 12)|| {{#זמןמ:h}}
|-
| G|| שעה (0 עד 23)|| {{#זמןמ:G}}
|-
| H|| שעה (00 עד 23)|| {{#זמןמ:H}}
|-
| i|| דקה|| {{#זמןמ:i}}
|-
| s|| שנייה|| {{#זמןמ:s}}
|-
| U|| שניות שעברו מ-1 בינואר 1970|| {{#זמןמ:U}}
|-
| e|| מזהה אזור זמן|| {{#זמןמ:e}}
|-
| I||{{כ}} 1 אם יש שעון קיץ, 0 אחרת|| {{#זמןמ:I}}
|-
| O|| הבדל משעון גריניץ'|| {{#זמןמ:O}}
|-
| P|| הבדל משעון גריניץ' כולל נקודתיים|| {{#זמןמ:P}}
|-
| T|| קיצור אזור זמן|| {{#זמןמ:T}}
|-
|Z||הפרש אזור זמן בשניות||{{#זמןמ:Z}}
|-
|t||מספר ימים בחודש נוכחי||{{#זמןמ:t}}
|-
|c||זמן מפורמט במספרים באנגלית||{{#זמןמ:c}}
|-
|r||זמן מפורמט במילים באנגלית||{{#זמןמ:r}}
|-
|xjj||יום בחודש עברי||{{#זמןמ:xjj}}
|-
|xhxjj||יום בחודש עברי באותיות עבריות||{{#זמןמ:xhxjj}}
|-
|xjF||חודש עברי||{{#זמןמ:xjF}}
|-
|xjt||מספר ימים בחודש עברי||{{#זמןמ:xjt}}
|-
|xjx||חודש עברי בסמיכות||{{#זמןמ:xjx}}
|-
|xjn||מספר חודש עברי||{{#זמןמ:xjn}}
|-
|xjY||שנה עברית||{{#זמןמ:xjY}}
|-
|xhxjY||שנה עברית באותיות עבריות||{{#זמןמ:xhxjY}}
|}
 
====דוגמאות====
'''כתיבת תאריך עברי (מתחלף בחצות):''' <nowiki>{{#זמןמ:xhxjj xjx xhxjY}}</nowiki> '''תוצאה:''' {{#זמןמ:xhxjj xjx xhxjY}}
 
'''המרתכתיבת תאריך לועזי לתאריך עברימקוצר:''' <nowiki>{{ל}}#זמןמ:xhxjj xjx xhxjY|31d-08m-1973y}}</nowiki> '''תוצאה:''' {{#זמןמ:xhxjj xjx xhxjY|31d-08m-1973y}}
 
'''כתיבת תאריך לועזי מלא:''' {{ל}}#זמןמ:d-M-Y}} '''תוצאה:''' {{#זמןמ:d-M-Y}}
 
'''כתיבת תאריך לועזי מלא:''' {{ל}}#זמןמ:d-M-Y|{{כ}}|en}} '''תוצאה:''' {{#זמןמ:d-M-Y||en}}
 
'''כתיבת תאריך לועזי ושעה:''' {{ל}}#זמןמ:G:i:s -{{כ}} j/m/Y}} '''תוצאה:''' {{#זמןמ:G:i:s - j/m/Y}}
 
'''כתיבת תאריך לועזי ושעה בעוד 3 שעות:''' {{ל}}#זמןמ:G:i:s -{{כ}} j/m/Y}} '''תוצאה:''' {{#זמןמ:G:i:s - j/m/Y|+ 3 hours}}
 
'''כתיבת תאריך עברי:''' {{ל}}#זמןמ:xhxjj xjx xhxjY}} '''תוצאה:''' {{#זמןמ:xhxjj xjx xhxjY}}
 
'''המרת תאריך לועזי לתאריך עברי:''' {{ל}}#זמןמ:xhxjj xjx xhxjY|{{כ}}31-08-1973}} '''תוצאה:''' {{#זמןמ:xhxjj xjx xhxjY|31-08-1973}}
 
=== זמן ===
שורה 253 ⟵ 435:
* '''שם עברי:''' #זמן
* '''שם אנגלי:''' ‎#time
* '''תחביר:''' <nowiki>{{</nowiki>ל}}#זמן:תבנית להצגת הזמן|התאריך שיש לעבוד עליו|קוד השפה}}
 
ברוב המקרים מומלץ להשתמש בפונקציה זמןמ.
 
===כתובת הדף===
הפונקציה הזאת הופכת כתובת יחסית של דף לכתובת שלמה. אם אין פרמטר המציין את הדף, ברירת המחדל היא הדף הנוכחי.
 
* '''שם אנגלי:''' ‎#rel2abs
* '''תחביר:''' {{ל}}{{משמאל לימין|#rel2abs}}:כתובת הדף}}
 
====דוגמה====
'''כתיבה:''' {{ל}}{{משמאל לימין|#rel2abs}}:.}}
 
'''תוצאה:''' {{#rel2abs:.}}
 
===חלוקת הכתובת===
הפונקציה הזאת מחזירה חלק מכתובת הדף שניתנה כפרמטר.
 
* '''שם אנגלי:''' ‎#titleparts
* '''תחביר:''' {{ל}}{{משמאל לימין|#titleparts}}:כתובת הדף|כמה חלקים להחזיר|מספר סידורי של החלק הראשון}}
 
שני הפרמטרים הם אופציונליים.
 
====דוגמאות====
 
{{ל}}{{משמאל לימין|#titleparts}}{{כ}}:Talk:דף1/דף3/דף5/דף9}} {{חץ}} {{#titleparts: Talk:דף1/דף3/דף5/דף9}}
 
{{ל}}{{משמאל לימין|#titleparts}}{{כ}}: Talk:דף1/דף3/דף5/דף9{{כ}} | 1}} {{חץ}} {{#titleparts: Talk:דף1/דף3/דף5/דף9 | 1}}
 
{{ל}}{{משמאל לימין|#titleparts}}{{כ}}: Talk:דף1/דף3/דף5/דף9{{כ}} | 2}} {{חץ}} {{#titleparts: Talk:דף1/דף3/דף5/דף9 | 2}}
 
{{ל}}{{משמאל לימין|#titleparts}}{{כ}}: Talk:דף1/דף3/דף5/דף9{{כ}} | 2 | 2}} {{חץ}} {{#titleparts: Talk:דף1/דף3/דף5/דף9 | 2 | 2}}
 
{{ל}}{{משמאל לימין|#titleparts}}{{כ}}: Talk:דף1/דף3/דף5/דף9{{כ}} | | 2}} {{חץ}} {{#titleparts: Talk:דף1/דף3/דף5/דף9 | | 2}}
 
{{ל}}{{משמאל לימין|#titleparts}}{{כ}}: Talk:דף1/דף3/דף5/דף9{{כ}} | {{משמאל לימין|-1}}}} {{חץ}} {{#titleparts: Talk:דף1/דף3/דף5/דף9 | -1}}
 
{{ל}}{{משמאל לימין|#titleparts}}{{כ}}: Talk:דף1/דף3/דף5/דף9{{כ}} | {{משמאל לימין|-3}}}} {{חץ}} {{#titleparts: Talk:דף1/דף3/דף5/דף9 | -3}}
 
{{ל}}{{משמאל לימין|#titleparts}}{{כ}}: Talk:דף1/דף3/דף5/דף9{{כ}} | {{משמאל לימין|-4}}}} {{חץ}} {{#titleparts: Talk:דף1/דף3/דף5/דף9 | -4}}
 
{{ל}}{{משמאל לימין|#titleparts}}{{כ}}: Talk:דף1/דף3/דף5/דף9{{כ}} | | {{משמאל לימין|-1}}}} {{חץ}} {{#titleparts: Talk:דף1/דף3/דף5/דף9 | | -1}}
 
{{ל}}{{משמאל לימין|#titleparts}}{{כ}}: Talk:דף1/דף3/דף5/דף9{{כ}} | {{משמאל לימין|-1}} | 2}} {{חץ}} {{#titleparts: Talk:דף1/דף3/דף5/דף9 | -1 | 2}}
 
{{ל}}{{משמאל לימין|#titleparts}}{{כ}}: Talk:דף1/דף3/דף5/דף9{{כ}} | {{משמאל לימין|-1}} | {{משמאל לימין|-2}}}} {{חץ}} {{#titleparts: Talk:דף1/דף3/דף5/דף9 | -1 | -2}}
 
== הערות ==
* במידה ואתם משתמשים במספרים שבהם כל שלוש ספרות מופרדות בפסיקים, יש להוריד את הפסיקים הללו לפני החישוב, למשל {{ל}}formatnum:{{כ}}{{ל}}NUMBEROFUSERS}}{{כ}}|R}}{{כ}}: {{formatnum:{{NUMBEROFUSERS}}|R}}.
* האופרטור mod יכול להחזיר ערך שגוי עבור ערכים מסויימים של הפרמטר השני. למשל, {{ל}}#חשב:{{משמאל לימין|3 mod 30000000000000000000}}}} מחזיר הודעת שגיאה של חלוקה באפס.
* אם אתם רוצים לבצע פעולות חשבון על תאריכים, יש להמיר אותם קודם למספר השניות שעברו מאז 1 בינואר 1970 באמצעות {{ל}}#זמן:U}}.
* לעתים כתוצאה מעיגול המספר יווצר "אפס שלילי". קיימת אפשרות שבהשוואה עם 0 תתקבל תשובה לא נכונה.
* לאופרטורים אונאריים יש עדיפות גבוהה יותר מאופרטורים בינאריים. לדוגמה, הביטוי {{ל}}#חשב:{{משמאל לימין|ceil 1/3}}}} יכול לתת תוצאה לא צפויה.
* אין להשוות ביטויים שכוללים תגים, כמו nowiki או #תגית, כי עלולות להתקבל תוצאות שגויות.
* יש להשוות בזהירות ביטויים הכוללים מילות קסם, כי הם עלולים להכיל קידוד התווים במקום התווים עצמם.
 
== ראו גם ==
אוחזר מתוך "https://he.wikipedia.org/wiki/עזרה:הוראות_תנאי"