Contido

# Funcións de texto

This section contains descriptions of the Text functions.

Para acceder a esta orde...

Inserir - Función, categoría Texto

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

## BASE

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.

#### Sintaxe

BASE(Número; Base [;LonxitudeMínima])

N é o número enteiro positivo a ser convertido.

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

MinimumLength (opcional) determina a lonxitude mínima da secuencia de caracteres que se creou. Se o texto é máis curto que o longo mínimo indicado, os ceros son engadidos á esquerda da cadea.

#### Exemplo

= BASE (17; 10; 4) dá 0017 no sistema decimal.

= BASE (17, 2) dá 10001 no sistema binario.

= BASE (255; 16; 4) dá 00FF no sistema hexadecimal.

#### See also

DECIMAL

## CAMBIARTEXTO

Substitúe un texto novo por un texto antigo nunha cadea de caracteres.

#### Sintaxe

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

Texto é o texto en que segmentos de texto deben ser trocados.

searchText é o segmento de texto que debe ser substituído (varias veces).

newText é o texto que debe substituír o segmento de texto.

Aparición (opcional) indica que a aparición do texto de busca é que ser substituído. Se ese parámetro falta o texto de busca é substituído por todas partes.

#### Exemplo

= Suplente (\ "123123123";"3";"abc") dá 12abc12abc12abc.

= Suplente (\ "123123123";"3";"abc"; 2) dá 12312abc123.

## CARACT

Converte un número nun carácter de acordo coa táboa de código actual. O número pode ser un número enteiro de dous díxitos ou tres díxitos.

Os códigos maiores de 127 poden depender do mapa de caracteres do sistema (por exemplo, iso-8859-1, iso-8859-2, Windows-1252, Windows-1250) e, por este motivo, poden non ser portábeis.

#### Sintaxe

CARACT(Número)

Número é un número entre 1 e 255 que representa o valor de código do carácter.

#### Exemplo

= CHAR (100) devolve o carácter d.

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

## CONCATENAR

Combina varios secuencias de texto nunha cadea.

#### Sintaxe

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

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

#### Exemplo

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

## CÓDIGO

Devolve un código numérico correspondente ao primeiro carácter dunha cadea de caracteres de texto.

#### Sintaxe

CÓDIGO("texto")

Texto é o texto para o cal se debe atopar o código do primeiro carácter.

Os códigos maiores de 127 poden depender do mapa de caracteres do sistema (por exemplo, iso-8859-1, iso-8859-2, Windows-1252, Windows-1250) e, por este motivo, poden non ser portábeis.

#### Exemplo

= CÓDIGO (\ "Hieronymus") dá 72, = CÓDIGO (\ "\ xeroglífica") retorno 104.

O código utilizado aquí non se refire a ASCII, mais a táboa de código cargado no momento.

## DECIMAL

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.

#### Sintaxe

