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

מ החלפת טקסט – " " ב־" "
אין תקציר עריכה
 
(5 גרסאות ביניים של 2 משתמשים אינן מוצגות)
שורה 1: שורה 1:
'''הוראות תנאי''' ([[mw:Help:Extension:ParserFunctions|ParserFunctions]]) הן הוראות שמאפשרות ליצור [[עזרה:תבניות|תבניות]] מתוחכמות המבצעות פעולות מתמטיות ולוגיות שונות הכוללות את הפונקציות "[[#חשב]]", "[[#תנאי]]", "[[#שווה]]", "[[#בדיקת שגיאה|בדיקת שגיאה]]", "[[#חשב תנאי]]", "[[#בחר]]", "[[#קיים]]", "[[#זמןמ]]", "[[#זמן]]" "[[#כתובת הדף|כתובת הדף]]" ו"[[#חלוקת הכתובת|חלוקת הכתובת]]". ניתן להשתמש גם בשמן הלועזי של הפונקציות, אך עדיף להשתמש בשמות העבריים.
'''הוראות תנאי''' (|ParserFunctions) הן הוראות שמאפשרות ליצור [[עזרה:תבניות|תבניות]] מתוחכמות המבצעות פעולות מתמטיות ולוגיות שונות הכוללות את הפונקציות "[[#חשב]]", "[[#תנאי]]", "[[#שווה]]", "[[#בדיקת שגיאה|בדיקת שגיאה]]", "[[#חשב תנאי]]", "[[#בחר]]", "[[#קיים]]", "[[#זמןמ]]", "[[#זמן]]" "[[#כתובת הדף|כתובת הדף]]" ו"[[#חלוקת הכתובת|חלוקת הכתובת]]". ניתן להשתמש גם בשמן הלועזי של הפונקציות, אך עדיף להשתמש בשמות העבריים.


תחביר הפונקציות הוא '''{{#שם הפונקציה:פרמטרים המופרדים בסימן{{!}}ביניהם}}'''.
תחביר הפונקציות הוא '''{{#שם הפונקציה:פרמטרים המופרדים בסימן{{!}}ביניהם}}'''.
שורה 202: שורה 202:


=== בדיקת שגיאה ===
=== בדיקת שגיאה ===
הפונקציה בודקת האם הביטוי שהתקבל הינו שגיאה. במידה וכן, מוחזר הפרמטר הראשון (או ריק כברירת מחדל), אחרת הפרמטר השני (או הביטוי עצמו כברירת מחדל).
הפונקציה בודקת האם הביטוי שהתקבל הינו שגיאה. במידה וכן, מוחזר הפרמטר הראשון (או ריק כברירת מחדל), אחרת הפרמטר השני (או הביטוי עצמו כברירת מחדל).


* '''שם אנגלי:''' ‎#iferror
* '''שם אנגלי:''' ‎#iferror
שורה 230: שורה 230:
====דוגמה====
====דוגמה====


