IBM Lotus Symphony


Funções de Texto

Esta seção contém descrições das funções de Texto, juntamente com um exemplo. As funções descritas a seguir são: ARABIC , BASE , CHAR , CLEAN , CODE , CONCATENATE , DECIMAL , DOLLAR , FIND , FIXED , LEFT , LEN , LOWER , MID , PROPER , REPLACE , REPT , RIGHT , ROMAN , SEARCH , SUBSTITUTE , T , TEXT , TRIM , UPPER , VALUE .

ARABIC

Calcula o valor de um número romano. O intervalo de valores deve ser entre 0 e 3999.

Sintaxe

ARABIC (Text)

Text é o texto que representa o número romano.

Exemplo

Arabic("MXIV") retorna 1014

Arabic("MMII") retorna 2002

Consulte também as seguintes funções:

ROMAN.

BASE

Converte um inteiro positivo para uma base especificada em um texto, a partir do sistema de numeração. Os dígitos 0-9 e as letras A-Z são usados.

Sintaxe

BASE(Number; Radix; [Minimum length])

number é o inteiro positivo a ser convertido.

radix indica a base do sistema de números. Ela pode ser um inteiro positivo entre 2 e 36.

Minimum length (opcional) determina o comprimento mínimo da sequência de caracteres que foi criada. Se o texto for menor que o comprimento mínimo indicado, zeros serão incluídos à esquerda da sequência.

Exemplo

BASE(17;10;4) retorna 0017 no sistema decimal.

BASE(17;2) retorna 10001 no sistema binário.

BASE(255;16;4) retorna 00FF no sistema hexadecimal.

Consulte também as seguintes funções:

DECIMAL.

CHAR

Converte um número em um caractere, de acordo com a tabela de códigos atual. O número pode ser um número inteiro de dois ou três dígitos.

Sintaxe

CHAR(number)

number é um número entre 1 e 255, representando o valor do código para o caractere.

Exemplo

CHARACTER(100) retorna o caractere "d".

Consulte também as seguintes funções:

CODE

CLEAN

Todos os caracteres não imprimíveis são removidos da sequência.

Sintaxe

CLEAN(text)

text refere-se ao texto a partir do qual irá remover todos os caracteres não imprimíveis.

Consulte também as seguintes funções:

CHAR, TRIM.

CODE

Retorna um código numérico para o primeiro caractere em uma sequência de texto.

Sintaxe

CODE(Text)

Text é o texto para o qual o código do primeiro caractere deve ser localizado.

Exemplo

CODE("Hieronymus") retorna 72, CODE("hieroglyphic") retorna 104.

Este ícone marca o texto que contém informações adicionais. O código usado aqui não se refere a ASCII, mas à tabela de códigos carregada atualmente.

Consulte também as seguintes funções:

CHAR

CONCATENATE

Combina várias sequências de texto em uma sequência.

Sintaxe

CONCATENATE(Text 1;...;Text 30)

Text 1; text 2; ... representa até 30 passagens de texto que devem ser combinadas em uma sequência.

Exemplo

CONCATENATE("Good ";"Morning ";"Mrs. ";"Doe") retorna Good Morning Mrs. Doe .

DECIMAL

Converte texto com caracteres de um sistema de números para um inteiro positivo na raiz de base fornecida. A raiz deve estar no intervalo 2 a 36. Espaços e guias são ignorados. O campo texto não faz distinção entre maiúsculas e minúsculas.

Se a raiz for 16, um x ou X à esquerda ou 0x ou 0X, e um h ou H anexado, será desconsiderado. Se a raiz for 2, um b ou B anexado será desconsiderado. Outros caracteres que não pertencem ao sistema de números geram um erro.

Sintaxe

DECIMAL(Text; Radix)

text é o texto a ser convertido. Para diferenciar entre um número hexadecimal, como A1 e a referência à célula A1, coloque o número entre aspas, por exemplo, "A1" ou "AFFE".

radix indica a base do sistema de números. Ela pode ser um inteiro positivo entre 2 e 36.

Exemplo

DECIMAL("17";10) retorna 17.

DECIMAL("FACE";16) retorna 64206.

DECIMAL("0101";2) retorna 5.

Consulte também as seguintes funções:

BASE.

DOLLAR

Converte um número para uma quantia no formato da moeda, arredondado para uma casa decimal específica. No campo value insira o número a ser convertido para moeda. Opcionalmente, será possível inserir o número de casas decimais no campo decimals. Se nenhum valor for especificado, todos os números no formato da moeda serão exibidos com duas casas decimais.

Você define o formato da moeda nas definições do sistema.

Sintaxe

DOLLAR(value; decimals)

value é um número, uma referência a uma célula que contém um número ou uma fórmula que retorna um número.

