Operadores de busca
Todos os operadores de busca com seus valores, um exemplo e se eles filtram no app hoje.
Um operador é um nome, dois-pontos e um valor, sem espaço: from:anna. Os nomes dos operadores não diferenciam maiúsculas de minúsculas. Coloque entre aspas os valores que contêm espaços: subject:"annual report". A página de sintaxe explica como combinar operadores.
Referência
A coluna de status diz o que o operador faz hoje no app no macOS, no iPhone e no iPad.
- Funciona: filtra como descrito.
- Limitado: filtra, com a restrição indicada.
- Somente linha de comando: filtra apenas na linha de comando foldmail, não no app.
- Sem efeito: aceito, mas não avaliado. A busca é executada como se o operador não estivesse ali.
- Erro: a busca para com uma mensagem.
| Operador | Valor | Exemplo | Status |
|---|---|---|---|
from: | Nome ou endereço do remetente | from:anna | Funciona |
to: | Nome ou endereço em Para | to:[email protected] | Funciona |
cc: | Nome ou endereço em Cc | cc:ben | Funciona |
bcc: | Nome ou endereço em Cco | bcc:ben | Limitado: o Cco não é indexado separadamente, então isto busca no campo Para |
subject: | Texto no assunto | subject:invoice | Funciona |
body: | Texto na mensagem | body:contract | Limitado: o texto das mensagens recebidas ainda não é indexado |
in: | Nome ou caminho da pasta | in:"Archive 2025" | Sem efeito; use a barra Buscar em: no Mac |
account: | Nome ou endereço da conta | account:Work | Somente linha de comando |
from-account: | Nome ou endereço da conta | from-account:Work | Somente linha de comando; igual a account: |
from-identity: | Identidade ou alias | from-identity:support | Sem efeito |
is: | unread, read, flagged, answered, deleted, draft | is:unread | Funciona; qualquer outro valor é tratado como etiqueta, então is:Important equivale a label:Important |
label: | Nome da etiqueta | label:important | Funciona; corresponde ao nome inteiro da etiqueta, sem diferenciar maiúsculas de minúsculas |
has: | attachment | has:attachment | Erro: “Este operador de busca ainda não é compatível. (has:attachment)”. Outros valores são rejeitados |
size: | Comparação, número, unidade | size:>10M | Funciona |
before: | Data ou data relativa | before:2024-06-01 | Funciona |
after: | Data ou data relativa | after:7d | Funciona |
list: | ID da lista de e-mails | list:swift-evolution | Sem efeito |
file: | Extensão de arquivo de um anexo | file:pdf | Sem efeito |
A pasta inteligente predefinida Com anexo usa has:attachment e atualmente mostra o mesmo erro.
Tamanhos
size: compara o tamanho da mensagem inteira, conforme informado pelo servidor. Use >, >=, <, <= ou =; sem comparação, o tamanho precisa corresponder exatamente. K, M e G equivalem a 1.024, 1.048.576 e 1.073.741.824 bytes; sem unidade, o número está em bytes.
size:>10M
size:<=500K
size:>=1G
Datas
before: e after: aceitam duas formas:
- Uma data do calendário no formato
YYYY-MM-DD, lida como meia-noite UTC.before:2024-06-01encontra mensagens anteriores a 1º de junho de 2024;after:2024-06-01encontra mensagens a partir de 1º de junho de 2024, incluindo esse dia. - Um número e uma unidade contados para trás a partir de agora:
ddias,wsemanas,mmeses,yanos.after:7dencontra os últimos sete dias,before:6mtudo o que tem mais de seis meses.
Outras formas, como before:2024-06, não são datas e interrompem a busca com um erro de interpretação. O FOLD compara a data do cabeçalho da mensagem ou, se o cabeçalho não tiver uma, a data de chegada no servidor.
after:2024-01-01 before:2024-04-01
before:1y size:>5M
Exclusão
Um sinal de menos antes de um operador atualmente só funciona com valores de status, como -is:read. Com os outros operadores, ele causa um erro ou é ignorado; a página de sintaxe traz os detalhes.
Operadores sem efeito
Uma consulta formada apenas por operadores sem efeito, como in:INBOX ou list:announce, corresponde a todas as mensagens. Tenha isso em mente nas regras de filtro, em que uma condição assim agiria sobre todos os e-mails.
Exemplos
from:anna subject:budget after:30d
from:[email protected] -is:flagged
(from:anna OR from:ben) is:flagged
label:project-x before:3m