Text Functions

This section contains descriptions of the Text functions.

Por atingi ĉi tiun komandon...

Enmeti - Funkcion - Kategorio Teksto


Using double quotation marks in formulas

To include a text string in a formula, place the text string between two double quotation marks (") and Calc takes the characters in the string without attempting to interpret them. For example, the formula ="Hello world!" displays the text string Hello world! in the cell, with no surrounding double quotation marks.

The more complex formula =CONCATENATE("Life is really simple, "; "but we insist on making it complicated "; "(Confucius).") concatenates three individual strings in double quotation marks, outputting Life is really simple, but we insist on making it complicated (Confucius).

To place a literal double quotation mark within a string inside a formula, two methods can be used:

  1. You can "escape" the double quotation mark with an additional double quotation mark, and Calc treats the escaped double quotation mark as a literal value. For example, the formula ="My name is ""John Doe""." outputs the string My name is "John Doe". Another simple example is the formula =UNICODE("""") which returns 34, the decimal value of the Unicode quotation mark character (U+0022) — here the first and fourth double quotation marks indicate the beginning and end of the string, while the second double quotation mark escapes the third.

  2. You can use the CHAR function or the UNICHAR function to insert a double quotation mark. For example, the formula =UNICHAR(34) & "The Catcher in the Rye" & UNICHAR(34) & " is a famous book by J. D. Salinger." displays the string "The Catcher in the Rye" is a famous book by J. D. Salinger.

Be aware that Calc's AutoCorrect function may modify double quotation marks. AutoCorrect should not change the double quotation marks within formula cells but may change those used in non-formula cells containing text. For example, if you copy a string that is surrounded by some other form of typographical double quotation marks, such as the left double quotation mark (U+201C) and the right double quotation mark (U+201D), and then paste into a formula cell, an error may result. Open the Double Quotes area of the Tools - AutoCorrect Options - Localized Options dialog to set the characters used to automatically correct the start and end typographical double quotation marks. Uncheck the Replace toggle button to disable the feature.

ARABIC

Returns the numeric value corresponding to a Roman number expressed as text.

ASC

Converts double-byte (full-width) characters to single-byte (half-width) ASCII and katakana characters.

JIS

Converts single-byte (half-width) ASCII or katakana characters to double-byte (full-width) characters.

REGEX

Matches and extracts or optionally replaces text using regular expressions.

ROMAN

Converts a number into a Roman numeral. The value range must be between 0 and 3999. A simplification mode can be specified in the range from 0 to 4.

VALUE

Converts the string representation of a number to numeric form. If the supplied string is a valid date, time, or date-time, the corresponding date-time serial number is returned.

WEBSERVICE

Get some web content from a URI.

FILTERXML

Apply a XPath expression to a XML document.

ENCODEURL

Returns a URL-encoded string.

ANSTATAŬIGI

Anstataŭigas parton de teksto per alia teksto. Ĉi tiu funkcio estas uzebla por anstataŭigi kaj signojn kaj ciferojn (kiujn ĝi aŭtomate konvertas al teksto). La rezulto de la funkcio ĉiam vidiĝas kiel teksto. Se vi intencas fari pluajn kalkulojn al numero jam anstataŭigita de teksto, necesas rekonverti ĝin al numero per la funkcio VALORO.

Teksto kiu enhavas ciferojn devas esti en citiloj se vi ne deziras ke la funkcio interpretu ĝin kiel numeron kaj aŭtomate konverti ĝin al teksto.

Sintakso

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

Teksto estas la teksto, de kiu parto estas anstataŭigota.

Position refers to the position within the text where the replacement will begin.

Length is the number of characters in Text to be replaced.

NewText refers to the text which replaces Text.

Ekzemplo

=REPLACE("1234567";1;1;"444") returns "444234567". One character at position 1 is replaced by the complete NewText.

ANSTATAŬIGI

Anstataŭigas malnovan tekston en ĉeno per nova teksto.

Sintakso

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

Text is the text in which text segments are to be exchanged.

SearchText is the text segment that is to be replaced (a number of times).

NewText is the text that is to replace the text segment.

Occurrence (optional) indicates which occurrence of the search text is to be replaced. If this parameter is missing the search text is replaced throughout.

Ekzemplo

=SUBSTITUTE("123123123";"3";"abc") returns 12abc12abc12abc.

=SUBSTITUTE("123123123";"3";"abc";2) returns 12312abc123.

BAHTTEKSTO

Konvertas numeron al taja teksto, inkluzive la tajajn valutonomojn.

Sintakso

BAHTTEXT(Number)

Number is any number. "Baht" is appended to the integral part of the number, and "Satang" is appended to the decimal part of the number.

Ekzemplo

=BAHTTEXT(12.65) returns a string in Thai characters with the meaning of "Twelve Baht and sixty five Satang".

Technical information

This function is not part of the Open Document Format for Office Applications (OpenDocument) Version 1.3. Part 4: Recalculated Formula (OpenFormula) Format standard. The name space is

COM.MICROSOFT.BAHTTEXT

BAZO

Converts a positive integer to a specified base into a text from the numbering system. The digits 0-9 and the letters A-Z are used.

Sintakso

BASE(Number; Radix [; MinimumLength])

Numero estas la numero formatota.

Radix indicates the base of the numeral system. It may be any positive integer between 2 and 36.

MinimumLength (optional) determines the minimum length of the character sequence that has been created. If the text is shorter than the indicated minimum length, zeros are added to the left of the string.

Ekzemplo

=BAZ8AL16(144;4) liveras je 0064.

=BAZ8AL16(144;4) liveras je 0064.

=BAZ8AL16(144;4) liveras je 0064.

See also

DECIMAL

DEKSTRAJ

Liveras la lasta(j)n signon aŭ signojn de teksto.

Sintakso

RIGHT("Text" [; Number])

Valoro estas la valoro, kies rango estas komputota.

Number (optional) is the number of characters from the right part of the text. If this parameter is not defined, one character is returned.

Ekzemplo

DEKSTRAJ("Suno";2) liveras je no.

DEKUMA

Converts text that represents a number in a numeral system with the given base radix to a positive integer. The radix must be in the range 2 to 36. Spaces and tabs are ignored. The Text field is not case-sensitive.

If the radix is 16, a leading x or X or 0x or 0X, and an appended h or H, are disregarded. If the radix is 2, an appended b or B is disregarded. Other characters that do not belong to the numeral system generate an error.

Sintakso

DECIMAL("Text"; Radix)

Text is the text to be converted.

Radix indicates the base of the numeral system. It may be any positive integer between 2 and 36.

Ekzemplo

=IMREEL("1+3j") liveras je 1.

=IMREEL("1+3j") liveras je 1.

=IMREEL("1+3j") liveras je 1.

See also

BASE

DOLARO

Converts a number to a string representing the amount in the currency format, rounded to a specified decimal places, using the decimal separator that corresponds to the current locale setting. In the Value field enter the number to be converted. Optionally, you may enter the number of decimal places in the Decimals field. If no value is specified, all numbers in currency format will be displayed with two decimal places.

Vi agordas la valutan formaton en viaj sistemaj agordoj.

Sintakso

DOLLAR(Value [; Decimals])

Value is a number, a reference to a cell containing a number, or a formula which returns a number.

Decimals is the optional number of decimal places.

Ekzemplo

=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) returns $367.46.

EKZAKTA

Komparas du ĉenojn kaj liveras je TRUE se ili estas identaj. Ĉi tiu funkcio estas usklodistinga.

Sintakso

EXACT("Text1"; "Text2")

Numero estas la numero formatota.

Numero estas la numero formatota.

Ekzemplo

=EXACT("microsystems";"Microsystems") returns FALSE.

FIKSITA

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

Sintakso

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.

Ekzemplo

=FIXED(1234567.89;3) returns 1,234,567.890 as a text string.

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

KODO

Liveras numeran kodon por la unua signo en teksta ĉeno.

Sintakso

CODE("Text")

Teksto estas la teksto por kiu liveri la kodon de la unua signo.

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.

Ekzemplo

=CODE("Hieronymus") returns 72, =CODE("hieroglyphic") returns 104.

note

La kodo uzenda estas tiu de la koda tabelo aktuale ŝargita, ne al la ASKII-kodo.


KROĈI

Kunigas plurajn tekstajn ĉenojn en unu ĉenon.

Sintakso

CONCATENATE(String 1 [; String 2 [; … [; String 255]]])

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

Ekzemplo

=CONCATENATE("Good ";"Morning ";"Mrs. ";"Doe") returns: Good Morning Mrs. Doe.

LEFTB

Liveras la unuajn signojn de DBCS-teksto.

tip

Ĉi tiu funkcio disponeblas ekde versio 4.2 de LibreOffice.


Sintakso

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.

Ekzemplo

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

LENB

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

tip

Ĉi tiu funkcio disponeblas ekde versio 4.2 de LibreOffice.


Sintakso

LENB("Text")

Valoro estas la valoro, kies rango estas komputota.

Ekzemplo

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.

LONGO

Liveras la longon de ĉeno, inkluzive spacetojn.

Sintakso

LEN("Text")

Valoro estas la valoro, kies rango estas komputota.

Ekzemplo

=IMREEL("1+3j") liveras je 1.

=IMREEL("1+3j") liveras je 1.

MAJUSKLIGI

Konvertas la ĉenon specifitan en la kampo teksto al majuskloj.

Sintakso

UPPER("Text")

Text refers to the lower case letters you want to convert to upper case.

Ekzemplo

=UPPER("Good Morning") returns GOOD MORNING.

MAJUSKLIGI.INICIALOJN

Majuskligas la unuan literon de ĉiu vorto en ĉeno.

Sintakso

PROPER("Text")

Numero estas la numero formatota.

Ekzemplo

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

MALDEKSTRAJ

Liveras la unuan signon aŭ signojn de teksto.

Sintakso

LEFT("Text" [; Number])

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

numero (malnepra) specifas la nombron da signoj por la komenca teksto. Se tiu parametro ne estas difinita, liveras unu signon.

Ekzemplo

=BAZ8AL2(3;3) liveras je 011.

MEZO

Liveras ĉenon da teksto. La parametroj agordas la komencan pozicion kaj la nombron da signoj.

Sintakso

MID("Text"; Start; Number)

Text is the text containing the characters to extract.

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

Number specifies the number of characters in the part of the text.

Ekzemplo

=IMABS("5+12j") liveras je 13.

MIDB

Liveras ĉenon de teksto de DBCS-teksto. La parametroj agordas la komencan pozicion kaj la nombron da signoj.

tip

Ĉi tiu funkcio disponeblas ekde versio 4.2 de LibreOffice.


Sintakso

MIDB("Text"; Start; Number_bytes)

Text is the text containing the characters to extract.

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.

Ekzemplo

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

MINUSKLIGI

Konvertas ĉiujn majusklojn en ĉeno al minuskloj.

Sintakso

LOWER("Text")

Numero estas la numero formatota.

Ekzemplo

=MINUSKLIGI("Suno") liveras je suno.

PURIGI

All non-printing characters are removed from the string.

Sintakso

CLEAN("Text")

Text refers to the text from which to remove all non-printable characters.

Ekzemplo

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

RIGHTB

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

tip

Ĉi tiu funkcio disponeblas ekde versio 4.2 de LibreOffice.


Sintakso

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. If this parameter is not defined, one byte is returned.

Ekzemplo

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

RIPETI

Ripetas ĉenon laŭ specifita nombro da fojoj.

Sintakso

REPT("Text"; Number)

Numero estas la numero formatota.

Numero estas la valoro de la funkcio.

Ekzemplo

=REPT("Good morning";2) returns Good morningGood morning.

tip

Refer to the REPT wiki page for more details about this function.


SERĈI

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.

Sintakso

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

Numero estas la numero formatota.

Text is the text where the search takes place.

Position (optional) is the position in the text from which the search starts.

Ekzemplo

=FIND(76;998877665544) returns 6.

SERĈO

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 regular expression metacharacter or operator 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

Kiam vi uzas funkciojn kie unu aŭ pliaj argumentoj estas serĉaj kriterioj kiuj prezentas regulan esprimon, la unua provo estas konverti la kriterion al numeroj. Ekzemple, ".0" konvertiĝos al 0.0 kaj tiel plu. Se sukcesas, la kongruo ne estos regulesprima kongruo sed numera kongruo. Tamen, ŝalti al lokaĵaro kie la dekuma apartigilo ne estas punkto, funkciigas la regulespriman konverton. Por devigi kalkuli regulan esprimon anstataŭ numeran esprimon, uzu esprimon kiu ne estas mislegebla kiel numera, ekzemple ".[0]" aŭ ".\0" aŭ "(?i).0".


Sintakso

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

Numero estas la numero formatota.

Text is the text where the search will take place.

Position (optional) is the position in the text where the search is to start.

Ekzemplo

=SEARCH(54;998877665544) returns 10.

SIGNO

Konvertas nombron al signo laŭ la aktuala koda tabelo. La nombro povas esti ducifera aŭ tricifera.

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.

Sintakso

FI(Numero)

Number is a number between 1 and 255 representing the code value for the character.

Ekzemplo

=CHAR(100) returns the character d.

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

STUCI

Forigas spacetojn el ĉeno, lastante nur unu spaceton inter vortoj

Sintakso

TRIM("Text")

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

Ekzemplo

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

T

Ĉi tiu funkcio liveras la celan tekston, aŭ malplenan ĉenon se la celo ne estas teksto.

Sintakso

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.

Ekzemplo

=T(12345) returns an empty string.

=T("12345") returns the string 12345.

TEKSTO

Converts a value into text according to a given format.

Sintakso

TEXT(Value; Format)

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

Formato estas la teksto kiu agordas la formaton. Uzu disigilojn decimalajn kaj de miloj laŭ la lingvo agordita en la ĉela formato.

Ekzemplo

=TEKSTO(12,34567;"###.##") liveras la tekston 12,35

=TEKSTO(12,34567;"000.00") liveras la tekston 012,35

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

tip

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


UNICHAR

Converts a code number into a Unicode character or letter.

Sintakso

UNICHAR(number)

Ekzemplo

=UNICHAR(169) returns the Copyright character ©.

tip

See also the UNICODE() function.


UNICODE

Liveras numeran kodon por la unua unikoda signo en teksta ĉeno.

Sintakso

UNICODE("Text")

Ekzemplo

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

tip

See also the UNICHAR() function.


Bonvolu subteni nin!