בחישוב תנאי בדוגמה נעשה נעשה שימוש בפקודה {{((}}#זמןמ:w}} שמחזירה את היום בשבוע, בין 0 ל־6.
בחישוב תנאי בדוגמה נעשה שימוש בפקודה {{((}}#זמןמ:w}} שמחזירה את היום בשבוע, בין 0 ל־6.


'''כתיבה:''' <nowiki>{{#חשב תנאי:{{#זמןמ:</nowiki><span dir="ltr">w}}+1</span>=6|היום יום ששי, זה הזמן לעשות סידורים.| היום יום עבודה רגיל או יום שבת.}}
'''כתיבה:''' <span dir="rtl"><nowiki>{{#חשב תנאי:{{#זמןמ:</nowiki>w}}+1</span>=6|היום יום ששי, זה הזמן לעשות סידורים.| היום יום עבודה רגיל או יום שבת.}}


'''תוצאה:''' {{#חשב תנאי:{{#זמןמ:w}}+1=6|היום יום ששי, זה הזמן לעשות סידורים.| היום יום עבודה רגיל או יום שבת.}}
'''תוצאה:''' {{#חשב תנאי:{{#זמןמ:w}}+1=6|היום יום ששי, זה הזמן לעשות סידורים.| היום יום עבודה רגיל או יום שבת.}}
שורה 274: שורה 274:
אחד השימושים בתבנית הוא כדי לבדוק את ערכו של פרמטר מסוים שהועבר לתבנית ולהחזיר ערך על בסיסו, ואפשר גם להשתמש בתבנית כדי לקבל ערך שונה כ[[עזרה:מילות מפתח|שמשתנה מערכת]] משתנה, למשל כשהיום משתנה, או החודש משתנה.
אחד השימושים בתבנית הוא כדי לבדוק את ערכו של פרמטר מסוים שהועבר לתבנית ולהחזיר ערך על בסיסו, ואפשר גם להשתמש בתבנית כדי לקבל ערך שונה כ[[עזרה:מילות מפתח|שמשתנה מערכת]] משתנה, למשל כשהיום משתנה, או החודש משתנה.


ההוראה מקבילה ל [[#שווה]] מקונן ועדיפה על פניה בגלל אורכה הקצר.
ההוראה מקבילה ל [[#שווה]] מקונן ועדיפה על פניה בגלל אורכה הקצר.


====דוגמאות====
====דוגמאות====
שורה 292: שורה 292:
* '''תחביר:''' {{((}}#קיים:שם הדף|מה לכתוב אם הדף קיים|מה לכתוב אם הדף אינו קיים}}
* '''תחביר:''' {{((}}#קיים:שם הדף|מה לכתוב אם הדף קיים|מה לכתוב אם הדף אינו קיים}}


את שם הדף לבדיקה יש לכתוב '''ללא''' סוגריים מרובעות.  
את שם הדף לבדיקה יש לכתוב '''ללא''' סוגריים מרובעים.  


ניתן להשתמש בתבנית, למשל, כדי להציג קישור לערך רק אם הוא קיים.
ניתן להשתמש בתבנית, למשל, כדי להציג קישור לערך רק אם הוא קיים.
שורה 332: שורה 332:
! פורמט !! הסבר !! ערך נוכחי
! פורמט !! הסבר !! ערך נוכחי
|-
|-
| Y|| שנה מלאה|| {{#זמןמ:Y}}
| Y|| שנה מלאה|| {{#זמןמ:Y}}
|-
|-
| y|| שנה קצרה|| {{#זמןמ:y}}
| y|| שנה קצרה|| {{#זמןמ:y}}
|-
|-
| L|| 1 אם שנה לועזית מעוברת, 0 אחרת|| {{#זמןמ:L}}
| L|| 1 אם שנה לועזית מעוברת, 0 אחרת|| {{#זמןמ:L}}
|-
|-
| n|| מספר חודש (1 עד 12)|| {{#זמןמ:n}}
| n|| מספר חודש (1 עד 12)|| {{#זמןמ:n}}
|-
|-
| m|| מספר חודש (01 עד 12)|| {{#זמןמ:m}}
| m|| מספר חודש (01 עד 12)|| {{#זמןמ:m}}
|-
|-
| M|| השם המקוצר של החודש || {{#זמןמ:M}}
| M|| השם המקוצר של החודש || {{#זמןמ:M}}
|-
|-
| M|| השם האנגלי המקוצר של החודש (הפרמטר השני en) || {{#זמןמ:M||en}}
| M|| השם האנגלי המקוצר של החודש (הפרמטר השני en) || {{#זמןמ:M||en}}
|-
|-
| F|| השם המלא של החודש|| {{#זמןמ:F}}
| F|| השם המלא של החודש|| {{#זמןמ:F}}
|-
|-
| F|| השם המלא של החודש (הפרמטר השני en)|| {{#זמןמ:F||en}}
| F|| השם המלא של החודש (הפרמטר השני en)|| {{#זמןמ:F||en}}
|-
|-
| xg|| שם עברי של חודש כולל האות "ב" בהתחלה|| {{#זמןמ:xg}}
| xg|| שם עברי של חודש כולל האות "ב" בהתחלה|| {{#זמןמ:xg}}
|-
|-
| W|| מספר סידורי של שבוע בשנה|| {{#זמןמ:W}}
| W|| מספר סידורי של שבוע בשנה|| {{#זמןמ:W}}
|-
|-
| j|| יום בחודש (1 עד 31)|| {{#זמןמ:j}}
| j|| יום בחודש (1 עד 31)|| {{#זמןמ:j}}
|-
|-
| d|| יום בחודש (01 עד 31)|| {{#זמןמ:d}}
| d|| יום בחודש (01 עד 31)|| {{#זמןמ:d}}
|-
|-
| z|| מספר של יום בשנה, החל מ-0|| {{#זמןמ:z}}
| z|| מספר של יום בשנה, החל מ-0|| {{#זמןמ:z}}
|-
|-
| D|| השם המקוצר של היום|| {{#זמןמ:D}}
| D|| השם המקוצר של היום|| {{#זמןמ:D}}
|-
|-
| D|| השם המקוצר של היום (הפרמטר השני en)|| {{#זמןמ:D||en}}
| D|| השם המקוצר של היום (הפרמטר השני en)|| {{#זמןמ:D||en}}
|-
|-
| l|| השם המלא של היום|| {{#זמןמ:l}}
| l|| השם המלא של היום|| {{#זמןמ:l}}
|-
|-
| l|| השם המלא של היום (הפרמטר השני en)|| {{#זמןמ:l||en}}
| l|| השם המלא של היום (הפרמטר השני en)|| {{#זמןמ:l||en}}
|-
|-
| w|| מספר של יום בשבוע, החל מ-מיום ראשון (0 עד 6)|| {{#זמןמ:w}}
| w|| מספר של יום בשבוע, החל מ-מיום ראשון (0 עד 6)|| {{#זמןמ:w}}
|-
|-
| N|| מספר של יום בשבוע, החל מיום שני (1 עד 7)|| {{#זמןמ:N}}
| N|| מספר של יום בשבוע, החל מיום שני (1 עד 7)|| {{#זמןמ:N}}
|-
|-
| a|| am או pm|| {{#זמןמ:a}}
| a|| am או pm|| {{#זמןמ:a}}
|-
|-
| A|| AM או PM|| {{#זמןמ:A}}
| A|| AM או PM|| {{#זמןמ:A}}
|-
|-
| g|| שעה (1 עד 12)|| {{#זמןמ:g}}
| g|| שעה (1 עד 12)|| {{#זמןמ:g}}
|-
|-
| h|| שעה (01 עד 12)|| {{#זמןמ:h}}
| h|| שעה (01 עד 12)|| {{#זמןמ:h}}
|-
|-
| G|| שעה (0 עד 23)|| {{#זמןמ:G}}
| G|| שעה (0 עד 23)|| {{#זמןמ:G}}
|-
|-
| H|| שעה (00 עד 23)|| {{#זמןמ:H}}
| H|| שעה (00 עד 23)|| {{#זמןמ:H}}
|-
|-
| i|| דקה|| {{#זמןמ:i}}
| i|| דקה|| {{#זמןמ:i}}
|-
|-
| s|| שנייה|| {{#זמןמ:s}}
| s|| שנייה|| {{#זמןמ:s}}
|-
|-
| U|| שניות שעברו מ-1 בינואר 1970|| {{#זמןמ:U}}
| U|| שניות שעברו מ-1 בינואר 1970|| {{#זמןמ:U}}
|-
|-
| e|| מזהה אזור זמן|| {{#זמןמ:e}}
| e|| מזהה אזור זמן|| {{#זמןמ:e}}
|-
|-
| I|| 1 אם יש שעון קיץ, 0 אחרת|| {{#זמןמ:I}}
| I|| 1 אם יש שעון קיץ, 0 אחרת|| {{#זמןמ:I}}
|-
|-
| O|| הבדל משעון גריניץ'|| {{משמאל לימין|{{#זמןמ:O}}}}
| O|| הבדל משעון גריניץ'|| {{משמאל לימין|{{#זמןמ:O}}}}
|-
|-
| P|| הבדל משעון גריניץ' כולל נקודתיים|| {{משמאל לימין|{{#זמןמ:P}}}}
| P|| הבדל משעון גריניץ' כולל נקודתיים|| {{משמאל לימין|{{#זמןמ:P}}}}
|-
|-
| T|| קיצור אזור זמן|| {{#זמןמ:T}}
| T|| קיצור אזור זמן|| {{#זמןמ:T}}
|-
|-
|Z||הפרש אזור זמן בשניות||{{#זמןמ:Z}}
|Z||הפרש אזור זמן בשניות||{{#זמןמ:Z}}
שורה 427: שורה 427:
====דוגמאות====
====דוגמאות====


'''כתיבת תאריך לועזי מקוצר:''' <nowiki>{{#זמןמ:d-m-y}}</nowiki> '''תוצאה:''' {{#זמןמ:d-m-y}}
'''כתיבת תאריך לועזי מקוצר:''' <nowiki>{{#זמןמ:d-m-y}}</nowiki> '''תוצאה:''' {{#זמןמ:d-m-y}}


'''כתיבת תאריך לועזי מלא:''' <nowiki>{{#זמןמ:d-M-Y}}</nowiki> '''תוצאה:''' {{#זמןמ:d-M-Y}}
'''כתיבת תאריך לועזי מלא:''' <nowiki>{{#זמןמ:d-M-Y}}</nowiki> '''תוצאה:''' {{#זמןמ:d-M-Y}}


'''כתיבת תאריך לועזי מלא:''' <nowiki>{{#זמןמ:d-M-Y||en}}</nowiki> '''תוצאה:''' {{#זמןמ:d-M-Y||en}}
'''כתיבת תאריך לועזי מלא:''' <nowiki>{{#זמןמ:d-M-Y||en}}</nowiki> '''תוצאה:''' {{#זמןמ:d-M-Y||en}}


'''כתיבת תאריך לועזי ושעה:''' <nowiki>{{#זמןמ:G:i:s - j/m/Y}}</nowiki> '''תוצאה:''' {{#זמןמ:G:i:s - j/m/Y}}
'''כתיבת תאריך לועזי ושעה:''' <nowiki>{{#זמןמ:G:i:s - j/m/Y}}</nowiki> '''תוצאה:''' {{#זמןמ:G:i:s - j/m/Y}}
שורה 444: שורה 444:


=== זמן ===
=== זמן ===
הפונקציה הזו היא בדיוק כמו זמןמ, אבל משתמשת בשעון [[UTC]].
הפונקציה הזו היא בדיוק כמו זמןמ, אבל משתמשת בשעון UTC.


* '''שם עברי:''' #זמן
* '''שם עברי:''' #זמן
שורה 502: שורה 502:
* אין להשוות ביטויים שכוללים תגים, כמו nowiki או #תגית, כי עלולות להתקבל תוצאות שגויות.
* אין להשוות ביטויים שכוללים תגים, כמו nowiki או #תגית, כי עלולות להתקבל תוצאות שגויות.
* יש להשוות בזהירות ביטויים הכוללים מילות קסם, כי הם עלולים להכיל קידוד התווים במקום התווים עצמם.
* יש להשוות בזהירות ביטויים הכוללים מילות קסם, כי הם עלולים להכיל קידוד התווים במקום התווים עצמם.
* כאשר נדרש [[מרווח (כתב)|רווח]] בתחילתה או בסופה של תוצאת התנאי, יש ליצור אותו באמצעות {{תב|רווח קל}}, משום שבמצב זה הוראת התנאי מתעלמת מרווח רגיל.
* כאשר נדרש [[תבנית:רווח|רווח]] בתחילתה או בסופה של תוצאת התנאי, יש ליצור אותו באמצעות {{תב|רווח קל}}, משום שבמצב זה הוראת התנאי מתעלמת מרווח רגיל.
 
== ראו גם ==
* [[עזרה:מילות מפתח]]


[[קטגוריה:חב"דפדיה - תמיכה טכנית|הוראות תנאי]]
[[קטגוריה:חב"דפדיה - תמיכה טכנית|הוראות תנאי]]