decimals é o número de casas decimais.

Exemplo

DOLLAR(255) retorna $255.00.

DOLLAR(367.456;2) retorna $367.46. Use o separador decimal que corresponde à definição de localidade atual.

Consulte também as seguintes funções:

FIXED, TEXT, VALUE.

EXACT

Compara duas sequências de texto e retorna TRUE, se elas forem idênticas. Essa função faz distinção entre maiúsculas e minúsculas.

Sintaxe

EXACT(text_1;text_2)

text_1 refere-se ao primeiro texto para comparação.

text_2 é segundo texto para comparação.

Exemplo

EXACT("IBM lab5";"IBM Lab5") retorna FALSE.

Consulte também as seguintes funções:

LEN, SEARCH.

FIND

Procura uma sequência de texto dentro de outra sequência. Você também pode definir onde irá iniciar a procura. O termo de procura pode ser um número ou qualquer sequência de caracteres. A procura faz distinção entre maiúsculas e minúsculas.

Sintaxe

FIND(find_text; text; position)

find_text refere-se ao texto a ser localizado.

text é o texto onde ocorre a procura.

position (opcional) é a posição no texto onde a procura é iniciada.

Exemplo

FIND(76;998877665544) retorna 6.

Consulte também as seguintes funções:

EXACT, LEN, MID, SEARCH.

FIXED

Especifica que um número seja exibido com um número fixo de casas decimais e com ou sem um separador de milhares. Essa função pode ser usada para aplicar um formato uniforme a uma coluna de números.

Sintaxe

FIXED(Number; decimals; no thousands separators)

Number refere-se ao número a ser formatado.

Decimals refere-se ao número de casas decimais a serem exibidas.

No thousands separators (opcional) determina se o separador de milhares é usado. Se o parâmetro for um número diferente de 0, o separador de milhares será suprimido. Se o parâmetro for igual a 0 ou se estiver ausente, os separadores de milhares de sua definição de locale atual serão exibidos.

Exemplo

FIXED(1234567.89;3) retorna 1,234,567.890. FIXED(1234567.89;3;1) retorna 1234567.890.

Consulte também as seguintes funções:

DOLLAR, ROUND, TEXT, VALUE.

LEN

Retorna o comprimento de uma sequência, incluindo espaços.

Sintaxe

LEN(text)

text é o texto cujo comprimento deve ser determinado.

Exemplo

LEN("Good Afternoon") retorna 14.

LEN(12345.67) retorna 8.

Consulte também as seguintes funções:

EXACT, SEARCH.

LOWER

Converte todas as letras maiúsculas em uma sequência de texto para letras minúsculas.

Sintaxe

LOWER(text)

text refere-se ao texto a ser convertido.

Exemplo

LOWER("IBM") retorna ibm.

Consulte também as seguintes funções:

PROPER, UPPER.

MID

Retorna um segmento de texto de uma sequência de caracteres. Os parâmetros especificam a posição inicial e o número de caracteres.

Sintaxe

MID(text; start; number)

text é o texto que contém os caracteres para extração.

start é a posição do primeiro caractere no texto para extração.

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

Exemplo

MID("IBM TB 2004";5;2) retorna TB.

Consulte também as seguintes funções:

CODE, FIND, LEFT, RIGHT, SEARCH.

PROPER

Capitaliza a primeira letra em todas as palavras de uma sequência de texto.

Sintaxe

PROPER(text)

text refere-se ao texto a ser convertido.

Exemplo

PROPER("ibm software lab") retorna Ibm Software Lab.

Consulte também as seguintes funções:

UPPER, LOWER.

REPLACE

Substitui parte de uma sequência de texto por uma sequência de texto diferente. Essa função pode ser usada para substituir os caracteres e os números (que são automaticamente convertidos para texto). O resultado da função é sempre exibido como texto. Se você pretende executar cálculos adicionais com um número que foi substituído por texto, precisará convertê-lo de volta para um número, usando a função VALUE.

Qualquer texto que contém números deverá ser colocado entre aspas, se você não desejar que ele seja interpretado como um número e convertido automaticamente para texto.

Sintaxe

REPLACE(text; position; length; new text)

text refere-se ao texto do qual uma parte será substituída.

position refere-se à posição dentro do texto onde a substituição iniciará.

length é o número de caracteres em text a ser substituído.

new text refere-se ao texto que substitui text.

Exemplo

REPLACE("1234567";1;1;"444") retorna "444234567". Um caractere na posição 1 é substituído pelo new text completo.

Consulte também as seguintes funções:

MID, SEARCH, SUBSTITUTE, TRIM.

REPT

Repete uma sequência de caracteres pelo número de cópias determinado.

Sintaxe

