Compréhension de la syntaxe de recherche

Requête de valeurs supérieures ou inférieures à une autre valeur

Vous pouvez utiliser >, >=, < et <= pour rechercher des valeurs supérieures, supérieures ou égales, inférieures, et inférieures ou égales à une autre valeur.

Requête	Exemple
>n	cats stars:>1000 correspond aux dépôts contenant le mot «cats » qui ont plus de 1 000 étoiles.
>=n	cats topics:>=5 correspond aux dépôts contenant le mot «cats » qui ont au minimum 5 rubriques.
<n	cats size:<10000 correspond au code contenant le mot « cats » dans des fichiers d’une taille inférieure à 10 Ko.
<=n	cats stars:<=50 correspond aux dépôts contenant le mot «cats » qui ont au maximum 50 étoiles.

Vous pouvez également utiliser des requêtes de plage pour rechercher des valeurs supérieures ou égales, ou inférieures ou égales à une autre valeur.

Requête	Exemple
n..*	cats stars:10..* équivaut à stars:>=10 et correspond à des dépôts contenant le mot « cats » qui ont au minimum 10 étoiles.
*..n	cats stars:*..10 équivaut à stars:<=10 et correspond à des dépôts contenant le mot « cats » qui ont au maximum 10 étoiles.

Requête de valeurs comprises dans une plage

Vous pouvez utiliser la syntaxe de plage n..n pour rechercher des valeurs dans une plage, où le premier nombre N est la valeur la plus basse, et le second la valeur la plus élevée.

Requête	Exemple
n..n	cats stars:10..50 correspond aux dépôts contenant le mot «cats » qui ont entre 10 et 50 étoiles.

Requête de dates

Vous pouvez rechercher des dates antérieures ou postérieures à une autre date, ou qui s’inscrivent dans une plage de dates, en utilisant >, >=, <, <= et des requêtes de plage. La mise en forme de la date doit respecter la norme ISO8601, à savoir YYYY-MM-DD (année, mois, jour).

Requête	Exemple
>YYYY-MM-DD	cats created:>2016-04-29 correspond aux problèmes liés au mot « cats » qui ont été créés après le 29 avril 2016.
>=YYYY-MM-DD	cats created:>=2017-04-01 correspond aux problèmes liés au mot « cats », qui ont été créés à partir du 1 avril 2017.
<YYYY-MM-DD	cats pushed:<2012-07-05 correspond aux dépôts contenant le mot « cats » qui ont été poussés (push) avant le 5 juillet 2012.
<=YYYY-MM-DD	cats created:<=2012-07-04 correspond aux problèmes liés au mot « cats », qui ont été créés jusqu’au 4 avril 2012.
YYYY-MM-DD..YYYY-MM-DD	cats pushed:2016-04-30..2016-07-04 correspond aux dépôts contenant le mot « cats » qui ont été envoyés (push) jusqu’à la fin des mois d’avril et de juillet 2016.
YYYY-MM-DD..*	cats created:2012-04-30..* correspond aux problèmes créés le 30 avril 2012 ou après cette date, contenant le mot « cats ».
*..YYYY-MM-DD	cats created:*..2012-07-04 correspond aux problèmes créés le 4 juillet 2012 ou avant cette date, contenant le mot « cats ».

Vous pouvez également ajouter des informations facultatives d’heure THH:MM:SS+00:00 après la date, pour rechercher par heure, minute et seconde. Il s’agit de T, suivi de HH:MM:SS (heures-minutes-secondes) et d’un décalage UTC (+00:00).

Requête	Exemple
YYYY-MM-DDTHH:MM:SS+00:00	cats created:2017-01-01T01:00:00+07:00..2017-03-01T15:30:15+07:00 correspond aux problèmes créés entre le 1 janvier 2017 à 1 h avec un décalage UTC de 07:00 et le 1 mars 2017 à 15 h. avec un décalage UTC de 07:00.
YYYY-MM-DDTHH:MM:SSZ	cats created:2016-03-21T14:11:00Z..2016-04-07T20:45:00Z correspond aux problèmes créés entre le 21 mars 2016 à 14h11 et le 7 avril 2016 à 20h45.

Exclure les résultats qui correspondent à un qualificateur

Vous pouvez affiner les résultats de la recherche en excluant un ou plusieurs sous-ensembles. Pour exclure tous les résultats correspondant à un qualificateur, préfixez n’importe quel qualificateur de recherche avec un tiret (-).

Requête	Exemple
-QUALIFIER	cats stars:>10 -language:javascript correspond aux dépôts contenant le mot « cats », qui ont plus de 10 étoiles mais ne sont pas écrits en JavaScript.
-QUALIFIER	mentions:defunkt -org:github correspond aux problèmes indiquant @defunkt qui ne figurent pas dans des dépôts au sein de l’organisation GitHub.

Exclure des résultats avec des mots clés spécifiques

Vous pouvez exclure des résultats contenant un certain mot à l’aide de la syntaxe NOT. L’opérateur NOT ne peut être utilisé que pour des mots clés de type chaîne. Il ne fonctionne pas pour des chiffres ou des dates.

Requête	Exemple
NOT	hello NOT world correspond aux dépôts contenant le mot « hello », mais pas le mot « world ».

Utiliser des guillemets pour les requêtes contenant un espace blanc

Si votre requête de recherche contient un espace blanc, vous devez l’entourer de guillemets. Par exemple :

• cats NOT "hello world" correspond aux dépôts contenant le mot « cats » mais pas les mots « hello world ».
• build label:"bug fix" correspond aux problèmes liés au mot « build », qui ont l’étiquette « bug fix ».

Requêtes avec des noms d’utilisateur

Si votre demande de recherche contient un qualificatif qui requiert un nom d'utilisateur, tel que user, actor, ou assignee, vous pouvez utiliser n'importe quel nom d'utilisateur pour spécifier une personne spécifique, @me pour spécifier l'utilisateur actuel, ou @copilot pour spécifier Copilot.

Requête	Exemple
QUALIFIER:USERNAME	author:nat correspond aux validations créées par @nat
QUALIFIER:@me	is:issue assignee:@me correspond aux problèmes attribués à la personne qui affiche les résultats
QUALIFIER:@copilot	is:pr reviewed-by:@copilot correspond aux demandes de tirage examinées par Copilot. Pour plus d’informations, consultez « Utiliser la revue de code GitHub Copilot ».

Vous ne pouvez utiliser @me ou @copilot qu'avec un qualificatif, et non comme terme de recherche, tel que @me main.workflow.