Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Entender a sintaxe de pesquisa

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

Neste artigo

Esse documento ajudou você?

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.

Consultar por valores maiores ou menores que outro valor

Você pode usar >, >=, < e <= para pesquisar valores que sejam maiores, maiores ou iguais, menores e menores ou iguais a outro valor.

ConsultaExemplo
>ncats stars:>1000 corresponde a repositórios com a palavra "cats" com mais de 1000 estrelas.
>=ncats topics:>=5 corresponde a repositórios com a palavra "cats" com 5 ou mais tópicos.
<ncats size:<10000 corresponde ao código com a palavra "cats" nos arquivos com tamanho inferior a 10 KB.
<=ncats stars:<=50 corresponde a repositórios com a palavra "cats" com 50 estrelas ou menos.

Você também pode usar consultas de intervalo para pesquisar valores que são maiores ou iguais ou menores ou iguais a outro valor.

ConsultaExemplo
n..*cats stars:10..* é equivalente a stars:>=10 e corresponde a repositórios com a palavra "cats" que têm até 10 estrelas.
*..ncats stars:*..10 é equivalente a stars:<=10 e corresponde a repositórios com a palavra "cats" que têm até 10 estrelas.

Consultar por valores dentro de um intervalo

Você pode usar a sintaxe de intervalo n..n para pesquisar valores dentro de um intervalo, em que o primeiro número n é o valor mais baixo e o segundo é o valor mais alto.

ConsultaExemplo
n..ncats stars:10..50 corresponde a repositórios com a palavra "cats" que têm entre 10 e 50 estrelas.

Consultar por datas

Você pode usar >, >=, <, <= e consultas de intervalo para pesquisar por datas anteriores ou posteriores a outra data ou que se enquadram em um intervalo de datas. O formato de data deve seguir o padrão ISO8601, que é YYYY-MM-DD (ano-mês-dia).

ConsultaExemplo
>YYYY-MM-DDcats created:>2016-04-29 corresponde a problemas com a palavra "cats" que foram criados após 29 de abril de 2016.
>=YYYY-MM-DDcats created:>=2017-04-01 corresponde a problemas com a palavra "cats" que foram criados a partir de 1 de abril de 2017.
<YYYY-MM-DDcats pushed:<2012-07-05 corresponde ao código com a palavra "cats" em repositórios que foram carregados até 5 de julho de 2012.
<=YYYY-MM-DDcats created:<=2012-07-04 corresponde a problemas com a palavra "cats" que foram criados em ou antes de 4 de julho de 2012.
YYYY-MM-DD..YYYY-MM-DDcats pushed:2016-04-30..2016-07-04 corresponde a repositórios com a palavra "cats" nos quais foi feito push entre o final de abril e julho de 2016.
YYYY-MM-DD..*cats created:2012-04-30..* corresponde a problemas criados após 30 de abril de 2012 contendo a palavra "cats".
*..YYYY-MM-DDcats created:*..2012-04-30 corresponde a problemas criados antes de 4 de julho de 2012 contendo a palavra "cats".

Você também pode adicionar informações de tempo opcionais THH:MM:SS+00:00 após a data, para pesquisar por hora, minuto e segundo. Isso se faz adicionando T, seguido de HH:MM:SS (hora-minutos-segundos) e um intervalo de 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 a problemas criados entre 01 de janeiro de 2017 à 1h, com uma diferença de fuso horário de 07:00 em relação ao UTC, e 01 de março de 2017 às 15h, com uma diferença de fuso horário de 07:00 em relação ao UTC. com um ajuste de UTC de 07:00 e 1 de março de 2017 às 15h. com um ajuste de UTC de 07:00.
YYYY-MM-DDTHH:MM:SSZcats 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 07 de abril de 2106 às 20h45.

Excluir determinados resultados

Usando a sintaxe NOT, é possível excluir resultados contendo uma determinada palavra. O operador NOT só pode ser usado para palavras-chave de string. Ele não funciona com numerais ou datas.

ConsultaExemplo
NOThello NOT world corresponde a repositórios que têm a palavra "hello", mas não a palavra "world".

Outra maneira de restringir os resultados da pesquisa é excluir determinados subconjuntos. Adicione um prefixo a qualquer qualificador de pesquisa com um - para excluir todos os resultados correspondentes a esse qualificador.

ConsultaExemplo
-QUALIFIERcats stars:>10 -language:javascript corresponde a repositórios com a palavra "cats" com mais de 10 estrelas mas não estão escritos em JavaScript.
mentions:defunkt -org:github corresponde a problemas mencionando @defunkt que não estão em repositórios na organização do GitHub.

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:

Alguns símbolos não alfanuméricos, como espaços, são descartados de consultas de pesquisa de código entre aspas, por isso os resultados podem ser inesperados.

Consultas com nomes de usuário

Se sua consulta de pesquisa contiver um qualificador que exige um nome de usuário, como, por exemplo, usuário, ator ou responsável, você poderá usar qualquer nome de usuário de GitHub, para especificar uma pessoa específica ou @me para especificar o usuário atual.

ConsultaExemplo
QUALIFIER:USERNAMEauthor:nat corresponde a commits criados por @nat
QUALIFIER:@meis:issue assignee:@me corresponde a problemas atribuídos à pessoa que está visualizando os resultados

Você só pode usar @me com um qualificador e não como termo de pesquisa, como @me main.workflow.

Esse documento ajudou você?

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.