Decimal (\ "Texto"; 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.

#### Exemplo

=DECIMAL("17";10) dá 17.

= decimal (\ "CARA"; 16) dá 64.206.

=DECIMAL("0101";2) dá 5.

#### See also

BASE

## DEREITA

Devolve o derradeiro carácter ou caracteres dun texto.

#### Sintaxe

DEREITA("Texto"; [;Número])

Texto é o texto do cal a parte dereita é para ser determinado.

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

#### Exemplo

=DEREITA("Sun";2) devolve un.

## DEREITAB

Devolve o último carácter ou caracteres dun texto co dobre personaxes bytes conxuntos (DBCS).

Esta función está dispoñíbel desde a versión 4.2 do LibreOffice.

#### Sintaxe

DEREITAB ("Texto" [; Número_bytes])

Texto é o texto do cal a parte dereita é para ser determinado.

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.

#### Exemplo

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

LenB (\ "oficina") Devolve 6 (seis caracteres non DBCS cada unha composta por un byte).

## ESQUERDA

Devolve o primeiro carácter ou primeiros caracteres dun texto.

#### Sintaxe

ESQUERDA("Texto" [; Número])

Texto é o texto en que as palabras parciais iniciais deben ser determinadas.

Número (opcional) indica o número de caracteres para o texto inicial. Se este parámetro non é definido, un carácter é de retorno.

#### Exemplo

= LEFT (\ "saída"; 3) retorno "out".

## ESQUERDAB

Devolve os primeiros caracteres dun texto DBCS.

Esta función está dispoñíbel desde a versión 4.2 do LibreOffice.

#### Sintaxe

ESQUERDAB("Texto" [;Número_bytes])

Texto é o texto en que as palabras parciais iniciais deben ser determinadas.

Number_bytes (opcional) indica o número de caracteres que quere LeftB para extraer, con base en bytes. Se este parámetro non é definido, un carácter é de retorno.

#### Exemplo

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

## EXACTO

Compara dúas secuencias de texto e devolve VERDADEIRO se son idénticos. Esta función distingue entre maiúsculas e minúsculas.

#### Sintaxe

EXACT("Text1"; "Text2")

Text1 refírese ao primeiro texto para comparar.

text2 é o segundo texto para comparar.

#### Exemplo

= exacto (\ "microssistemas";"Microsystems") dá FALSE.

## FIXO

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

#### Sintaxe

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.

#### Exemplo

= FIXO (1.234.567,89; 3) dá 1,234,567.890 como unha cadea de texto.

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

## LIMPAR

Todos os caracteres non imprimibles elimínanse da cadea.

#### Sintaxe

CLEAN("texto")

Texto refírese ao texto de partida para eliminar todos os caracteres non imprimibles.

#### Exemplo

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

## LOCALIZAR

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.

#### Sintaxe

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

FindText refírese ao texto a atopar.

Texto é o texto en que a investigación ocorre.

Posición (opcional) é a posición no texto a partir do cal a investigación comeza.

#### Exemplo

= find (76; 998.877.665.544) 6 retorno.

## LONX

Devolve a lonxitude dunha cadea, incluíndo espazos.

#### Sintaxe

LONX («Texto»)

text é o texto cuxa lonxitude é para ser determinada.

#### Exemplo

= LEN (\ "Boa Tarde") dá 14.

=LEN(12345.67) dá 8.

## LONX.B

Para a conxunto de caracteres de bytes dobres (DBCS) idiomas, devolve o número de bytes usados ​​para representar os carácteres nunha secuencia de texto.

Esta función está dispoñíbel desde a versión 4.2 do LibreOffice.

#### Sintaxe

LenB (\ "Texto")

text é o texto cuxa lonxitude é para ser determinada.

#### Exemplo

LenB (\ "中") dá 2 (1 carácter DBCS que consiste en 2 bytes).

LenB (\ "中国") dá 4 (2 DBCS caracteres cada composto por 2 bytes).

LenB (\ "oficina") Devolve 6 (seis caracteres non DBCS cada unha composta por un byte).

= LenB (\ "Boa Tarde") dá 14.

= LenB (12.345,67) dá 8.

## MAIÚSCULA

Converte a secuencia de caracteres especificada no texto campo a maiúscula.

#### Sintaxe

UPPER("Text")

Texto refírese ás letras minúsculas que quere converter a maiúsculas.

#### Exemplo

= UPPER (\ "Good Morning") dá BO DÍA.

## MEDIO

Devolve unha cadea de texto dun texto. Os parámetros especifican a posición inicial e o número de caracteres.

#### Sintaxe

MID (\ "Texto"; Iniciar; Number)

Texto é o texto que contén os caracteres para extraer.

Iniciar é a posición do primeiro carácter no texto para extraer.

Número especifica o número de caracteres na parte do texto.

#### Exemplo

= MID (\ "oficina"; 2; 2) dá ff.

## MEDIOB

Devolve unha cadea de texto dun texto DBCS. Os parámetros especifican a posición inicial e o número de caracteres.

Esta función está dispoñíbel desde a versión 4.2 do LibreOffice.

#### Sintaxe

MIDB (\ "Texto"; Iniciar; Number_bytes)

Texto é o texto que contén os caracteres para extraer.

Iniciar é a posición do primeiro carácter no texto para extraer.

Number_bytes especifica o número de caracteres MIDB volverá do texto, en bytes.

#### Exemplo

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

## MINÚSCULA

Converte todas as letras maiúsculas nunha secuencia de texto en minúsculas.

#### Sintaxe

MINÚSCULA(texto)

Texto refírese ao texto a ser convertido.

#### Exemplo

=MINÚSCULA("Sol") devolve sol.

## MOEDA

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.

Define o formato de moeda en súas opcións de sistema.

#### Sintaxe

DOLLAR(Value [; Decimals])

Valor é un número, unha referencia a unha cela que contén un número, ou unha fórmula que dá un número.

Decimals é o número opcional de cifras decimais.

#### Exemplo

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

## PRIMMAIÚSCULA

maiúscula a primeira letra de todas as palabras dunha cadea de texto.

#### Sintaxe

PRIMMAIÚSCULA(«Texto»)

Texto refírese ao texto a ser convertido.

#### Exemplo

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

## PROCURAR

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 - PreferencesTools - Options - LibreOffice Calc - Calculate.

Ao empregar funcións nas que un ou máis argumentos sexan criterios de busca que representen unha expresión regular, téntase primeiro converter os criterios da cadea en números. Por exemplo, «.0» convértese en 0.0, etc. Se resulta ben, a busca non será unha coincidencia de expresión regular senón unha coincidencia numérica. Porén, ao traballar cunha configuración rexional na que o separador decimal non sexa o punto, como en galego, o punto fai que funcione a conversión a expresión regular. Para obrigar a que a avaliación sexa dunha expresión regular no canto dunha expresión numérica hai que empregar algunha expresión que non se poda confundir cunha numérica, como «.[0]», «.\0» ou «(?i).0».

#### Sintaxe

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

FindText é o texto a ser buscado.

Texto é o texto en que a investigación será realizada.

Posición (opcional) é a posición no texto onde a procura para comezar.

#### Exemplo

= SEARCH (54; 998.877.665.544) dá 10.

## RECORTAR

Elimina os espazos dunha corda, deixando só un único carácter de espazo entre as palabras.

#### Sintaxe

TRIM("Text")

Texto refírese ao texto en que os espazos deben ser eliminadas.

#### Exemplo

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

## REPETIR

Repite unha secuencia de caracteres por número dato de copias.

#### Sintaxe

REPT (\ "Texto"; Number)

Texto é o texto a repetirse.

Número é o número de repeticións.

#### Exemplo

=REPT("Bo día";2)devolve Bos díasBos días.

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

## SUBSTITUÍR

Substitúe parte dunha cadea de texto cunha secuencia de texto diferente. Esta función pode usarse para substituír caracteres e números (que automaticamente convertidas en texto). O resultado da función sempre aparece como texto. Se desexa realizar outros cálculos cun número que foi substituído polo texto, terá que convertelo-lo de volta para un número usando o VALOR función.

Calquera texto que conteña números deberá colocar entre comiñas se non quere que sexa interpretado como un número e automaticamente convertidas en texto.

#### Sintaxe

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

Texto refírese ao texto do cal unha parte será substituída.

Posición refírese á posición no texto onde a substitución comeza.

Lonxitude é o número de caracteres en Texto para ser substituído.

newText refírese ao texto que substitúe Texto .

#### Exemplo

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

## T

Esta función devolve o texto de destino, ou unha secuencia de texto en branco se o destino non é o texto.

#### Sintaxe

T(valor)

Se Valor é unha cadea de texto ou refírese a unha cadea de texto, T devolve esta cadea de texto; en caso contrario, devolve unha secuencia de texto en branco.

#### Exemplo

= T (12345) devolve unha cadea baleira.

= T (\ "12345") dá a secuencia 12345.

## TEXTO

Converts a value into text according to a given format.

#### Sintaxe

TEXT(Value; Format)

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

Formatar é o texto que define o formato. Use separadores decimais e miles de acordo co idioma definido no formato de cela.

#### Exemplo

= TEXT (12,34567;". ### ##") devolve o texto 12,35

= TEXT (12,34567;"000.00") devolve o texto 012,35

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

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

## TEXTOBAHT

Converte un número en texto Tailandés, incluíndo os nomes de moedas tailandesas.

#### Sintaxe

TEXTOBAHT(Número)

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.

#### Exemplo

=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

## UNICHAR

Converte un número de código a un carácter ou letra Unicode.

#### Sintaxe

UNICHAR(number)

#### Exemplo

= UNICHAR (169) devolve o personaxe de Copyright © .

See also the UNICODE() function.

## UNICODE

Devolve o código numérico do primeiro carácter Unicode dunha cadea de texto.

#### Sintaxe

UNICODE("Text")

#### Exemplo

= Unicode (\ "©") devolve o número Unicode 169 para o personaxe de Copyright.

See also the UNICHAR() function.

Temas relacionados

Funcións por categoría