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.

UNICHAR

Converts a code number into a Unicode character or letter.

Syntax

UNICHAR(number)

Example

=UNICHAR(169) returns the Copyright character ©.

tip

See also the UNICODE() function.


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.

Format формат.

Example

=TEXT(12.34567;"###.##") returns the text 12.35

=TEXT(12.34567;"000.00") returns the text 012.35

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

tip

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


LENB

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

tip

This function is available since LibreOffice 4.2.


Syntax

LENB("Text")

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") returns 14.

=LENB(12345.67) returns 8.

REPLACE

Replaces part of a text string with a different text string. This function can be used to replace both characters and numbers (which are automatically converted to text). The result of the function is always displayed as text. If you intend to perform further calculations with a number which has been replaced by text, you will need to convert it back to a number using the VALUE function.

Матни рақамдоштаро дар нохунак гиред, то кӣ рақам ба матн табдил наёбад.

Syntax

REPLACE("Text"; Position; Length; "NewText")

Text матни қисмаш ивазшаванда.

position мавқеъи ивазкунӣ.

length шумораи рамзҳои ивазшавандаи матн.

new text матни нав, ки ба матни ивазшаванда дохил мешавад .

Example

REPLACE("1234567";1;1;"444") натиҷа "444234567". Як рамз дар ҷаи 1 бо матни нав пурра иваз мешавад.

FIXED

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

Syntax

FIXED(Number; Decimals [; NoThousandsSeparators])

Number рақам.

Decimals шумораи ададҳои каср.

No thousands separators (ихтиёрӣ) нишон додан ё надодани ҷудокунаки ҳазорҳоро муайян мекунад. Агар рақам нобаробари 0 бошад онгоҳ нишон дода намешавад, вагарна аз ҷӯрсозиҳои система истифода карда мешавад ҷӯрсозиҳои ҷории система.

Example

FIXED(1234567.89;3) натиҷа 1,234,567.890 ҳамчун сатри матнӣ.

FIXED(1234567.89;3;1) натиҷа 1234567.890 ҳамчун сатри матнӣ.

MIDB

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

tip

This function is available since LibreOffice 4.2.


Syntax

MIDB("Text"; Start; Number_bytes)

text матн.

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

MID

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

Syntax

MID("Text"; Start; Number)

text матн.

startмавқеъ.

number шумораи рамзҳо.

Example

MID("Sun Microsystems";5;5) натиҷа Micro.

LEFT

Returns the first character or characters of a text.

Syntax

LEFT("Text" [; Number])

text матн.

Number (ихтиёрӣ) шумораи рамзҳо аз аввал.

Example

LEFT("output";3) натиҷа out.

LEFTB

Returns the first characters of a DBCS text.

tip

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

RIGHTB

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

tip

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

RIGHT

Returns the last character or characters of a text.

Syntax

RIGHT("Text" [; Number])

textматн.

number (ихтиёрӣ) шумораи рамзҳо аз рост.

Example

RIGHT("Sun";2) натиҷа un.

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])

find_text матни ёфтшаванда.

text матни ҷустуҷӯшаванда.

position (ихтиёрӣ) мавқеи сар кардани ҷустуҷӯ.

Example

FIND(76;998877665544) натича 6.

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 Calc - Calculate.

warning

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])

find_text матни ҷустуҷӯшаванда.

text Матне, ки дар он ҷустуҷӯ гузаронида мешавад.

position (ихтиёрӣ) мавқеи оғози ҷустуҷӯ.

Example

SEARCH(54;998877665544) натиҷа 10.

ASC

The ASC function converts full-width to half-width ASCII and katakana characters. Returns a text string.

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

Syntax

ASC("Text")

Text is the text that contains characters to be converted.

See also JIS function.

JIS

The JIS function converts half-width to full-width ASCII and katakana characters. Returns a text string.

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

Syntax

JIS("Text")

Text is the text that contains characters to be converted.

See also ASC function.

T

This function returns the target text, or a blank text string if the target is not text.

Syntax

T(Value)

If Value is a text string or refers to a text string, T returns that text string; otherwise it returns a blank text string.

Example

