Справка:Условные операторы
Условные операторы (|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 или #תגית, так как могут получиться неверные результаты.
- Выражения, включающие волшебные слова, нужно сравнивать с осторожностью, так как они могут содержать кодировку символов вместо самих символов.
- Когда в начале или в конце результата условия требуется пробел, его нужно создать с помощью {{רווח קל}}, поскольку в этом случае условный оператор игнорирует обычный пробел.