REPT(text; number)

text é o texto a ser repetido.

number é o número de repetições.

O resultado pode no máximo 255 caracteres.

Exemplo

REPT("Good morning"; 2) retorna Good morningGood morning.

RIGHT

Define o último caractere ou caracteres em uma sequência de texto.

Sintaxe

RIGHT(text; number)

text é o texto do qual a parte direita deve ser determinada.

number (opcional) é o número de caracteres da parte direita do texto.

Exemplo

RIGHT("Hui";2) retorna ui.

Consulte também as seguintes funções:

LEFT, MID.

ROMAN

Converte um número em um numeral romano. O intervalo de valores deve ser entre 0 e 3999 e os modos podem ser inteiros de 0 a 4.

Sintaxe

ROMAN(Number; Mode)

Number é o número que deve ser convertido para um numeral romano.

Mode (opcional) indica o grau de simplificação. Quanto mais alto o valor, maior a simplificação do número romano.

Exemplo

ROMAN(999) retorna CMXCIX

ROMAN(999;0) retorna CMXCIX

ROMAN (999;1) retorna LMVLIV

ROMAN(999;2) retorna XMIX

ROMAN(999;3) retorna VMIV

ROMAN(999;4) retorna IM

Consulte também as seguintes funções:

ARABIC

SEARCH

Retorna a posição de um segmento de texto dentro de uma sequência de caracteres. É possível definir o início da procura como uma opção. O texto de procura pode ser um número ou qualquer sequência de caracteres. A procura não faz distinção entre maiúsculas e minúsculas.

A pesquisa suporta

Expressões Comuns

. Na medida em que você insere o texto, é possível inserir "all.*", por exemplo, para localizar o primeiro local do "all" seguido por qualquer caractere.

Sintaxe

SEARCH(find_text; text; position)

find_text é o texto a ser procurado.

text é o texto onde ocorrerá a procura.

position (opcional) é a posição no texto onde a procura deve iniciar.

Exemplo

SEARCH(54;998877665544) retorna 10.

Consulte também as seguintes funções:

FIND, MID, REPLACE, SUBSTITUTE.

SUBSTITUTE

Substitui texto novo por antigo em uma sequência.

Sintaxe

SUBSTITUTE(text; search_text; new text; occurrence)

text é o texto no qual os segmentos de texto devem ser trocados.

search_text é o segmento de texto que deve ser substituído (inúmeras vezes).

new text é o texto que deve substituir o segmento de texto.

occurrence (opcional) indica quantas ocorrências do texto de procura devem ser substituídas. Se esse parâmetro estiver ausente, o texto de procura será substituído completamente.

Exemplo

SUBSTITUTE("123123123"; "3"; "abc") retorna 12abc12abc12abc.

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

Consulte também as seguintes funções:

REPLACE, TRIM.

T

Essa função converte um número para uma sequência de texto em branco.

Sintaxe

T(value)

value é o valor a ser convertido. Além disso, uma referência pode ser usada como um parâmetro. Se a célula referida incluir um número ou uma fórmula que contém um resultado numérico, o resultado será uma sequência vazia.

Exemplo

T(12345) torna-se uma sequência vazia "", se 12345 for formatado como um número. T("12345") retorna 12345.

Consulte também as seguintes funções:

N, VALUE.

TEXT

Converte um número em texto, de acordo com um determinado formato.

Sintaxe

TEXT(Number; Format)

Number é o valor numérico a ser convertido.

Format é o texto que define o formato. Use separadores decimais e de milhares de acordo com o idioma definido no formato de célula.

Consulte também as seguintes funções:

DOLLAR, FIXED, T, VALUE.

TRIM

Remove espaços que estão na frente de uma sequência ou alinha o conteúdo da célula para a esquerda.

Sintaxe

TRIM(Text)

text refere-se ao texto no qual os espaços à esquerda são removidos ou à célula na qual o conteúdo será alinhado à esquerda.

Exemplo

TRIM(" hello") retorna "hello".

Consulte também as seguintes funções:

CLEAN, REPLACE, MID, SUBSTITUTE.

UPPER

Converte a sequência especificada no campo text para letras maiúsculas.

Sintaxe

UPPER(text)

text refere-se a letras minúsculas que você deseja converter para maiúsculas.

Exemplo

UPPER("Good Morning") retorna GOOD MORNING.

Consulte também as seguintes funções:

LOWER, PROPER.

VALUE

Converte uma sequência de texto para um número.

Sintaxe

VALUE(text)

text é o texto a ser convertido para um número.

Exemplo

VALUE("4321") retorna 4321.

Consulte também as seguintes funções:

DOLLAR, FIXED, TEXT.


Feedback do Produto | Documentação Adicional | Marcas Registradas