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

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(Number; Radix [; MinimumLength])

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

Основание: основание системы счисления. Это может быть любое положительное целое число от 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("Текст")

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

#### Example

=LEN(CLEAN(CHAR(7) & "LibreOffice Calc" & CHAR(8))) returns 16, showing that the CLEAN function removes the non-printable Unicode U+0007 ("BEL") and U+0008 ("BS") characters at the beginning and end of the string argument. CLEAN does not remove spaces.

## 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(String 1 [; String 2 [; … [; String 255]]])

String 1[; String 2][; … ;[String 255]] are strings or references to cells containing strings.

#### 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(Value [; Decimals])

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

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

#### Example

=DOLLAR(255) returns $255.00 for the English (USA) locale and USD (dollar) currency; ￥255.00 for the Japanese locale and JPY (yen) currency; or 255,00 € for the German (Germany) locale and EUR (euro) currency.

=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("FindText"; "Text" [; Position])

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

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

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

#### Example

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

## FIXED

Returns a number as text with a specified number of decimal places and optional thousands separators.

#### Syntax

FIXED(Number; [Decimals = 2 [; NoThousandsSeparators = FALSE]])

Number is rounded to Decimals places (after the decimal separator) and the result formatted as text, using locale-specific settings.

Decimals (optional) refers to the number of decimal places to be displayed. If Decimals is negative, Number is rounded to ABS(Decimals) places to the left from the decimal point. If Decimals is a fraction, it is truncated actually ignoring what is the closest integer.

NoThousandsSeparators (optional) determines whether the thousands separator is used. If it is TRUE or non-zero, then group separators are omitted from the resulting string. If the parameter is equal to 0 or if it is missing altogether, the thousands separators of your current locale setting are displayed.

#### Example

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

=FIXED(123456.789;;TRUE) returns 123456.79 as a text string.

=FIXED(12345.6789;-2) returns 12,300 as a text string.

=FIXED(12134567.89;-3;1) returns 12135000 as a text string.

=FIXED(12345.789;3/4) returns 12,346 as a text string.

=FIXED(12345.789;8/5) returns 12,345.8 as a text string.

## JIS

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

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

#### Syntax

JIS("Текст")

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

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

## LEFT

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

#### Syntax

LEFT("Text" [; Number])

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

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

#### Example

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

## LEFTB

Returns the first characters of a DBCS text.

This function is available since LibreOffice 4.2.

#### 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.

This function is available since LibreOffice 4.2.

#### 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.

This function is available since LibreOffice 4.2.

#### 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("the document foundation") returns The Document Foundation.

## REPLACE

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

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

#### Syntax

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

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

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

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

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

#### Example

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

## REPT

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

#### Syntax

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

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

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

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

#### Example

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

## RIGHT

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

#### Syntax

RIGHT("Text" [; Number])

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

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

#### Example

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

## RIGHTB

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

This function is available since LibreOffice 4.2.

#### 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(Number [; Mode])

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

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

#### 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 wildcards or regular expressions. With regular expressions enabled, 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 either precede every character with a "\" character, or enclose the text into \Q...\E. You can switch the automatic evaluation of wildcards or regular expression on and off in LibreOffice - PreferencesTools - Options - LibreOffice Calc - Calculate.

When using functions where one or more arguments are search criteria strings that represents a regular expression, the first attempt is to convert the string criteria to numbers. For example, ".0" will convert to 0.0 and so on. If successful, the match will not be a regular expression match but a numeric match. However, when switching to a locale where the decimal separator is not the dot makes the regular expression conversion work. To force the evaluation of the regular expression instead of a numeric expression, use some expression that can not be misread as numeric, such as ".[0]" or ".\0" or "(?i).0".

#### Syntax

SEARCH("FindText"; "Text" [; Position])

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

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

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

#### Example

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

## SUBSTITUTE

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

#### Syntax

SUBSTITUTE("Text"; "SearchText"; "NewText" [; Occurrence])

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

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

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

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

#### Example

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

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

## T

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

#### Syntax

T(Значение)

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

#### Example

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

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

## TEXT

Converts a value into text according to a given format.

#### Syntax

TEXT(Value; Format)

Value is the value (numerical or textual) to be converted.

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

#### Example

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

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

=TEXT("xyz";"=== @ ===") returns the text === xyz ===

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.

См. также

Функции по категориям