Текстовые функции

Module
Contents
Index 🔎︎

# Text Functions

This section contains descriptions of the Text functions.

Доступ к этой команде

Вставка - Функция - Тип Текст

## REGEX

Matches and extracts or optionally replaces text using regular expressions.

## WEBSERVICE

Get some web content from a URI.

## FILTERXML

Apply a XPath expression to a XML document.

## ENCODEURL

Returns a URL-encoded string.

## ARABIC

Вычисляет значение, заданное римскими цифрами. Значение должно находиться в интервале от 0 до 3999.

### Syntax

ARABIC("Текст")

Текст: текст, представляющий собой римское число.

### Example

=ARABIC("MXIV") возвращает значение 1014.

=ARABIC("MMII") возвращает значение 2002.

## ASC

Функция ASC используется для преобразования символов ASCII и Катаканы с полной шириной в символы с половинной шириной. Возвращает текстовую строку.

See https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions for a conversion table.

### Syntax

ASC("Текст")

Текст - текст, содержащий символы для преобразования.

См. также описание функции JIS.

## BAHTTEXT

Преобразует число в текст на тайском языке, включая названия тайской валюты.

### Syntax

BAHTTEXT(Число)

Число: произвольное число. "бат" добавляется к целой части числа, а "сатанг" – к десятичной части числа.

### Example

=BAHTTEXT(12.65) возвращает строку в тайских символах со значением "двенадцать бат и шестьдесят пять сатанг".

## BASE

Преобразует положительное целое число с заданным основанием в текст, выражающий число в определенной системе счисления. Используются цифры 0-9 и буквы A-Z.

### Syntax

BASE(Число; Основание; [Минимальная длина])

Число: положительное целое число для преобразования.

Основание: основание системы счисления. Это может быть любое положительное целое число от 2 до 36.

Минимальная_длина (необязательный параметр): минимальная длина созданной последовательности символов. Если текст короче указанной минимальной длины, в начало строки добавляются нули.

### Example

=BASE(17;10;4) возвращает значение 0017 в десятичной системе счисления.

=BASE(17;2) возвращает значение 10001 в двоичной системе счисления.

=BASE(255;16;4) возвращает число 00FF в шестнадцатеричной системе счисления.

## CHAR

Служит для преобразования числа в символ в соответствии с текущей кодовой таблицей. Число может быть целым двухзначным или трёхзначным числом.

Коды больше 127 могут зависеть от системной кодировки (например, iso-8859-1, iso-8859-2, Windows 1252, Windows 1250) и поэтому быть непереносимыми.

### Syntax

CHAR(Число)

Число: число от 1 до 255, определяющее кодовое значение символа.

### Example

=CHAR(100) возвращает символ "d".

="abc" & CHAR(10) & "def" обеспечивает вставку символа разрыва строки.

## CLEAN

Служит для удаления всех непечатаемых символов из строки.

### Syntax

CLEAN("Текст")

Текст: текст, из которого требуется удалить все непечатаемые символы.

## CODE

Возвращает числовой код первого символа в текстовой строке.

### Syntax

CODE("Текст")

Текст: текст, для которого требуется определить код первого символа.

Коды больше 127 могут зависеть от системной кодировки (например, iso-8859-1, iso-8859-2, Windows 1252, Windows 1250) и поэтому быть непереносимыми.

### Example

=CODE("Hieronymus") возвращает значение 72, =CODE("hieroglyphic") возвращает значение 104.

Используемый код принадлежит не таблице ASCII, а загруженной кодовой таблице.

## CONCATENATE

Объединяет несколько текстовых элементов в одну строку.

### Syntax

CONCATENATE("Текст1"; ...; "Текст30")

Текст 1; текст 2; ...: до 30 текстовых элементов, которые требуется объединить в одну строку.

### Example

=CONCATENATE("Доброе ";"утро ";"миссис ";"Доу") возвращает значение "Доброе утро, миссис Доу".

## DECIMAL

Преобразует текст с символами, представленными в определеннойсистеме счисления, в положительное целое число с заданным основанием. Основа должна входить в диапазон от 2 до 36. Пробелы и символы табуляции игнорируются. В поле Текст регистр символов не учитывается.

Если основание равно 16, первая x, X, 0x или 0X, а также добавочная h или H не учитываются. Если основание равно 2, добавочная b или B не учитывается. При использовании символов, которые не принадлежат к указанной системе счисления, выдаётся ошибка.

### Syntax

DECIMAL("Текст"; Основание)

Текст: текст для преобразования. Для определения различия между числом шестнадцатеричном формате A1 и ссылки на ячейку A1 число следует заключить в кавычки, например, "A1" или "FACE".

Основание: основание системы счисления. Это может быть любое положительное целое число от 2 до 36.

