Guia Rápido de Sintaxe de Busca

A busca no Agenda é simples e rápida: você digita alguns termos e faz a busca instantaneamente em todas as suas notas. Os resultados presentes na visão geral ou no projeto atualmente selecionado aparecem no topo da lista, e os que estão em projetos arquivados ou na lixeira aparecem no final.

No entanto, você também pode criar consultas muito mais complexas, tanto clicando/tocando nos tokens de busca criados no campo de busca ao pressionar a barra de espaço ou a tecla return, quanto por meio de um sistema muito parecido com o das ações de texto (consulte o capítulo Guia Rápido de Ações de Texto), combinado com um autocompletar poderoso.

As propriedades de busca são precedidas por um caractere de barra invertida (\) que abre um menu de autocompletar mostrando as propriedades disponíveis para busca, que pode ser filtrado digitando os primeiros caracteres da ação que você quer usar.

Dica: No iPhone e no iPad sem teclado físico, digitar o caractere de barra invertida pode ser um pouco trabalhoso. Em vez disso, basta tocar no ícone de lupa no campo de busca. Prático!

Da mesma forma, em alguns teclados, como os chineses ou japoneses, é difícil digitar uma barra invertida; portanto, sempre que uma barra invertida for mostrada, você também pode usar duas crases (``) ou dois caracteres de ponto central (··).

Muitas dessas propriedades podem receber os chamados parâmetros entre parênteses (de forma parecida com a adição de parâmetros de valor às tags, veja o capítulo Tags, Pessoas, Ações de Texto e Links), para refinar ainda mais o comportamento dessas ações. Por exemplo, \title(starts-with: yak) busca a palavra yak no início do título da nota.

Os parâmetros marcados como Padrão são considerados o parâmetro padrão quando nenhum é fornecido. Por exemplo, \tag(important) é considerado o mesmo que \tag(name: important).

Abaixo você encontra uma visão geral completa das propriedades de busca que o Agenda atualmente aceita.

Propriedades da Nota

\all

• busca em todos os campos de uma nota (Padrão)
• sinônimos: everything

\on-the-agenda

• busca pelo status Na Agenda de uma nota
• sinônimos: ontheagenda, ota, agenda

\title

• busca pelo Título de uma nota
• sinônimos: ti

\assigned-date

• busca pela Data Atribuída de uma nota, isto é, uma nota à qual foi atribuída uma única data
• sinônimos:
• abreviações: \today, \tomorrow, \yesterday, \monday, \tuesday, \wednesday, \thursday, \friday, \saturday, \sunday

\start-date

• busca pela Data de Início de uma nota, isto é, o primeiro dia de uma nota à qual foi atribuído um intervalo de datas
• sinônimos:

\end-date

• busca pela Data de Fim de uma nota, isto é, o último dia de uma nota à qual foi atribuído um intervalo de datas
• sinônimos:

Data atribuída vs. data de início/fim: \assigned-date é para notas com uma única data, enquanto \start-date e \end-date são para notas com um intervalo de datas. Se uma nota tem apenas uma única data, \assigned-date e \start-date corresponderão às mesmas notas, então seus resultados se sobrepõem. A diferença só se torna visível quando as notas têm intervalos de datas.

\linked-event

• busca pelo evento vinculado a uma nota
• sinônimos:

\calendar

• busca pelo calendário do evento vinculado a uma nota
• sinônimos:

\due-date

• busca pela data de vencimento dos lembretes presentes em uma nota
• sinônimos:

\color

• busca pela cor de fundo de uma nota
• sinônimos:

\pinned

• busca pelo status de fixação de uma nota
• sinônimos:

\footnote

• busca pelo status de nota de rodapé de uma nota
• sinônimos:

\done

• busca pelo status de conclusão de uma nota
• sinônimos:

\locked

• busca pelo status de proteção de uma nota
• sinônimos:

\shared

• busca pelo status de compartilhamento de uma nota
• sinônimos:

\edited-date

• busca pela data de edição de uma nota
• sinônimos:

\creation-date

• busca pela data de criação de uma nota
• sinônimos:

\template

• busca pelo modelo usado para criar uma nota
• sinônimos:

Conteúdo da Nota

\tag

• busca pela tag no conteúdo de uma nota
• sinônimos: #

Parâmetros

• name - o nome da tag - Padrão, Obrigatório
• color - o nome ou o valor hexadecimal da cor da tag - Premium
• value, text, string - um valor de texto opcional - Segundo Padrão
• day, on, after, before, until, from, in - um valor de dia opcional
• date, at - um valor de data opcional
• int, integer, number, level - um valor inteiro opcional
• float, double - um valor de ponto flutuante opcional

Exemplos