T(12345) натиҷа сатри холӣ "".

T("12345") натиҷа сатри 12345.

ARABIC

Арзиши рақами Римиро ҳисоб мекунад. Арзиш бояд дар фосилаи 0 ва 3999 бошад.

Syntax

ARABIC("Text")

Text матне, ки рақами Римиро ифода мекунад.

Example

ARABIC("MXIV") натиҷа 1014

ARABIC("MMII") натиҷа 2002

LEN

Дарозии сатрро бо холигиҳо медиҳад.

Syntax

LEN("Text")

text матн.

Example

LEN("Good Afternoon") натиҷа 14.

LEN(12345.67) натиҷа 8.

EXACT

Ду матнро санҷида ҲАҚҚОНӢ бармегардонад агар онҳо якхела бошанд. Ин фуктсия ҳарфҳои хурду калонро фарқ мекунад.

Syntax

EXACT("Text1"; "Text2")

text_1 матни аввал.

text_2 матни дуюм.

Example

EXACT("Sun microsystems";"Sun Microsystems") натиҷа ҚАЛБАКӢ.

CODE

Коди рақамии рамзи аввали матнро бармегардонад.

Syntax

CODE("Text")

Text матн.

Codes greater than 127 may depend on your system's character mapping (for example iso-8859-1, iso-8859-2, Windows-1252, Windows-1250), and hence may not be portable.

Example

CODE("Hieronymus") натиҷа 72, CODE("hieroglyphic") натиҷа 104.

note

Коди дар ин ҷой истифодашуда ба ASCII дахл надорад, балки ба коди истифодашудаистода.


UNICODE

Коди рақамии рамзи аввали матнро бармегардонад.

Syntax

UNICODE("Text")

Example

=UNICODE("©") returns the Unicode number 169 for the Copyright character.

tip

See also the UNICHAR() function.


DECIMAL

Матнро бо рамзҳои системаи рақамӣ ба рақами мутлақ табдил медиҳад. Radix аз 2 то 36 шуда метавонад. Space ва tab инкор карда мешаванд. матн аз ҳарфи хурду калон вобаста нест.

Агар радикс ба 16 баробар бошад, x, X, 0x ё 0X дар аввал, ва h ё H -и изофашуда ба инрбат гирифта намешаванд. Агар радикс баробари 2 бошад, b ё B-и изофашуда ба инобат гирифта намешавад. Дигар рамзҳо, ки ба системаи рақамӣ таалуқ надоранд хато ҳосил мекунанд.

Syntax

DECIMAL("Text"; Radix)

text матн. Барои фарқ кардани матн аз системаи шонздаҳӣ матнро дар нохунак гиред.

radix асоси системаи рақамӣ. Рақами мусбати аз 2 то 36.

Example

DECIMAL("17";10) натиҷа 17.

DECIMAL("FACE";16) натиҷа 64206.

DECIMAL("0101";2) натиҷа 5.

BASE

Рақами мусбатро ба матн табдил медиҳад аз системаи рақамӣ. Рақамҳои 0-9 ва ҳарфҳои A-Z истифода мешаванд.

Syntax

BASE(Number; Radix [; MinimumLength])

number рақами мусбат, ки табдил дода мешавад.

radix асоси системаи рақамӣ. Рақами мусбати аз 2 то 36.

Minimum length (ихтиёрӣ) дарозии хурдтарини давомнокии рамзҳоро муайян месозад. Агар матн аз ин рақам хурд бошад, онгоҳ сифрҳо дар чапи он илова карда мешаванд.

Example

BASE(17;10;4) натиҷа 0017 дар ченаки даҳҳӣ.

BASE(17;2) натиҷа 10001 дар системаи дуӣ (бинарӣ).

BASE(255;16;4) натиҷа 00FF дар системаи шонздаҳӣ.

ROMAN

Рақамро ба Римӣ табдил медиҳад. Арзиш аз 0 то 3999 шуданаш мумкин, режим аз 0 то 4.

Syntax

ROMAN(Number [; Mode])

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

DOLLAR

