Algumas partes da página podem ter sido traduzidas automaticamente.

MATCH Função

A função MATCH ajuda você a localizar a posição exata de um item específico dentro de uma lista ou tabela de dados no Smartsheet. Pense nisso como descobrir qual posição numerada um item particular ocupa em uma sequência.

Sintaxe

MATCH(search_value, range, [search_type])
  • search_value
    O valor a ser pesquisado.
  • range
    O intervalo de células (tabela de pesquisa) a ser pesquisado.
  • search_type—[opcional]
    Define se correspondências exatas são necessárias (0) ou se correspondências aproximadas são permitidas (1, -1). Correspondências aproximadas só podem ser determinadas quando os dados estão ordenados em ordem crescente (1) ou decrescente (-1).

Exemplo de uso

MATCH("Tarefa A", [Nome da tarefa]:[Nome da tarefa], 0)

Notas de uso

O Smartsheet calcula a posição relativa de um valor de pesquisa contando as células da esquerda para a direita (entre as colunas) e de cima para baixo (entre as linhas) dentro do intervalo selecionado.

  • Em uma tabela de pesquisa composta por duas colunas, a célula da linha superior da coluna mais à esquerda é a primeira posição, 1, independentemente de sua posição dentro da planilha.
  • Ao trabalhar com dados de texto (string), a função considera letras mais tarde no alfabeto como maiores do que o valor de pesquisa e letras mais cedo no alfabeto como menores.
  • Quando o intervalo não está ordenado e search_type não está definido, a função MATCH pode falhar em encontrar o valor esperado quando um valor maior está localizado no início da lista.

Por exemplo, se você tiver uma coluna listando vários produtos, a função MATCH pode dizer se Calças é o primeiro, quinto ou décimo produto nessa lista. Ela retorna um número representando o lugar relativo desse item, com o primeiro item da lista sempre sendo a posição 1. Isso é particularmente útil quando você precisa combiná-lo com outras funções, como INDEX, para recuperar informações relacionadas.

Brandfolder Image
MATCH usage notes 1
Brandfolder Image
MATCH usage notes 2
Brandfolder Image
MATCH usage notes 3

Para o argumento opcional search_type:

  • 1: (O valor padrão) Revê o intervalo até encontrar uma correspondência exata ou um valor maior que o valor de pesquisa. Se encontrar um valor além do valor de pesquisa, o resultado é a posição anterior daquele valor maior.
  • 0: Localiza a primeira correspondência exata (nenhuma ordem de classificação é necessária)
  • -1: Revê o intervalo até encontrar uma correspondência exata ou um valor menor que o valor de pesquisa. Se encontrar um valor antes do valor de pesquisa, o resultado é a posição anterior daquele valor menor.

Exemplos

Esse exemplo faz referência às seguintes informações de planilha:

Linha nºItem de vestuárioTotal da transaçãoUnidades vendidasPreço por unidadeData do pedido
1Camiseta$1,950.0078R$ 15,0012/02/25
2CalçaR$ 1.491,0042R$ 35,5015/02/25
3CasacoR$ 900.0045R$ 20,0020/02/25

Com base na tabela acima, aqui estão alguns exemplos de uso da função MATCH em uma planilha:

FórmulaDescriçãoResultado

=MATCH("Calça", [Item de vestuário]:[Item de vestuário], 0)

Retorna a posição para Calça na coluna Item de vestuário

2

=MATCH(42, [Unidades Vendidas]1:[Preço por Unidade]3, 0)

Retorna a posição do valor numérico 42 da tabela de duas colunas, onde 78 seria a 1ª posição e R$ 20,00 a 6ª posição

3

=MATCH(DATE(2025, 2, 14), [Order Date]:[Order Date], 1)


Retorna a posição da data mais próxima em ou antes de 14 de fevereiro de 2025, usando a função DATE, na coluna Data do Pedido

 

A coluna Data do Pedido está em ordem crescente.

1
=MATCH(1500, [Total da Transação]:[Total da Transação], -1)

Retorna a posição do número mais próximo igual ou maior que 1500 na coluna Total da Transação.

A coluna Total da Transação está em ordem decrescente.

1

=INDEX([Preço por Unidade]:[Preço por Unidade], MATCH("Casaco", [Item de vestuário]:[Item de vestuário], 0))Retorna o valor na coluna Preço por Unidade para a linha que contém o valor Casaco na coluna Item de vestuário.2/20/2025

Ainda precisa de ajuda?

Use o modelo do manual de fórmulas para encontrar mais recursos de suporte e exibir mais de 100 fórmulas, incluindo um glossário de cada função que você pode praticar trabalhando em tempo real e exemplos de fórmulas avançadas e de uso frequente. 

Saiba mais sobre combinações de fórmulas para referências entre planilhas. 

Encontre exemplos de como outros clientes do Smartsheet usam essa função, ou faça perguntas sobre o seu caso de uso específico na comunidade on-line do Smartsheet.

Pergunte à comunidade