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 AUTOTITLE.

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
>ncats stars:>1000 corresponde aos repositórios com a palavra "cats" que têm mais de mil estrelas.
>=ncats topics:>=5 corresponde aos repositórios com a palavra "cats" que têm cinco tópicos ou mais.
<ncats size:<10000 encontra correspondências de código que contém a palavra "cats" em arquivos com menos de 10 KB.
<=ncats stars:<=50 corresponde aos repositórios que contêm a palavra "cats" e 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..* é equivalente a e corresponde aos repositórios com a palavra "cats" que têm dez estrelas ou mais.
*..ncats stars:*..10 é equivalente a 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 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..ncats stars:10..50 encontra repositórios com a palavra "cats" que têm entre 10 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-DDcats created:>2016-04-29 corresponde aos problemas com a palavra "cats" que foram criados após 29 de abril de 2016.
>=YYYY-MM-DDcats 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-DDcats 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-DDcats created:<=2012-07-04 corresponde aos problemas com a palavra "cats" que foram criados em 4 de julho de 2012 ou antes dessa data.
YYYY-MM-DD..YYYY-MM-DDcats pushed:2016-04-30..2016-07-04 corresponde aos 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..* corresponde aos problemas criados em 30 de abril de 2012 ou após contendo a palavra "cats".
*..YYYY-MM-DDcats created:*..2012-07-04 corresponde aos 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:00cats created:2017-01-01T01:00:00+07:00..2017-03-01T15:30:15+07:00 corresponde aos problemas criados entre 1° de janeiro de 2017 à 1h. com uma diferença UTC de e 1º de março de 2017 às 15h. com uma diferença UTC de .
YYYY-MM-DDTHH:MM:SSZcats created:2016-03-21T14:11:00Z..2016-04-07T20:45:00Z corresponde aos 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
-QUALIFIERencontra repositórios que contenham a palavra "cats" e que tenham mais de 10 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 . O operador só pode ser usado para palavras-chave de cadeia de caracteres. Ele não funciona com numerais ou datas.

ConsultaExemplo
NOThello NOT world encontra os 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" corresponde aos repositórios com a palavra "cats", mas não com as palavras "hello world".
  • build label:"bug fix" corresponde aos 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 , ou , será possível usar qualquer nome de usuário válido para especificar uma pessoa, para especificar o usuário atual ou para especificar o Copilot.

ConsultaExemplo
QUALIFIER:USERNAMEcorresponde aos commits criados por
QUALIFIER:@mecorresponde aos problemas atribuídos à pessoa que está vendo os resultados

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