עזרה:הוראות תנאי – הבדלי גרסאות
מ החלפת טקסט – " " ב־" " |
חלוקת קונטרסים (שיחה | תרומות) אין תקציר עריכה |
||
| (5 גרסאות ביניים של 2 משתמשים אינן מוצגות) | |||
| שורה 1: | שורה 1: | ||
'''הוראות תנאי''' ( | '''הוראות תנאי''' (|ParserFunctions) הן הוראות שמאפשרות ליצור [[עזרה:תבניות|תבניות]] מתוחכמות המבצעות פעולות מתמטיות ולוגיות שונות הכוללות את הפונקציות "[[#חשב]]", "[[#תנאי]]", "[[#שווה]]", "[[#בדיקת שגיאה|בדיקת שגיאה]]", "[[#חשב תנאי]]", "[[#בחר]]", "[[#קיים]]", "[[#זמןמ]]", "[[#זמן]]" "[[#כתובת הדף|כתובת הדף]]" ו"[[#חלוקת הכתובת|חלוקת הכתובת]]". ניתן להשתמש גם בשמן הלועזי של הפונקציות, אך עדיף להשתמש בשמות העבריים. | ||
תחביר הפונקציות הוא '''{{#שם הפונקציה:פרמטרים המופרדים בסימן{{!}}ביניהם}}'''. | תחביר הפונקציות הוא '''{{#שם הפונקציה:פרמטרים המופרדים בסימן{{!}}ביניהם}}'''. | ||
| שורה 202: | שורה 202: | ||
=== בדיקת שגיאה === | === בדיקת שגיאה === | ||
הפונקציה בודקת האם הביטוי שהתקבל הינו שגיאה. במידה וכן, מוחזר הפרמטר הראשון (או ריק כברירת מחדל), אחרת הפרמטר השני (או הביטוי עצמו כברירת מחדל). | הפונקציה בודקת האם הביטוי שהתקבל הינו שגיאה. במידה וכן, מוחזר הפרמטר הראשון (או ריק כברירת מחדל), אחרת הפרמטר השני (או הביטוי עצמו כברירת מחדל). | ||
* '''שם אנגלי:''' #iferror | * '''שם אנגלי:''' #iferror | ||
| שורה 230: | שורה 230: | ||
====דוגמה==== | ====דוגמה==== | ||
בחישוב תנאי בדוגמה | בחישוב תנאי בדוגמה נעשה שימוש בפקודה {{((}}#זמןמ:w}} שמחזירה את היום בשבוע, בין 0 ל־6. | ||
'''כתיבה:''' <nowiki>{{#חשב תנאי:{{#זמןמ:</nowiki | '''כתיבה:''' <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. | ||
* '''שם עברי:''' #זמן | * '''שם עברי:''' #זמן | ||
| שורה 502: | שורה 502: | ||
* אין להשוות ביטויים שכוללים תגים, כמו nowiki או #תגית, כי עלולות להתקבל תוצאות שגויות. | * אין להשוות ביטויים שכוללים תגים, כמו nowiki או #תגית, כי עלולות להתקבל תוצאות שגויות. | ||
* יש להשוות בזהירות ביטויים הכוללים מילות קסם, כי הם עלולים להכיל קידוד התווים במקום התווים עצמם. | * יש להשוות בזהירות ביטויים הכוללים מילות קסם, כי הם עלולים להכיל קידוד התווים במקום התווים עצמם. | ||
* כאשר נדרש [[ | * כאשר נדרש [[תבנית:רווח|רווח]] בתחילתה או בסופה של תוצאת התנאי, יש ליצור אותו באמצעות {{תב|רווח קל}}, משום שבמצב זה הוראת התנאי מתעלמת מרווח רגיל. | ||
== ראו גם == | |||
* [[עזרה:מילות מפתח]] | |||
[[קטגוריה:חב"דפדיה - תמיכה טכנית|הוראות תנאי]] | [[קטגוריה:חב"דפדיה - תמיכה טכנית|הוראות תנאי]] | ||