### Example

=DECIMAL("17";10) возвращает значение 17.

=DECIMAL("FACE";16) возвращает значение 64206.

=DECIMAL("0101";2) возвращает значение 5.

## DOLLAR

Служит для преобразования числа в сумму в денежном формате, округленную до указанного разряда. В поле Значение введите число для преобразования в сумму в денежном формате. При необходимости в поле Количество разрядов можно ввести количество разрядов. Если значение не указано, все числа в денежном формате будут отображаться с двумя десятичными разрядами.

Денежный формат задаётся в системных параметрах.

### Syntax

DOLLAR(Значение; Количество разрядов)

Значение: число, ссылка на ячейку, содержащую число, или формула, возвращающая число.

Количество разрядов (необязательный параметр): количество десятичных разрядов.

### Example

=DOLLAR(255) возвращает значение $255,00.

=DOLLAR(367.456;2) возвращает значение $367,46. Используйте десятичный разделитель, соответствующий текущим параметрам языка.

## EXACT

Служит для сравнения двух текстовых строк и возвращает значение TRUE, если они совпадают. Данная функция учитывает регистр символов.

### Syntax

EXACT("Текст1"; "Текст2")

Текст1: первый текст для сравнения.

Текст2: второй текст для сравнения.

### Example

=EXACT(" microsystems";" Microsystems") возвращает значение FALSE.

## FIND

Returns the position of a string of text within another string.You can also define where to begin the search. The search term can be a number or any string of characters. The search is case-sensitive.

### Syntax

FIND("Искомый текст"; "Текст"; Позиция)

Искомый_текст: текст для поиска.

Текст: текст, в котором выполняется поиск.

Позиция (необязательный параметр): позиция в тексте, с которой начинается поиск.

### Example

=FIND(76;998877665544) возвращает значение 6.

## FIXED

Возвращает число в виде текста с указанным количеством знаков после запятой и необязательных разделителей тысяч.

### Syntax

FIXED(Число; Количество разрядов; Без разделителя)

Число: число для форматирования.

Количество_разрядов: количество десятичных разрядов для отображения.

Без_разделителя (необязательный параметр): необходимость использования разделителя разрядов. Если значение этого параметра отличается от 0, то разделитель не используется. Если значение этого параметра равно 0 или не определено, то отображается разделитель в соответствии с текущими параметрами языка.

### Example

=FIXED(1234567.89;3) возвращает значение 1 234 567,890 в виде текстовой строки.

=FIXED(1234567.89;3;1) возвращает значение 1 234 567,890 в виде текстовой строки.

## JIS

Функция JIS используется для преобразования символов ASCII и Катаканы с половинной шириной в символы с полной шириной. Возвращает текстовую строку.

See https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions for a conversion table.

### Syntax

JIS("Текст")

Текст - текст, содержащий символы для преобразования.

См. также описание функции ASC.

## LEFT

Возвращает первый символ или символы текста.

### Syntax

LEFT("Текст"; Число)

Текст: текст, для которого требуется определить аббревиатуру из начальных букв.

Число (необязательный параметр): количество символов в начальном тексте. Если этот параметр не определен, возвращается один символ.

### Example

=LEFT("вывод";3) возвращает значение “out”.

## LEFTB

Returns the first characters of a DBCS text.

### Syntax

LEFTB("Text"; Number_bytes)

Text is the text where the initial partial words are to be determined.

Number_bytes (optional) specifies the number of characters you want LEFTB to extract, based on bytes. If this parameter is not defined, one character is returned.

### Example

LEFTB("中国";1) returns " " (1 byte is only half a DBCS character and a space character is returned instead).

LEFTB("中国";2) returns "中" (2 bytes constitute one complete DBCS character).

LEFTB("中国";3) returns "中 " (3 bytes constitute one DBCS character and a half; the last character returned is therefore a space character).

LEFTB("中国";4) returns "中国" (4 bytes constitute two complete DBCS characters).

LEFTB("office";3) returns "off" (3 non-DBCS characters each consisting of 1 byte).

## LEN

Возвращает длину строки, включая пробелы.

### Syntax

LEN("Текст")

Текст: текст, длину которого требуется определить.

### Example

=LEN("Добрый день") возвращает значение 14.

=LEN(12345.67) возвращает значение 8.

## LENB

For double-byte character set (DBCS) languages, returns the number of bytes used to represent the characters in a text string.

### Syntax

LENB("Text")

Текст: текст, длину которого требуется определить.

### Example

LENB("中") returns 2 (1 DBCS character consisting of 2 bytes).

LENB("中国") returns 4 (2 DBCS characters each consisting of 2 bytes).

LENB("office") returns 6 (6 non-DBCS characters each consisting of 1 byte).