• \tag(name: important) - cria a tag #important, igual a \tag(important)
• \tag(important, color: blue) - cria a tag #important com a cor azul
• \tag(important, color: #333) - cria a tag #important com a cor hexadecimal #333
• \tag(priority, value: high) - cria a tag #priority(high), igual a \tag(priority, high)
• \tag(due, day: tomorrow) - cria a tag #due(6 April 2022)
• \tag(due, in: 3 weeks) - cria a tag #due(26 April 2022)
• \tag(deadline, at: 17 oct 2022 13pm) - cria a tag #deadline(17 Oct 2022 at 13.00)
• \tag(priority, int: 1, color: red) - cria a tag #priority(1) em vermelho
• \tag(version, float: 2.1) - cria a tag #version(2.1)

\person

• busca pela pessoa no conteúdo de uma nota
• sinônimos: @, contact

Parâmetros

• name, alias, nickname - o nome da pessoa - Padrão, Obrigatório

Exemplos

• \person(name: Tom G) - cria a pessoa @(Tom G), igual a \person(Tom G)

\reminder

• busca pelo lembrete no conteúdo de uma nota
• sinônimos: \remind,

Parâmetros

• none - insere um lembrete de marcação que não é agendado
• due-date - um texto em linguagem natural representando uma data no futuro - Padrão
• title - o título do lembrete a agendar
• list - a lista, no aplicativo Lembretes, na qual agendar o lembrete
• all-day - agenda o lembrete como um lembrete de dia inteiro

Exemplos

• \reminder - cria um lembrete não agendado e abre o balão de edição
• \reminder(today) - agenda um lembrete para hoje daqui a 30 minutos
• \reminder(today at 6pm) - agenda um lembrete para hoje às 18 horas
• \reminder(tomorrow evening) - agenda um lembrete para amanhã às 18 horas
• \reminder(in 3 weeks) - agenda um lembrete para daqui a 21 dias
• \reminder(25 dec 2020, at 8pm)` - agenda um lembrete para 25 de dezembro de 2020 às 20 horas
• \reminder(today at 6pm, list: important) - agenda um lembrete para hoje às 18 horas na lista de lembretes “important”
• \reminder(all-day: tomorrow) - agenda um lembrete de dia inteiro para amanhã

\table

• busca pela tabela no conteúdo de uma nota
• sinônimos:

\link

• busca pelo link no conteúdo de uma nota
• sinônimos:

\attachment

• busca pelo anexo no conteúdo de uma nota
• sinônimos:

\drawing

• busca pelo desenho no conteúdo de uma nota
• sinônimos:

\starred

• busca pelo status de estrela no conteúdo de uma nota
• sinônimos:

\has-todo

• busca se há itens de tarefa no conteúdo de uma nota
• sinônimos:

\has-checklist

• busca se há uma lista de verificação no conteúdo de uma nota
• sinônimos:

\has-list

• busca se há uma lista numerada ou ordenada, ou uma lista de verificação, no conteúdo de uma nota
• sinônimos:

\has-code

• busca se há um trecho de código no conteúdo de uma nota
• sinônimos:

\has-quote

• busca se há uma citação no conteúdo de uma nota
• sinônimos:

Projetos e Categorias

\category

• busca pela categoria que contém uma nota
• sinônimos:

\project

• busca pelo projeto que contém uma nota
• sinônimos:

\archived

• busca se uma nota faz parte de um projeto arquivado
• sinônimos:

Predefinições

\recently-edited

• busca notas editadas recentemente
• sinônimos:

\now

• busca notas em andamento no momento
• sinônimos:

\upcoming

• busca notas futuras
• sinônimos:

\earlier

• busca notas que acabaram de terminar
• sinônimos:

\on-this-day

• busca notas do passado que foram atribuídas ao mesmo dia em um ano anterior.
• sinônimos:

\random

• retorna um determinado número de notas selecionadas aleatoriamente
• sinônimos:

Operadores

AND

• ambos os termos devem estar presentes
• sinônimos: &&

OR

• um dos termos deve estar presente
• sinônimos: ||

NOT

• o termo não deve estar presente
• sinônimos: !

Correspondências Literais

() e ""

Agrupamento

Localização

Observe que todas as ações e parâmetros devem estar devidamente localizados de acordo com o idioma do aplicativo. Nesse caso, você pode usar tanto a variante em inglês acima quanto as variantes traduzidas. Note que, embora as ações possam conter acentos e/ou maiúsculas, não é necessário digitá-los; por exemplo, na versão francesa do Agenda, você pode obter uma lista numerada digitando qualquer uma das seguintes opções:

• \numérotée
• \numerotee
• \Numérotée
• \numbered