Перейти до вмісту

Довідка:Умовні оператори

Матеріал з Хабадпедії

Умовні оператори (|ParserFunctions) — це оператори, які дають змогу створювати складні шаблони, що виконують різні математичні й логічні дії, із функціями «#חשב», «#תנאי», «#שווה», «Перевірка помилки», «#חשב תנאי», «#בחר», «#קיים», «#זמןמ», «#זמן» «Адреса сторінки» і «Поділ адреси». Можна також використовувати іншомовну назву функцій, але краще використовувати назви івритом.

Синтаксис функцій: {{#назва функції:параметри, розділені знаком|між ними}}.

Функції

חשב

Ця функція дає змогу обчислювати математичні й логічні вирази. Функція видає повідомлення про помилку під час ділення на 0 тощо. У логічних виразах 0 — значення «хибність», будь-який інший непорожній вираз (при цьому значення за замовчуванням — 1) — значення «істина».

  • Назва івритом: #חשב
  • Назва англійською: ‎#expr
  • Синтаксис: {{#חשב:обчислення}}

Доступні оператори:

Оператор Дія Приклад коду Результат
Відображення чисел {{#חשב:25}}
{{#חשב:123456789012345}}
{{#חשב:0.000001}}
25
1.2345678901234E+14
1.0E-6
( ) Групування дій {{#חשב:(30 + 7) * 7}} 259
+ Додатне число {{#חשב:+30 * +7}} 210
- Від'ємне число {{#חשב:-30 * -7}} 210
* Множення {{#חשב:30 * 7}} 210
/ Ділення, те саме, що div {{#חשב:30 / 7}} 4.2857142857143
div Ділення, те саме, що / (без ділення цілих чисел) {{#חשב:30 div 7}} 4.2857142857143
mod «Модуль» — остача від ділення після перетворення обох чисел на цілі числа.
Увага: div і mod відрізняються від більшості мов програмування.
{{#חשב:30 mod 7}}
{{#חשב:-8 mod -3}}
{{#חשב:-8 mod +3}}
{{#חשב:8 mod 2.7}}
{{#חשב:8 mod 3.2}}
{{#חשב:8.9 mod 3}}
{{#חשב:5 div 2 * 2 + 5 mod 2}}
2
-2
-2
0
2
2
6
+ Додавання {{#חשב:30 + 7}} 37
- Віднімання {{#חשב:30 - 7}} 23
^ Піднесення до степеня {{#חשב:2 ^ 5}} 32
round Округлює перше число до вказаної другим числом кількості знаків після крапки.
Якщо в другому числі є дробова частина, вона не враховуватиметься.
{{#חשב:30 / 7 round 3}}
{{#חשב:30 / 7 round 0}}
{{#חשב:3456 round -2}}
4.286
4
3500
ceil Округлює число вгору {{#חשב:ceil 3.5}}
{{#חשב:ceil -3.5}}
4
-3
floor Округлює число вниз {{#חשב:floor 3.5}}
{{#חשב:floor -3.5}}
3
-4
trunc Видаляє дробову частину числа {{#חשב:trunc 3.5}}
{{#חשב:trunc -3.5}}
3
-3
= Рівність (числова і логічна) {{#חשב:30 = 7}} 0
<> Нерівність, те саме, що != {{#חשב:30 <> 7}} 1
!= Нерівність, те саме, що <>, логічне «XOR» {{#חשב:1 != 0}} 1
< Менше {{#חשב:30 < 7}} 0
> Більше {{#חשב:30 > 7}} 1
<= Менше або дорівнює {{#חשב:30 <= 7}} 0
>= Більше або дорівнює {{#חשב:30 >= 7}} 1
not Логічний оператор «NOT» {{#חשב:not 0 * 7}}
{{#חשב:not 30 + 7}}
7
7
and Логічне «AND» {{#חשב:4 < 5 and 4 mod 2}} 0
or Логічне «OR» {{#חשב:4 < 5 or 4 mod 2}} 1
e e {{#חשב:e}} 2.718281828459
pi pi {{#חשב:pi}} 3.1415926535898

Крім того, можна використовувати унарні функції abs ,exp ,ln ,sin ,cos ,tan ,acos ,asin ,atan.

Цей оператор можна використовувати також для придушення початкових нулів. Приклад: {{#חשב:007}}. Результат: 7.

Умова

Ця функція дає змогу вибирати між двома варіантами: якщо переданий вираз містить не лише порожній простір (тобто пробіли, порожні рядки тощо), вона повертає одне; якщо ні, вона повертає інше.

  • Назва івритом: #תנאי
  • Назва англійською: ‎#if
  • Синтаксис: {{#תנאי:вираз для перевірки|що писати, якщо вираз існує|що писати, якщо вираз не існує}}

Функція використовується передусім у шаблонах, щоб перевірити, чи було їм передано певний параметр, але можливі й багато інших застосувань.

Функція не обчислює переданий їй вираз; для цього існує функція «#חשב תנאי».

Якщо треба лише перевірити, чи було шаблону передано певний параметр, і якщо так — вивести його, а якщо ні — вивести інше значення, краще використовувати форму запису: {{{назва параметра|значення за замовчуванням}}} (наприклад, {{{3|шалом}}}), а не довшу форму {{#תנאי:{{{назва параметра|}}}|{{{назва параметра}}}|значення за замовчуванням}}. Натомість якщо треба вивести, крім параметра, ще щось, якщо він існує, треба використовувати «תנאי».

Умовні вирази можна вкладати один в одного, зазвичай до семи рівнів.

Приклади

Запис: {{#תנאי: |істина|хибність}} ← Результат: хибність

Запис: {{#תנאי:1=9|істина|хибність}} ← Результат: істина

Дорівнює

Ця функція подібна до «#תנאי», але вибирає між варіантами на основі порівняння двох переданих їй виразів. Якщо обидва вирази арифметичні, то й порівняння арифметичне, тобто 1=01. Щоб інтерпретувати числа як рядки, треба використовувати подвійні лапки: "01".

  • Назва івритом: #שווה
  • Назва англійською: ‎#ifeq
  • Синтаксис: {{#שווה:перший вираз для порівняння|другий вираз для порівняння|що писати, якщо вирази рівні|що писати, якщо вирази не рівні}}

Порівняння XML-тегів призведе до неправильного результату.

Приклади

Запис: {{#שווה:A|A|дві літери однакові|дві літери різні}}

Результат: дві літери однакові

Запис: {{#שווה:a|A|дві літери однакові|дві літери різні}}

Результат: дві літери різні

Перевірка помилки

Функція перевіряє, чи є отриманий вираз помилкою. Якщо так, повертається перший параметр (або порожнеча за замовчуванням), інакше — другий параметр (або сам вираз за замовчуванням).

  • Назва англійською: ‎#iferror
  • Синтаксис: {{#iferror:вираз, що перевіряється|що писати, якщо є помилка|що писати, якщо помилки немає}}

Приклади

Запис: {{#iferror:{{#חשב:3+X}}|помилка|правильно}}

Результат: помилка

Запис: {{#iferror:{{#חשב:3+5}}|помилка|правильно}}

Результат: правильно

Запис: {{#iferror:{{#חשב:3+5}}|помилка}}

Результат: 8

Обчислити умову

Ця функція подібна до «#תנאי», але вибирає між варіантами на основі перевірки того, чи є передане їй обчислення (записане в синтаксисі, ідентичному синтаксису функції «#חשב») наявним (тобто не 0), чи ні.

  • Назва івритом: #חשב תנאי
  • Назва англійською: ‎#ifexpr
  • Синтаксис: {{#חשב תנאי:обчислення|що писати, якщо результат обчислення відмінний від 0|що писати, якщо результат обчислення 0}}

Приклад

В обчисленні умови в прикладі використовується команда {{#זמןמ:w}}, яка повертає день тижня, від 0 до 6.

Запис: {{#חשב תנאי:{{#זמןמ:w}}+1=6|Сьогодні п'ятниця, саме час залагодити справи.| Сьогодні звичайний робочий день або Шабат.}}

Результат: Сьогодні звичайний робочий день або Шабат.

Вибір

Ця функція дає змогу вибирати між кількома варіантами на основі перевірки значення переданого виразу. Наприклад, можна задати, що писати за різних значень параметра.

  • Назва івритом: #בחר
  • Назва англійською: ‎#switch

Функція записується так:

{{#בחר:вираз для перевірки|
значення для прикладу=що писати, якщо це значення виразу|
значення для прикладу=що писати, якщо це значення виразу|
значення для прикладу=що писати, якщо це значення виразу|
#ברירת מחדל=що писати, якщо значення виразу не є одним зі значень, записаних вище}}

Якщо вираз для перевірки і значення, з яким його треба порівняти, обидва є числами, порівняння числове, тобто 01 дорівнює 1.

Значення для прикладу може бути порожнім («|=»), і воно читається як порожній рядок.

Якщо підходять кілька значень, спрацьовує лише перше.

Можна пропустити знак = і результат після нього, тоді буде повернуто наступний вираз (див. приклади в кінці). Так можна групувати варіанти.

Англійська назва «#ברירת מחדל» — ‎#default, і її теж можна використовувати. Можна також пропустити її, і тоді нічого не буде написано, якщо вираз не є одним із вказаних значень.

Значення за замовчуванням можна помістити в будь-якому місці виразу, не лише в кінці.

Можна записати значення за замовчуванням без #ברירת מחדל= і також без ‎#default=, додавши розділову риску, так:

{{#בחר:вираз для перевірки|
значення для прикладу=що писати, якщо це значення виразу|
значення для прикладу=що писати, якщо це значення виразу|що писати, якщо значення виразу не є одним зі значень, записаних вище}}

Будь-яке використання знака «=» у цій дії не як частини вказаного синтаксису має бути замінено на {{=}}.

Звісно, можна використовувати скільки завгодно можливих значень виразу — можна використати одне значення, а можна, навпаки, використати сто значень. (Використання лише одного значення не рекомендується, оскільки саме для цього існує функція «#שווה».)

Одне із застосувань шаблону — перевірити значення певного параметра, переданого шаблону, і повернути значення на його основі; можна також використовувати шаблон, щоб отримувати різне значення, коли змінюється системна змінна, наприклад коли змінюється день або змінюється місяць.

Оператор рівносильний вкладеному #שווה і кращий за нього завдяки своїй стислості.

Приклади

Запис: {{#בחר:2|1=тішрей|2=хешван|3=кислев|4=тевет|5=шват|6=адар|7=нісан|8=іяр|9=сіван|10=тамуз|11=ав|12=елул}}

Результат: хешван

Запис: {{#בחר:2|1=тішрей|2=хешван|3=кислев|4|5|6=адар|7=нісан|8=іяр|9=сіван|10=тамуз|11=ав|12=елул}}

Результат: хешван

Існує

Ця функція подібна до «#תנאי», але вибирає між варіантами на основі перевірки того, чи існує передана їй назва сторінки, чи ні.

  • Назва івритом: #קיים
  • Назва англійською: ‎#ifexist
  • Синтаксис: {{#קיים:назва сторінки|що писати, якщо сторінка існує|що писати, якщо сторінка не існує}}

Назву сторінки для перевірки треба писати без квадратних дужок.

Шаблон можна використовувати, наприклад, щоб показати посилання на статтю, лише якщо вона існує.

Сторінка існує, якщо її можна було б записати за допомогою внутрішнього посилання, яке стало б синім. Також сторінки, які фізично не існують, але доступні, наприклад розширення MediaWiki, вважаються наявними.

Для перевірки наявності зображення треба використовувати простір назв «media». Простори назв «Файл» або «Зображення» перевірять лише наявність локального опису.

На одну сторінку треба поміщати якомога менше дій «קיים». Інакше вони перестають працювати, і сторінка автоматично потрапляє до Категорія:Сторінки із занадто великою кількістю викликів ресурсомістких змінних.

Приклад

Запис: {{#קיים:אריה|Стаття «Лев» існує. Варто перевірити, чи не потребує вона розширення.|Стаття «Лев» не існує. У тебе є можливість її відкрити.}}

Результат: Стаття «Лев» існує. Варто перевірити, чи не потребує вона розширення.

זמןמ

Ця функція дає змогу звертатися до системи часу, зазвичай щоб отримати поточний час. Вона працює за годинником вікі, а у випадку сайтів івритом — за ізраїльським часом. Див. також {{זמןמ}}, що розширює цю функцію для введення григоріанської дати івритом і єврейської дати.

  • Назва івритом: #זמןמ
  • Назва англійською: ‎#timel
  • Синтаксис: {{#זמןמ:шаблон відображення часу|дата, з якою треба працювати|код мови}}

Другий параметр не обов'язковий, і в ньому можна вказати дату й час, які треба використати (наприклад, показати час, яким він був 24 години тому). Його значення за замовчуванням — {{CURRENTTIMESTAMP}}, тобто час, коли сторінку було завантажено востаннє.

Єврейська дата змінюється опівночі.

Додавання xh перед будь-яким кодом робить його вираженим цифрами івриту.

Другий параметр може бути відносним, наприклад «- 5 days».

כדי לשים בפורמט טקסט חופשי, ניתן להשתמש במרכאות. למשל, {{#זמןמ:year Y}} יחזיר 26UTCamThu, 05 Nov 2026 07:20:40 +0000 2026, {{#זמןמ:"year" Y}} יחזיר year 2026. כמו כן, xx יחזיר x.

Третій параметр — код мови, якою треба показати результат, при цьому значення за замовчуванням — he.

Див. також Довідка:Ключові слова#Змінні часу.

Формат Пояснення Поточне значення
Y Повний рік 2026
y Короткий рік 26
L 1, якщо григоріанський рік високосний, інакше 0 0
n Номер місяця (від 1 до 12) 11
m Номер місяця (від 01 до 12) 11
M Скорочена назва місяця נוב'
M Скорочена англійська назва місяця (другий параметр en) Nov
F Повна назва місяця נובמבר
F Повна назва місяця (другий параметр en) November
xg Назва місяця івритом, включно з літерою «ב» на початку בנובמבר
W Порядковий номер тижня в році 45
j День місяця (від 1 до 31) 5
d День місяця (від 01 до 31) 05
z Номер дня в році, починаючи з 0 308
D Скорочена назва дня 5
D Скорочена назва дня (другий параметр en) Thu
l Повна назва дня П'яте
l Повна назва дня (другий параметр en) Thursday
w Номер дня тижня, починаючи з неділі (від 0 до 6) 4
N Номер дня тижня, починаючи з понеділка (від 1 до 7) 4
a am або pm am
A AM або PM AM
g Година (від 1 до 12) 7
h Година (від 01 до 12) 07
G Година (від 0 до 23) 7
H Година (від 00 до 23) 07
i Хвилина 20
s שנייה 40
U Секунди, що минули від 1 січня 1970 року 1793863240
e Ідентифікатор часового поясу UTC
I 1, якщо діє літній час, інакше 0 0
O Різниця з часом за Гринвічем +0000
P Різниця з часом за Гринвічем, включно з двокрапкою +00:00
T Скорочення часового поясу UTC
Z Різниця часового поясу в секундах 0
t Кількість днів у поточному місяці 30
c Час, відформатований цифрами англійською 2026-11-05T07:20:40+00:00
r Час, відформатований словами англійською Thu, 05 Nov 2026 07:20:40 +0000
xjj День єврейського місяця 25
xhxjj День єврейського місяця літерами івриту 25
xjF Єврейський місяць Хешван
xjt Кількість днів у єврейському місяці 30
xjx Єврейський місяць у сполученій формі בחשוון
xjn Номер єврейського місяця 2
xjY Єврейський рік 5787
xhxjY Єврейський рік літерами івриту ה'תשפ"ז

Приклади

כתיבת תאריך לועזי מקוצר: {{#זמןמ:d-m-y}} תוצאה: 05-11-26

כתיבת תאריך לועזי מלא: {{#זמןמ:d-M-Y}} תוצאה: 05-נוב'-2026

כתיבת תאריך לועזי מלא: {{#זמןמ:d-M-Y||en}} תוצאה: 05-Nov-2026

כתיבת תאריך לועזי ושעה: {{#זמןמ:G:i:s - j/m/Y}} תוצאה: 7:20:40 - 5/11/2026

כתיבת תאריך לועזי ושעה בעוד 3 שעות: {{#זמןמ:G:i:s - j/m/Y|+ 3 hours}} תוצאה: 10:20:40 - 5/11/2026

כתיבת תאריך עברי: {{#זמןמ:xhxjj xjx xhxjY}} תוצאה: כ"ה בחשוון ה'תשפ"ז

Перетворення григоріанської дати на єврейську дату: {{#זמןמ:xhxjj xjx xhxjY|31-08-1973}} Результат: ג' באלול ה'תשל"ג

Припустимий діапазон дат — від 1 січня 0111 до 31 грудня 9999. Рік 10 буде прочитано як 2010.

Час

Ця функція точно така сама, як זמןמ, але використовує годинник UTC.

  • Назва івритом: #זמן
  • Назва англійською: ‎#time
  • Синтаксис: {{#זמן:шаблон відображення часу|дата, з якою треба працювати|код мови}}

У більшості випадків рекомендується використовувати функцію זמןמ.

Адреса сторінки

Ця функція перетворює відносну адресу сторінки на повну адресу. Якщо немає параметра, що вказує сторінку, за замовчуванням використовується поточна сторінка.

  • Назва англійською: ‎#rel2abs
  • Синтаксис: {{#rel2abs:адреса сторінки}}

Приклад

Запис: {{#rel2abs:.}}

Результат: Довідка:Умовні оператори

Поділ адреси

Ця функція повертає частину адреси сторінки, переданої як параметр.

  • Назва англійською: ‎#titleparts
  • Синтаксис: {{#titleparts:адреса сторінки|скільки частин повернути|порядковий номер першої частини}}

Обидва параметри необов'язкові. Знаки _ перетворюються на пробіли. Глибина поділу — до 25, для більшої можна зробити додатковий виклик. Перед викликом у вхідних даних автоматично замінюється перша літера на велику, якщо вона латинська. Знаки фігурних або квадратних дужок чи решітка у вхідних даних призведуть до неправильного результату.

Приклади

{{#titleparts:Talk:Сторінка1/Сторінка3/Сторінка5/Сторінка9}} ← Обговорення:Сторінка1/Сторінка3/Сторінка5/Сторінка9

{{#titleparts: Talk:Сторінка1/Сторінка3/Сторінка5/Сторінка9 | 1}} ← Обговорення:Сторінка1

{{#titleparts: Talk:Сторінка1/Сторінка3/Сторінка5/Сторінка9 | 2}} ← Обговорення:Сторінка1/Сторінка3

{{#titleparts: Talk:Сторінка1/Сторінка3/Сторінка5/Сторінка9 | 2 | 2}} ← Сторінка3/Сторінка5

{{#titleparts: Talk:Сторінка1/Сторінка3/Сторінка5/Сторінка9 | | 2}} ← Сторінка3/Сторінка5/Сторінка9

{{#titleparts: Talk:Сторінка1/Сторінка3/Сторінка5/Сторінка9 | -1}} ← Обговорення:Сторінка1/Сторінка3/Сторінка5

{{#titleparts: Talk:Сторінка1/Сторінка3/Сторінка5/Сторінка9 | -3}} ← Обговорення:Сторінка1

{{#titleparts: Talk:Сторінка1/Сторінка3/Сторінка5/Сторінка9 | -4}} ←

{{#titleparts: Talk:Сторінка1/Сторінка3/Сторінка5/Сторінка9 | | -1}} ← Сторінка9

{{#titleparts: Talk:Сторінка1/Сторінка3/Сторінка5/Сторінка9 | -1 | 2}} ← Сторінка3/Сторінка5

{{#titleparts: Talk:Сторінка1/Сторінка3/Сторінка5/Сторінка9 | -1 | -2}} ← Сторінка5

Зауваження

  • במידה ואתם משתמשים במספרים שבהם כל שלוש ספרות מופרדות בפסיקים, יש להוריד את הפסיקים הללו לפני החישוב, למשל {{formatnum:{{NUMBEROFUSERS}}|R}} (תוצאה: 5).
  • Оператор mod може повернути неправильне значення для деяких значень другого параметра. Наприклад, {{#חשב:3 mod 30000000000000000000}} повертає повідомлення про помилку ділення на нуль.
  • Якщо ви хочете виконувати арифметичні дії над датами, їх треба спочатку перетворити на кількість секунд, що минули від 1 січня 1970 року, за допомогою {{#זמן:U}}.
  • Іноді внаслідок округлення числа виникає «від'ємний нуль». Існує ймовірність, що під час порівняння з 0 буде отримано неправильну відповідь.
  • Унарні оператори мають вищий пріоритет, ніж бінарні оператори. Наприклад, вираз {{#חשב:ceil 1/3}} може дати несподіваний результат.
  • Не можна порівнювати вирази, що містять теги, як-от nowiki або #תגית, оскільки можуть вийти неправильні результати.
  • Вирази, що містять чарівні слова, треба порівнювати з обережністю, оскільки вони можуть містити кодування символів замість самих символів.
  • Коли на початку або в кінці результату умови потрібен пробіл, його треба створити за допомогою {{רווח קל}}, оскільки в цьому випадку умовний оператор ігнорує звичайний пробіл.

Див. також

Повідомити про помилку на цій сторінці