Skip to main content

Noções básicas de sintaxe de pesquisa

Ao realizar pesquisas no GitHub, é possível criar consultas que correspondam a números e palavras específicos.

Observação

A sintaxe abaixo se aplica à pesquisa sem código. Para obter mais informações sobre a sintaxe de pesquisa de código, confira Compreendendo a sintaxe de Pesquisa de Código do GitHub.

Consultar por valores maiores ou menores que outro valor

Use >, >=, < e <= para pesquisar valores maiores que, maiores ou iguais a, menores que e menores ou iguais a outro valor.

ConsultaExemplo
>n
          **
          [cats stars:>1000](https://github.com/search?utf8=%E2%9C%93&q=cats+stars%3A%3E1000&type=Repositories)** corresponde aos repositórios com a palavra "cats" que têm mais de 1000 estrelas.

>=n | ** cats topics:>=5** corresponde aos repositórios com a palavra "cats" que têm cinco tópicos ou mais. <n | ** cats size:<10000** corresponde ao código com a palavra "cats" em arquivos com menos de 10 KB. <=n | ** cats stars:<=50** corresponde aos repositórios com a palavra "cats" que têm 50 estrelas ou menos.

Use também consultas de intervalo para pesquisar valores maiores ou iguais a ou menores ou iguais a outro valor.

ConsultaExemplo
n..*
          **
          [cats stars:10..*](https://github.com/search?utf8=%E2%9C%93&q=cats+stars%3A10..*&type=Repositories)** é equivalente a `stars:>=10` e corresponde aos repositórios com a palavra "cats" que têm dez estrelas ou mais.

*..n | ** cats stars:*..10** é equivalente a stars:<=10 e corresponde aos repositórios com a palavra "cats" que têm dez estrelas ou menos.

Consultar por valores dentro de um intervalo

Use a sintaxe de intervalo n..n para pesquisar valores em um intervalo, em que o primeiro número N é o valor mais baixo e o segundo é o mais alto.

ConsultaExemplo
n..n
          **
          [cats stars:10..50](https://github.com/search?utf8=%E2%9C%93&q=cats+stars%3A10..50&type=Repositories)** corresponde aos repositórios com a palavra "cats" que têm entre dez e 50 estrelas.

Consulta de datas

Pesquise datas anteriores ou posteriores a outra data ou que estejam em um intervalo de datas, usando >, >=, <, <= e consultas de intervalo. A formatação de data precisa seguir o padrão ISO8601, que é YYYY-MM-DD (ano-mês-dia).

ConsultaExemplo
>YYYY-MM-DD** cats created:>2016-04-29** corresponde a problemas com a palavra "cats" que foram criados após 29 de abril de 2016.
>=YYYY-MM-DD** cats created:>=2017-04-01** corresponde aos problemas com a palavra "cats" que foram criados em 1º de abril de 2017 ou após essa data.
<YYYY-MM-DD** cats pushed:<2012-07-05** corresponde a repositórios com a palavra "cats" que foram enviados por push antes de 5 de julho de 2012.
<=YYYY-MM-DD** cats created:<=2012-07-04** corresponde a problemas com a palavra "cats" que foram criados em 4 de julho de 2012 ou antes dessa data.
YYYY-MM-DD..YYYY-MM-DD** cats pushed:2016-04-30..2016-07-04** corresponde a repositórios com a palavra "cats" que foram enviados por push entre o final de abril e julho de 2016.
YYYY-MM-DD..*
          **
          [cats created:2012-04-30..*](https://github.com/search?utf8=%E2%9C%93&q=cats+created%3A2012-04-30..*&type=Issues)** corresponde a questões criadas em ou após 30 de abril de 2012 que contenham a palavra "cats".

*..YYYY-MM-DD | ** cats created:*..2012-07-04** corresponde a problemas criados em 4 de julho de 2012 ou após contendo a palavra "cats".

Adicione também informações de hora THH:MM:SS+00:00 opcionais após a data, para fazer a pesquisa por hora, minuto e segundo. Isso é T, seguido de HH:MM:SS (hora-minutos-segundos) e uma diferença UTC (+00:00).

ConsultaExemplo
YYYY-MM-DDTHH:MM:SS+00:00** cats created:2017-01-01T01:00:00+07:00..2017-03-01T15:30:15+07:00** corresponde a problemas criados entre 1º de janeiro de 2017 à 1h. com uma diferença UTC de 07:00 e 1º de março de 2017 às 15h. com uma diferença UTC de 07:00.
YYYY-MM-DDTHH:MM:SSZ** cats created:2016-03-21T14:11:00Z..2016-04-07T20:45:00Z** corresponde a problemas criados entre 21 de março de 2016 às 14h11 e 7 de abril de 2016 às 20h45.

Excluir resultados que correspondam a um qualificador

Restrinja os resultados da pesquisa excluindo um ou mais subconjuntos. Para excluir todos os resultados correspondentes a um qualificador, adicione um hífen (-) como prefixo a qualquer qualificador de pesquisa.

ConsultaExemplo
-QUALIFIER
          **
          [
          `cats stars:>10 -language:javascript`
          ](https://github.com/search?q=cats+stars%3A>10+-language%3Ajavascript&type=Repositories)
          ** corresponde aos repositórios com a palavra "cats" que têm mais de dez estrelas, mas que não foram escritos em JavaScript.

-QUALIFIER | ** mentions:defunkt -org:github ** corresponde aos problemas que mencionam @defunkt e que não estão em repositórios na organização do GitHub.

Excluir resultados com palavras-chave específicas

É possível excluir os resultados que contêm determinada palavra usando a sintaxe NOT. O operador NOT só pode ser usado para palavras-chave de cadeia de caracteres. Ele não funciona com numerais ou datas.

ConsultaExemplo
NOT
          **
          [hello NOT world](https://github.com/search?q=hello+NOT+world&type=Repositories)** corresponde aos repositórios que têm a palavra "hello", mas não a palavra "world".

Usar aspas para consultas com espaço em branco

Se a consulta de pesquisa contém espaço em branco, é preciso colocá-lo entre aspas. Por exemplo:

  •           [cats NOT "hello world"](https://github.com/search?utf8=✓&q=cats+NOT+"hello+world"&type=Repositories) corresponde a repositórios com a palavra "cats", mas não com as palavras "hello world".
    
  •           [build label:"bug fix"](https://github.com/search?utf8=%E2%9C%93&q=build+label%3A%22bug+fix%22&type=Issues) corresponde a problemas com a palavra "build" que tem o rótulo "bug fix".
    

Consultas com nomes de usuário

Se a consulta de pesquisa tiver um qualificador que exija um nome de usuário, como user, actor ou assignee, será possível usar qualquer nome de usuário válido para especificar uma pessoa, @me para especificar o usuário atual ou @copilot para especificar o Copilot.

ConsultaExemplo
QUALIFIER:USERNAME author:nat corresponde aos commits criados por @nat
QUALIFIER:@me
          [
          `is:issue assignee:@me`
          ](https://github.com/search?q=is%3Aissue+assignee%3A%40me&type=Issues) corresponde aos problemas atribuídos à pessoa que está vendo os resultados |

| |

Só é possível usar @me ou @copilot com um qualificador, e não como um termo de pesquisa, como @me main.workflow.