Скачать

Операторы поиска

Все операторы поиска с их значениями, примером и указанием, фильтрует ли оператор в приложении уже сегодня.

Оператор состоит из имени, двоеточия и значения без пробела: from:anna. Имена операторов не зависят от регистра. Значения с пробелами заключайте в кавычки: subject:"annual report". Как сочетать операторы, объясняет страница о синтаксисе.

Справочник

Столбец статуса показывает, что оператор делает сегодня в приложении на macOS, iPhone и iPad.

  • Работает: фильтрует, как описано.
  • Ограничено: фильтрует с указанным ограничением.
  • Только в командной строке: фильтрует только в командной строке foldmail, но не в приложении.
  • Не действует: принимается, но не учитывается. Поиск выполняется так, будто оператора нет.
  • Ошибка: поиск останавливается с сообщением.
ОператорЗначениеПримерСтатус
from:Имя или адрес отправителяfrom:annaРаботает
to:Имя или адрес в поле «Кому»to:[email protected]Работает
cc:Имя или адрес в поле «Копия»cc:benРаботает
bcc:Имя или адрес в поле «Скрытая копия»bcc:benОграничено: скрытая копия не индексируется отдельно, поэтому поиск идёт по полю «Кому»
subject:Текст в темеsubject:invoiceРаботает
body:Текст в письмеbody:contractОграничено: текст полученных писем пока не индексируется
in:Имя или путь папкиin:"Archive 2025"Не действует; на Mac используйте панель Искать в:
account:Имя или адрес учётной записиaccount:WorkТолько в командной строке
from-account:Имя или адрес учётной записиfrom-account:WorkТолько в командной строке; то же, что account:
from-identity:Профиль отправителя или псевдонимfrom-identity:supportНе действует
is:unread, read, flagged, answered, deleted, draftis:unreadРаботает; любое другое значение считается тегом, поэтому is:Important равнозначно label:Important
label:Имя тегаlabel:importantРаботает; сравнивает имя тега целиком, без учёта регистра
has:attachmenthas:attachmentОшибка: «Этот оператор поиска пока не поддерживается. (has:attachment)». Другие значения отклоняются
size:Сравнение, число, единицаsize:>10MРаботает
before:Дата или относительная датаbefore:2024-06-01Работает
after:Дата или относительная датаafter:7dРаботает
list:Идентификатор списка рассылкиlist:swift-evolutionНе действует
file:Расширение файла вложенияfile:pdfНе действует

Предустановленная смарт-папка С вложением использует has:attachment и сейчас показывает ту же ошибку.

Размеры

size: сравнивает размер всего письма, который сообщает сервер. Используйте >, >=, <, <= или =; без знака сравнения размер должен совпасть точно. K, M и G означают множители 1024, 1 048 576 и 1 073 741 824 (в байтах); без единицы число задаётся в байтах.

size:>10M
size:<=500K
size:>=1G

Даты

before: и after: принимают две формы:

  • Календарную дату в виде YYYY-MM-DD, которая читается как полночь по UTC. before:2024-06-01 находит письма до 1 июня 2024 года; after:2024-06-01 находит письма начиная с 1 июня 2024 года, включая этот день.
  • Число и единицу, отсчитываемые назад от текущего момента: d дни, w недели, m месяцы, y годы. after:7d находит письма за последние семь дней, before:6m всё, что старше шести месяцев.

Другие формы, например before:2024-06, не считаются датами и останавливают поиск с ошибкой разбора. FOLD сравнивает дату из заголовка письма, а если её там нет, дату поступления на сервер.

after:2024-01-01 before:2024-04-01
before:1y size:>5M

Исключение

Минус перед оператором сейчас работает только для значений статуса, например -is:read. Для остальных операторов он либо вызывает ошибку, либо игнорируется; подробности приведены на странице о синтаксисе.

Операторы без действия

Запрос, который состоит только из операторов без действия, например in:INBOX или list:announce, совпадает с каждым письмом. Помните об этом в правилах фильтрации, где такое условие затронуло бы всю почту.

Примеры

from:anna subject:budget after:30d
from:[email protected] -is:flagged
(from:anna OR from:ben) is:flagged
label:project-x before:3m