Текстовые функции позволяют управлять строками символов.
Если функция ожидает строку, но встречает число, она преобразует его в строку с использованием математической записи ("." десятичный разделитель, без разделителя тысяч).
CONCAT
CONCAT(Value; ...)
Объединяет (объединяет) текстовые значения в один текст.
|
Параметр |
Тип |
Описание |
|
Value1, Value2, ..., ValueN
OR
A |
Любой
Массив |
Текстовые строки. Принимает любое количество аргументов. Игнорирует ложные значения. |
|
→ Result |
Текст |
Один текст, содержащий все объединенные значения. |
Пример:
- CONCAT(Reporter; ' => '; Assignee)
EXACT
EXACT(A; B)
Проверяет, совпадает ли текстовое значение A с текстовым значением B.
|
Параметр |
Тип |
Описание |
|
A |
Текст/присоединился |
Текстовое значение |
|
В |
Текст/присоединился |
Текстовое значение |
|
→ Result |
Булев |
Возвращает true (1), если значения совпадают. В противном случае ложь (0). |
Это сравнение чувствительно к регистру, что отличается от сравнения A с B с использованием знака равенства или сопоставления текста. Неопределенные значения будут равны друг другу и пустым строкам.
Примеры:
- EXACT("Fox"; "fox") → 0
- EXACT("Fox"; "Fox") → 1
- EXACT(""; undefined) → 1
LEFT
LEFT(Value; N)
Возвращает до N крайних левых символов из текстового значения.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/присоединился |
Текст, из которого нужно получить символы. |
|
N |
Integer |
Количество символов, которое необходимо получить. |
|
→ Result |
Булев |
Первые N символов, начиная слева. Если значение содержит меньше символов, возвращаются все они. Если значение меньше нуля, возвращается пустой текст. |
Пример:
- LEFT("abc"; 2) → "ab"
LEN
LEN(Value)
Возвращает количество символов в текстовом значении.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/присоединился |
Текст для подсчета. Если значение не является текстом, оно сначала преобразуется в текст. |
|
→ Result |
Integer |
Количество символов в Value. |
Пример:
- LEN("abc") → 3
LOWER
LOWER(Value)
Преобразует текст в нижний регистр. Применяется локаль текущего пользователя.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/каждое |
Текст для преобразования. |
|
→ Result |
Integer |
Значение в нижнем регистре. |
Пример:
- LOWER("HAM") → "ham"
MATCH
MATCH(Value; Pattern)
Проверяет, соответствует ли значение шаблону.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/присоединился |
Значение для проверки. |
|
Pattern |
Текст/присоединился |
Шаблон для проверки. Может быть точным значением, подстановочным знаком или регулярным выражением. Подробности см. в разделе Сопоставление шаблонов выражений. |
|
→ Result |
Булев |
Возвращает истину (1) или ложь (0). |
Примеры:
- MATCH("Apples"; "Oranges") → 0
- MATCH(" Blocker "; "blocker") → 1
- MATCH("Hamster"; "ham*") → 1
- MATCH("The Flight of the Bumblebee"; "/.light.*beer?/") → 1
MID
MID(Value; Index; Count)
Извлекает часть текста.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/присоединился |
Текстовое значение, из которого нужно получить подстроку. |
|
Index |
Integer |
Начальный индекс извлекаемой части, отсчитываемый от 1 (первый символ находится в индексе 1). |
|
Count |
Integer |
Количество символов для извлечения. |
|
→ Result |
Текст |
Текст, содержащий количество символов Count, начиная с индекса. |
Пример:
- MID("A quick brown fox"; 3; 5) → "quick"
REPEAT
REPEAT(Value; N)
Создает текст, который является повторением строкового значения N раз.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/присоединился |
Текст для повторений. |
|
N |
Integer |
Количество повторений. |
|
→ Result |
Текст |
Повторяющийся текст. |
Примеры:
- REPEAT("ha"; 3) → "hahaha"
- REPEAT(123, 3) → "123123123"
REPLACE
REPLACE(Value; Pattern; Replacement)
Заменяет все вхождения шаблона на замену и возвращает новый текст.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/присоединился
|
Текст для манипулирования.
|
|
Pattern |
Текст
|
Образец, который нужно найти. Может быть точным значением, подстановочным знаком или регулярным выражением. Подробности см. в разделе Сопоставление шаблонов выражений. |
|
Replacement (необязательно)
|
Текст |
Необязательный текст для использования вместо совпадающих частей. Если опущено, соответствующие части удаляются. |
|
→ Result |
Текст |
Значение с заменами. |
Примеры:
- REPLACE("I like cats"; "CAT"; "DOG") → "I like DOGs"
- REPLACE("Can you read this?"; "/[aeuio]/") → "Cn y rd ths?"
REPLACE_AT
REPLACE_AT(Value; Index; Count; Replacement)
Заменяет определенную часть значения текстом замены и возвращает значение.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/присоединился
|
Текст для манипулирования.
|
|
Index |
Integer
|
Начальный индекс заменяемой части, основанный на 1 (первый символ — 1, второй — 2 и т. д.) |
|
Count |
Integer
|
Количество символов для замены. Когда Count равен 0, строка замены Replacement вставляется в позицию индекса. |
|
Replacement (необязательно) |
Текст
|
Необязательный текст для использования вместо замененной части. Если его не указать, часть будет удалена. |
|
→ Result |
Текст
|
Значение с заменами. |
Когда значения Index и Count выходят за пределы допустимого диапазона, они приводятся к ближайшему разумному значению.
Примеры:
- REPLACE_AT("A"; 1; 1; "B") → "B"
- REPLACE_AT("What does the fox say?"; 6; 4; "did") → "What did the fox say?"
- REPLACE_AT("A step for mankind"; 3; 0; "small ") → "A small step for mankind"
- REPLACE_AT("A step for mankind"; 7; 1000) → "A step"
RIGHT
RIGHT(Value; N)
Возвращает до N крайних правых символов из строкового значения.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/присоединился
|
Текст, из которого нужно получить символы. |
|
N |
Integer
|
Количество символов, которое необходимо получить. |
|
→ Result |
Текст
|
Первые N символов, начиная справа. Если значение содержит меньше символов, возвращаются все они. |
Пример:
- RIGHT("abc"; 2) → "bc"
SEARCH
SEARCH(Pattern; Value; Index)
Находит первое вхождение шаблона в значение.
|
Параметр |
Тип |
Описание |
|
Pattern |
Текст |
Текст или шаблон для поиска. Может быть точным значением, подстановочным знаком или регулярным выражением. Подробности см. в разделе Сопоставление шаблонов выражений. |
|
Value |
Текст/присоединился
|
Текст для поиска. |
|
Index |
Integer
|
Необязательный параметр, предоставляющий индекс для начала поиска. |
|
→ Result |
Integer
|
Возвращает индекс совпадающей части (на основе 1) или значение undefined, если оно не найдено. |
Примеры:
- SEARCH("ham"; "The Ham is for the Hamster"; 6) → 20
- SEARCH("Jedi*"; "Return of the Jedi") → 15
- SEARCH("/^Jedi/"; "Not the Jedi you're looking for") → undefined
SPLIT
SPLIT(Value; Separator)
Создает массив из значения, разделяя его с помощью разделителя.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/присоединился
|
Текст для разделения. |
|
Separator |
Текст
|
Separator Текст или шаблон для разделения. Может быть точным значением, подстановочным знаком или регулярным выражением. Подробности см. в разделе Сопоставление шаблонов выражений. |
|
→ Result |
Массив |
Возвращает массив, содержащий разделенные тексты. |
Примеры:
- SPLIT("One, Two, Three", ",") → ARRAY("One", "Two", "Three")
- SPLIT("A and B or C", "/ and | or /") → ARRAY("A", "B", "C")
SUBSTRING
SUBSTRING(Value; From; To)
Возвращает подстроку, указанную начальным индексом и конечным индексом. Обратите внимание, что индексы отсчитываются от 0, в отличие от некоторых других функций.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/присоединился |
Текст, из которого нужно взять часть. |
|
To (необязательно) |
Integer
|
Начальный индекс включительно, 0 означает первый символ, LEN(Value)-1 означает последний символ.. |
|
To (необязательно) |
Integer
|
Необязательный конечный индекс, эксклюзивный - символ с этим индексом не будет включен. Если опущено, подстрока будет включать все символы до конца значения. |
|
→ Result |
Текст |
Возвращает часть текста, содержащуюся между From и To. |
Если значение To больше длины текста, будут включены все символы. Если To меньше, чем From, возвращается пустой текст.
Примеры:
- SUBSTRING("Batman"; 0; 3) → "Bat"
- SUBSTRING("Batman"; 3) → "man"
TRIM
TRIM(Value)
Удаляет начальные и конечные пробелы из текста.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/Каждый |
Текст для манипулирования. |
|
→ Result |
Текст |
Возвращает Value без начальных/конечных пробелов. |
Пример:
- TRIM(" Batman ") → "Batman"
UPPER
UPPER(Value)
Преобразует строку в верхний регистр. Применяется локаль текущего пользователя.
|
Параметр |
Тип |
Описание |
|
Value |
Текст/Каждый |
Текст для манипулирования. |
|
|
Текст |
Возвращает Value в верхнем регистре. |
Пример:
UPPER("ham") → "HAM"
По материалам Atlassian JIRA Structure: Text Functions