Рақамро ба арз табдил медиҳад, ки ба миқдори гуфташуда бутун карда шудааст. Дар майдони арзиш рақамро дохил кунед то ба арз табдил дода шавад. Ихтиёри метавонед рақами баъдикасриро лохил кунед дар майдоникасрӣ. Агар ин арзиш рабошад ду адади баъдикасрӣ истифода мешавад.

Формати арзиро дар системаатон ҷӯр созед.

Syntax

DOLLAR(Value [; Decimals])

valueрақам, шавола ба чашмак, ки рақами табдилшаванда дорад.

decimals рақами ихтиёрии баъдикасрӣ.

Example

DOLLAR(255) натиҷа $255.00.

DOLLAR(367.456;2) натиҷа $367.46. Ҷудокунаки касриро мувофиқи Ҷӯрсозиҳои ҷории система гузоред.

CHAR

Рақамро ба ҳарф табдил медиҳад мувофиқи ҷадвали код. Рақам бояд ду ё серақама бошад.

Codes greater than 127 may depend on your system's character mapping (for example iso-8859-1, iso-8859-2, Windows-1252, Windows-1250), and hence may not be portable.

Syntax

YEAR(рақам)

numberрақам аз 1 то 255, ки коди ҳарфро ифода мекунад.

Example

CHAR(100) натиҷа "d".

="abc" & CHAR(10) & "def" inserts a newline character into the string.

BAHTTEXT

Рақамро бо ҳарфҳои Тайи менависад бо иловаи арз.

Syntax

BAHTTEXT(Number)

Number ягон рақам. "Baht" ба қисми бутуни рақам ва "Satang" ба қисми касрии рақам ҳамроҳ карда мешаванд.

Example

BAHTTEXT(12.65) сатрро ба забони Тайи, ки маънои "Дувоздаҳ Баҳт ва шасту панҷ сатанг"ро дорад.

UPPER

Сатри дар майдониtext бударо ба ҳарфи калон табдил медиҳад.

Syntax

UPPER("Text")

textматн, ки дар он амал иҷро мешавад.

Example

UPPER("Good Morning") натиҷа GOOD MORNING.

VALUE

Сатри матниро ба рақам табдил медиҳад.

Syntax

DATEVALUE("Матн")

text матни табдилшаванда.

Example

VALUE("4321") натиҷа 4321.

SUBSTITUTE

Сатри навро ба қисми матни кӯҳна иваз месозад.

Syntax

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

text матне, ки дар он қисмаш иваз карда мешавад.

search_text сегменти матн, ки иваз карда мешавад.

new text матне, ки гузошта мешавад.

пайдоиш (ихтиёрӣ) муайян месозад, ки кадом пайдоиши матни чустуҷӯ иваз карда шавад. Агар ин параметр гузошта нашуда бошад, онгоҳ саросар иваз карда мешавад.

Example

SUBSTITUTE("123123123"; "3"; "abc") натиҷа 12abc12abc12abc.

SUBSTITUTE("123123123"; "3"; "abc"; 2) натиҷа 12312abc123.

REPT

Сатрро ба шумораи додашуда такрор мекунад .

Syntax

REPT("Text"; Number)

text матни ивазшаванда.

number шумораи такроркунӣ.

Натича метавонад то255 рамз бошад.

Example

REPT("Good morning"; 2) натиҷаGood morningGood morning.

TRIM

Холигиҳоро аз матнро кӯр карда, танҳо як холигӣ миёни калимаҳо мегузорад.

Syntax

TRIM("Text")

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.

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("Субҳ ";"Бахайр ";"Хонум. ";"Моҳира") натиҷа Субҳ Бахайр Хонум Моҳира.

CLEAN

Ҳама рамзҳои чопнашаванда аз сатр бароварда мешаванд.

Syntax

CLEAN("Text")

text матн.

LOWER

Ҳама ҳарфҳои калонро ба хурд табдил медиҳад.

Syntax

LOWER("Text")

text матн.

Example

RIGHT("Sun";2) натиҷа un.

PROPER

Ҳарфи аваали ҳар калимаро калон мегардонад.

Syntax

PROPER("Text")

text матн.

Example

=PROPER("the document foundation") returns The Document Foundation.

Please support us!