=LENB("Good Afternoon") возвращает 14.

=LENB(12345,67) возвращает 8.

## LOWER

Служит для преобразования заглавных букв в текстовой строке в строчные.

### Syntax

LOWER("Текст")

Текст: текст для преобразования.

### Example

=LOWER("Солнце") возвращает значение "солнце".

## MID

Возвращает текстовую строку текста. Параметры служат для определения начальной позиции и количества символов.

### Syntax

MID("Текст"; Начало; Число)

Текст: текст, содержащий символы для извлечения.

Начало: позиция первого символа текста для извлечения.

Число: количество символов в части текста.

### Example

=MID("office";2;2) возвращает значение ff.

## MIDB

Returns a text string of a DBCS text. The parameters specify the starting position and the number of characters.

### Syntax

MIDB("Text"; Start; Number_bytes)

Текст: текст, содержащий символы для извлечения.

Start is the position of the first character in the text to extract.

Number_bytes specifies the number of characters MIDB will return from text, in bytes.

### Example

MIDB("中国";1;0) returns "" (0 bytes is always an empty string).

MIDB("中国";1;1) returns " " (1 byte is only half a DBCS character and therefore the result is a space character).

MIDB("中国";1;2) returns "中" (2 bytes constitute one complete DBCS character).

MIDB("中国";1;3) returns "中 " (3 bytes constitute one and a half DBCS character; the last byte results in a space character).

MIDB("中国";1;4) returns "中国" (4 bytes constitute two complete DBCS characters).

MIDB("中国";2;1) returns " " (byte position 2 is not at the beginning of a character in a DBCS string; 1 space character is returned).

MIDB("中国";2;2) returns " " (byte position 2 points to the last half of the first character in the DBCS string; the 2 bytes asked for therefore constitutes the last half of the first character and the first half of the second character in the string; 2 space characters are therefore returned).

MIDB("中国";2;3) returns " 国" (byte position 2 is not at the beginning of a character in a DBCS string; a space character is returned for byte position 2).

MIDB("中国";3;1) returns " " (byte position 3 is at the beginning of a character in a DBCS string, but 1 byte is only half a DBCS character and a space character is therefore returned instead).

MIDB("中国";3;2) returns "国" (byte position 3 is at the beginning of a character in a DBCS string, and 2 bytes constitute one DBCS character).

MIDB("office";2;3) returns "ffi" (byte position 2 is at the beginning of a character in a non-DBCS string, and 3 bytes of a non-DBCS string constitute 3 characters).

## PROPER

Делает первые буквы всех слов в текстовой строке прописными.

### Syntax

PROPER("Текст")

Текст: текст для преобразования.

### Example

=PROPER("open office") возвращает значение Open Office.

## REPLACE

Заменяет отрезок текстовой строки другой текстовой строкой. Эту функцию можно использовать для замены символов и чисел (они автоматически преобразуются в текст). Результат функции всегда отображается в виде текста. Если число, преобразованное в текст, требуется использовать в дальнейших расчетах, его необходимо преобразовать в число с помощью функции VALUE.

Текст, содержащий числа, следует заключать в кавычки, чтобы он не был распознан как число и автоматически преобразован в текст.

### Syntax

REPLACE("Текст"; Позиция; Длина; "Новый текст")

Текст: текст, часть которого требуется заменить.

Позиция: начальная позиция для замены текста.

Длина: количество символов в тексте для замены.

Новый_текст: текст для замены исходного текста.

### Example

=REPLACE("1234567";1;1;"444") возвращает значение "444234567". Один символ в позиции 1 заменяется на Новый текст.

## REPT

Служит для повторения строки символов указанное количество раз.

### Syntax

REPT("Текст"; Число)

Текст: текст для повторения.

Число: количество повторений.

Максимальное количество символов в результате - 255.

### Example

=REPT("Доброе утро";2) возвращает значение "Доброе утроДоброе утро".

## RIGHT

Возвращает последний символ или символы текста.

### Syntax

RIGHT("Текст";Количество)

Текст: текст, из которого требуется извлечь правую часть.

Число (необязательный параметр): количество символов в правой части текста.

### Example

=RIGHT("Sun";2) возвращает значение "un".

## RIGHTB

Returns the last character or characters of a text with double bytes characters sets (DBCS).

### Syntax

RIGHTB("Text"; Number_bytes)

Text is the text of which the right part is to be determined.

Number_bytes (optional) specifies the number of characters you want RIGHTB to extract, based on bytes.

### Example

RIGHTB("中国";1) returns " " (1 byte is only half a DBCS character and a space character is returned instead).

RIGHTB("中国";2) returns "国" (2 bytes constitute one complete DBCS character).

