| Função | Descrição | Exemplo |
|---|---|---|
| Sum Soma | Soma valores ou intervalo de células | Soma(A1:A10) Soma(Valor) |
| SumIfs SomaSeS | A função SomaSes soma valores de acordo com critérios. O uso de caracteres curinga (ver Função Criterio), como o ponto de interrogação (?) e o asterisco (*), em critérios1,2 pode ajudar você a localizar correspondências semelhantes, mas não exatas. Um ponto de interrogação corresponde a qualquer caractere único. Um asterisco corresponde a qualquer sequência de caracteres. Se você quiser localizar um ponto de interrogação ou asterisco real, digite um til (~) antes do ponto de interrogação. | Soma(A1:A10) Soma(Valor) =SOMASES (A2:A9;B2:B9;"=A*";C2:C9;"To?") adicionará todas as instâncias com o nome que começa com "To" e termina com uma última letra que pode variar. |
| Left Esquerda | Extrai a parte esquerda de um texto | left("abcde",2) "ab" |
| Right Direita | Extrai a parte direita de um texto | Direita("abcde", 2) "de" |
| Subs SubString Mid Pedaço ou Pedaco | Extrai parte de um texto | Subs("abcde", 2, 1) "c" |
| Replace Troca StrTran Mudar | Substitui o conteúdo de um texto por outro | Troca("abcdefg", "bc", "X") "aXdefg" |
| Replicate Repete Rept | Gera um texto n vezes | Replicate("ab", 3) "ababab" |
| Trim Arrumar | Elimina os espaços em branco no início e final de um texto | Trim(" ab ") "ab" |
| Space Espaço Espaco | Devolve um texto com n espaços | Space(5) " " |
| char caract chr | Retorna o caractere especificado pelo número de código | Char(65) "A" |
| Str Text Texto | Converte um valor em texto (string) | Texto(123) "123" |
| asc | Retorna o codigo ASCI do caracter | Asc("A") 65 |
| Arredonda Round Arred | Arredonda um valor | round(123.456,2) 123.46 |
| Val Valor Value | Converte um texto para um número | Val("123.45") 123.45 |
| Balance Saldo | Obsoleto | |
| format formata | Formata um texto com substituição por argumentos. Igual ao metodo string.Format(...) | Formata("Meu nome é {0}, e o seu?", "Jony") |
| formatcurrency formatamoeda | Formata um valor na moeda do sistema | FormataMoeda(1234.5) "R$ 1.234,50" |
| formatoExtenso PorExtenso Extenso SpellValue | Escreve o valor por extenso com a moeda na língua em que o sistema está configurado | Extenso(1234.5) "um mil, duzentos e trinta e quatro reais e cinquenta centavos" |
| Capitalize Proper InicialMaiuscula | Formata um texto com as iniciais de cada palavra em maiúscula | Capitalize("joão da silva") "João da Silva" |
| FormatDate FormataData | Formata uma data no formato da língua do sistema | FormataData(Data(2001,1,31)) "31/01/2001" |
| FormatMes FormatMonth | Retorna o Mês abreviado com as 3 primeiras letras do nome do mês e 4 digitos do ano | FormataData(Data(2001,1,31)) "Jan-2001" |
| FormatValue FormataValor | Formata um valor com separação dos milhares e 2 digitos decimais | FormataValor(1234.5) "1.234,50" |
| Empty IsEmpty Vazio | Retorna Verdadeiro ou Falso se o valor estiver vazio ou igual, data mínima ou igual a 0 | |
| IsNull ENulo | Retorna Verdadeiro ou Falso se o valor for nulo | |
| If Iif Se | Retorna o segundo argumento se a primeira expressão for verdadeiro, senão retorna o terceiro argumento | Se(1=2, "igual", "diferente") "diferente" |
| Concatena Concatenate Concat | Concatena os valores | Concatena("Documento: ", 1) "Documento: 1" |
| ConcatenaSe ConcatenateIf | Concatena os valores se TODOS os argumentos tiverem conteúdo. Não pode ter nenhum em branco ou zerado, nesse caso devolve um texto vazio. | ConcatenaSe("Documento: ", 0, " cfe nota enviada") "" ConcatenaSe("Documento: ", 1, "do fornecedor") "Documento: 1 do forneceder" |
| AppendIf AcrescentaSe | Acrescenta o segundo argumento se o primeiro não for vazio (branco, 0). Se o segundo argumento não for informado, retorna o primeiro se não for vazio. | AcrescentaSe(1, FormataValor(1234.25))1.234,25 |
| 🆕 AppendLineIf AcrescentaLinhaSe | Acrescenta o segundo argumento com uma nova linha se o primeiro argumento não estiver vazio. | AcrescentaLinhaSe(pedido.Campanha) |
| 🆕 JoinLineIf JuntaLinhaSe | Concatena os elementos (argumentos) não vazios com quebra de linha entre eles | JuntaLinhaSe(pedido.Produto, pedido.Campanha) |
| DateTime Data | Cria um objeto DateTime | Data(2001,1,31) |
| Ou Or | Retorna verdadeiro se um dos argumentos for verdadeiro ou nao vazio | Or(1=2, 3=3, 5=6) |
| E And | Retorna verdadeiro apenas se os argumentos forem verdadeiros ou nao vazio | E(1=2, 3=3) |
| 🆕 NAO NÃO NOT | Nega o valor lógico | NOT(1=1) NOT(1=2) |
| Similar Like | Retorna verdadeiro se o primeiro argumento for igual ao segundo. A comparação é feita até o tamanho do primeiro argumento. Pode-se usar % ou * para indicar qualquer conteúdo. | Similar("abcd", "abc") Similar("abc", "abcde") Like("abcde", "%de") Like("abcde", "%bc%") Like("abcde", "ab*") |
| Operador Aritimético | Descrição | Exemplo |
|---|---|---|
| + | Adição Soma valores números Concatena textos se algum dos termos for do tipo texto. Soma dias se o operador da esquerda for uma data e o operador da direita for um número. | 1 + 1 = 2 'Maria' + 2 = Maria2 hoje + 1 = 13/04/2015 (considerando que hoje é dia 12/04/2005 |
| - | Subtração Subtrai valores números Diminui dias se o operador da esquerda for uma data e da direita for um número | 2 - 1 = 1 hoje - 1 = 11/04/2015 (considerando que hoje é dia 12/04/2015) agora - (1/24) = 12/04/2015 11:16:25 (diminui 1 hora do momento atual) |
| * | Multiplicação Multiplica o operador da esquerda com o da direita | 2 * 3 = 6 2 * 3 * 4 = 24 |
| / | Divisão Divide o operador da esquerda pelo da direita | 5 / 2 = 2.5 24 / 3 / 4 = 2 |
| Operadores Relacionais (Comparativos) | Descrição | Exemplo |
|---|---|---|
| = Igual Equal Like Equal To Igual a | Operador de Comparação de Igualdade Não Estrito A comparação de texto ocorre até o tamanho do operador da direita | 1 = 1 1 = 1.25 2 igual 2 2 igual 3 'João da Silva' = 'João' 'João' = 'João da Silva' |
| == | Operador de Comparação de Igualdade Estrito A comparação deve ser exatamente igual | 1 == 1 1 == 1.25 'João' == 'João' 'João' == 'João da Silva' 'João da Silva' == 'João' 'João da Silva' == 'João' |
| !== | Operador de Comparação de Desigualdade Estrito | 1 !== 1 'João' !== 'João' 'João' !== 'João da Silva' 'João da Silva' !== 'João' |
| != <> ≠ Not Equal Not Like Diferente Diferente de | Operador de Comparação de Desigualdade Não Estrito | 1 != 1 2 diferente de 3 2 ≠ 3 'João' != 'João da Silva' 'João da Silva' != 'João' |
| !== | Operador de Comparação de Desigualdade Estrito | 1 !== 1 2 !== 3 'João' !== 'João da Silva' 'João da Silva' = 'João' |
| > Greater Than Maior Que | Retornará Verdadeiro se o operador à esquerda for MAIOR que o operador à direita, caso contrário retornará falso | 2 > 1 1 > 2 |
| >= Maior ou Igual Greater Than or Equal To | Retornará Verdadeiro se o operador à esquerda for MAIOR OU IGUAL que o operador à direita, caso contrário retornará falso | 1 >= 1 1 >= 2 |
| < Menor Que Less | Retornará Verdadeiro se o operador à esquerda for MENOR ou IGUAL que o operador à direita, caso contrário retornará falso | 1 >= 1 1 >= 2 |
| <= Meno ou Igual Less Than or Equal To | Retornará Verdadeiro se o operador à esquerda for MENOR ou IGUAL que o operador à direita, caso contrário retornará falso | 1 <= 1 2 <= 1 |
| 🆕 in em | Compara se o operador da esquerda pertence ao operador da direita Operadores (elementos) do tipo texto não difere maiúscula de minúscula | 123 in {1,2,3,4,5} 2 in {1,2,3,4,5} 'alicia' em 'Maria Alícia da Silva' |
| 🆕 contains contem | Compara se o operador da esquerda contém o operador da esquerda Operadores (elementos) do tipo texto não difere maiúscula de minúscula | {1,2,3,4,5} contem 123 {1,2,3,4,5} contem 2 'Maria Alícia da Silva' contem 'alicia' |
| 🆕 not in nao em | descricão | 123 not in {1,2,3,4,5} 2 not in {1,2,3,4,5} |
| ends with termina com | Determina se o final da cadeia de caracteres corresponde à cadeia de caracteres especificada | 'João da Silva' termina com 'SILVA' 'João da Silva' termina com 'JO' Nao faz diferenciação entre maiúscula/minúsculas e acentuação |
| starts with begins with começa com comeca com | Determina se o início da cadeia de caracteres corresponde à cadeia de caracteres especificada. Nao faz diferenciação entre maiúscula/minúsculas e acentuação | 'João da Silva' começa com 'João' 'JOÃO DA SILVA' começa com 'JOAO' 'João da Silva' começa com 'Silva' |
| Operador Lógico | Descrição | Exemplo | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| OR OU || | Operador lógico condicional OR (OU) A condição será verdadeira (true) se a ou b forem avaliados como verdadeiros. O resultado será falso caso ambos a e b forem falsos. Caso a ou b não forem valores boleanos, será considerado como verdadeiro se a ou b não for vazio. | 1 = 1 OU 2 = 3 2 = 2 OU 3 = 3 2 = 3 OU 3 = 4 0 ou 'João' 0 ou ' ' | ||||||||||||||||||||
| AND E && | Operador lógico condicional AND (E) A condição será verdadeira (true) se ambos a e b forem avaliados como verdadeiros. Caso contrário, o resultado será falso (false) | 1 = 1 OU 2 = 3 2 = 2 OU 3 = 3 2 = 3 OU 3 = 4 | ||||||||||||||||||||
A tabela a seguir apresenta essa semântica:
| ||||||||||||||||||||||