RIGHTB("中国";3) returns " 国" (3 bytes constitute one half DBCS character and one whole DBCS character; a space is returned for the first half).

RIGHTB("中国";4) returns "中国" (4 bytes constitute two complete DBCS characters).

RIGHTB("office";3) returns "ice" (3 non-DBCS characters each consisting of 1 byte).

## ROMAN

Преобразует числа в римские цифры. Диапазон значений должен включать числа от 0 до 3999; режимы обозначаются целым числом от 0 до 4.

### Syntax

ROMAN(Число; Режим)

Число: число для преобразования в римскую цифру.

Режим (необязательный параметр): степень упрощения. Чем выше это значение, тем выше степень упрощения римского числа.

### Example

=ROMAN(999) возвращает значение CMXCIX.

=ROMAN(999;0) возвращает значение CMXCIX.

=ROMAN (999;1) возвращает значение LMVLIV.

=ROMAN(999;2) возвращает значение XMIX.

=ROMAN(999;3) возвращает значение VMIV.

=ROMAN(999;4) возвращает значение IM.

## SEARCH

Returns the position of a text segment within a character string. You can set the start of the search as an option. The search text can be a number or any sequence of characters. The search is not case-sensitive. If the text is not found, returns error 519 (#VALUE).

The search supports regular expressions. You can enter "all.*", for example to find the first location of "all" followed by any characters. If you want to search for a text that is also a regular expression, you must precede every character with a "\" character. You can switch the automatic evaluation of regular expression on and off in LibreOffice - PreferencesTools - Options
- LibreOffice Calc - Calculate.

### Syntax

SEARCH("Искомый текст"; "Текст"; Позиция)

Искомый_текст: текст для поиска.

Текст: текст, в котором будет выполняться поиск.

Позиция (необязательный параметр): позиция в тексте, с которой начинается поиск.

### Example

=SEARCH(54;998877665544) возвращает значение 10.

## SUBSTITUTE

Заменяет старый текст в строке на новый.

### Syntax

SUBSTITUTE("Текст"; "Найти текст"; "Новый текст"; Вхождение)

Текст: текст, в котором требуется замена сегментов.

Искомый_текст: текстовый сегмент для замены (неоднократной).

Новый_текст: текст, заменяющий текстовый сегмент.

Вхождение (необязательный параметр): случай вхождения искомого текста для замены. Если этот параметр не определен, то искомый текст заменяется во всех случаях вхождениях.

### Example

=SUBSTITUTE("123123123";"3";" abc") возвращает значение 12abc12abc12abc.

=SUBSTITUTE("123123123";"3";"abc";2) возвращает значение 12 312abc123.

## T

Эта функция возвращает целевой текст либо пустую текстовую строку, если целевая ячейка не содержит текста.

### Syntax

T(Значение)

Если Значение является текстовой строкой или ссылкой на текстовую строку, T возвращает эту текстовую строку; в противном случае возвращается пустая текстовая строка.

### Example

=T(12345) возвращает пустую строку.

=T("12345") возвращает строку 12345.

## TEXT

Преобразует число в текст в соответствии с заданным форматом.

### Syntax

TEXT(Число; Формат)

Число: численное значение для преобразования.

Формат: текст для определения формата. Используйте разделители разрядов в соответствии с параметром языка, установленным для формата ячейки.

### Example

=TEXT(12.34567;"###,##") возвращает текст 12,35.

=TEXT(12.34567;"000.00") возвращает текст 012,35.

See also Number format codes: custom format codes defined by the user.

## TRIM

Служит для удаления пробелов перед строкой или для выравнивания содержимого ячейки по левому краю.

### Syntax

TRIM("Текст")

Text refers to text in which spaces are to be removed.

### Example

=TRIM(" hello world ") returns hello world without leading and trailing spaces and with single space between words.

## UNICHAR

Преобразование кодового номера в символ Unicode или букву.

### Syntax

UNICHAR(number)

### Example

=UNICHAR(169) возвращает символ авторских прав ©.

See also the UNICODE() function.

## UNICODE

Возвращает числовой код первого символа Unicode в текстовой строке.

### Syntax

UNICODE("Text")

### Example

=UNICODE("©") возвращает код 169, соответствующий символу авторских прав.

See also the UNICHAR() function.

## UPPER

Служит для преобразования букв строки в поле текст в прописные.

### Syntax

UPPER("Текст")

Текст: строчные буквы, которые требуется преобразовать в прописные.

### Example

=UPPER("Доброе утро") возвращает значение ДОБРОЕ УТРО.

## VALUE

Служит для преобразования текстовой строки в число.

### Syntax

VALUE("Текст")

Текст: текст для преобразования в число.

### Example

=VALUE("4321") возвращает значение 4321.

См. также

Functions by Category