Grundlagen der Suchsyntax

Für Suchen auf GitHub Enterprise Server können Sie Abfragen erstellen, die nach bestimmten alphanumerischen Zeichenfolgen suchen.

Abfrage nach Werten mit einem Vergleichsoperator

Mit >, >=, < und <= kannst Du nach Werten suchen, die größer, größer oder gleich, kleiner, oder kleiner oder gleich einem anderen Wert sind.

AbfrageBeispiel
>ncats stars:>1000 findet Repositorys mit dem Wort „cats" und mehr als 1.000 Sternen.
>=ncats topics:>=5 findet Repositorys mit dem Wort „cats", welche 5 oder mehr Themen haben.
<ncats size:<10000 findet Code mit dem Wort „cats" in Dateien, die kleiner als 10 KB sind.
<=ncats stars:<=50 findet Repositorys mit dem Wort „cats" mit 50 oder weniger Sternen.

Auch mit Bereichsabfragen kannst Du nach Werten suchen, die größer oder gleich respektive kleiner oder gleich einem anderen Wert sind.

AbfrageBeispiel
n..*cats stars:10..* ist gleichbedeutend mit stars:>=10 und sucht Repositorys, die das Wort „cats“ enthalten und mindestens 10 Sterne haben.
*..ncats stars:*..10 ist gleichbedeutend mit stars:<=10 und sucht Repositorys, die das Wort „cats“ enthalten und höchstens 10 Sterne haben.

Abfrage nach Werten innerhalb eines Wertebereichs

Mit der Bereichssyntax n..n kannst Du nach Werten innerhalb eines Wertebereichs suchen. Dabei ist der erste Wert n die untere und der zweite Wert die obere Grenze des gesuchten Bereichs.

AbfrageBeispiel
n..ncats stars:10..50 sucht Repositorys, die das Wort „cats“ enthalten und zwischen 10 und 50 Sternen haben.

Abfrage nach Datums- und Zeitangaben

Mit >, >=, <, <= und Bereichsabfragen kannst Du nach Datums- und Zeitangaben vor oder nach einem bestimmten Datum/Uhrzeit oder innerhalb eines Datums-/Zeitbereichs suchen. Die Datumsformatierung muss dem ISO8601-Standard entsprechen, der YYYY-MM-DD (Jahr-Monat-Tag) ist.

AbfrageBeispiel
>YYYY-MM-DDcats created:>2016-04-29 findet Issues mit dem Wort „cats", die nach dem 29. April 0216 erstellt wurden.
>=YYYY-MM-DDcats created:>=2017-04-01 findet Issues mit dem Wort „cats", welche am oder nach dem 1. April 2017 erstellt wurden.
<YYYY-MM-DDcats pushed:<2012-07-05 findet Code mit dem Wort „cats" in Repositorys, die vor dem 5. Juli 2012 übertragen wurden.
<=YYYY-MM-DDcats created:<=2012-07-04 findet Issues mit dem Wort „cats", die am oder vor dem 4. Juli 2012 erstellt wurden.
YYYY-MM-DD..YYYY-MM-DDcats pushed:2016-04-30..2016-07-04 sucht Repositorys, die das Wort „cats“ enthalten und zu denen zwischen dem 30. April und dem 4. Juli 2016 ein Push erfolgt ist.
YYYY-MM-DD..*cats created:2012-04-30..* sucht Issues, die das Wort „cats“ enthalten und nach dem 30. April 2012 erstellt wurden.
*..YYYY-MM-DDcats created:*..2012-07-04 sucht Issues, die das Wort „cats“ enthalten und vor dem 30. April 2012 erstellt wurden.

Du kannst nach dem Datum auch optionale Zeitinformationen THH:MM:SS+00:00 hinzufügen, um nach der Stunde, Minute und Sekunde zu suchen. Das ist T, gefolgt von HH:MM:SS (Stunden:Minuten:Sekunden) und einem UTC-Offset (+00:00).

AbfrageBeispiel
YYYY-MM-DDTHH:MM:SS+00:00cats created:2017-01-01T01:00:00+07:00..2017-03-01T15:30:15+07:00 sucht Issues, die zwischen 1. Januar 2017, 01:00 Uhr (mit einer UTC-Verschiebung von 07:00 Stunden), und 1. März 2017, 15:30 Uhr (mit ebenfalls einer UTC-Verschiebung von 07:00 Stunden), erstellt wurden. with a UTC offset of 07:00 and March 1, 2017 at 3 p.m. with a UTC offset of 07:00.
YYYY-MM-DDTHH:MM:SSZcats created:2016-03-21T14:11:00Z..2016-04-07T20:45:00Z sucht Issues, die zwischen 21. März 2016, 14:11 Uhr, und 7. April 2016, 20:45 Uhr, erstellt wurden.

Ausschluss bestimmter Ergebnisse

Mit der Syntax NOT kannst Du Ergebnisse, die ein bestimmtes Wort enthalten, aus den Abfrageergebnissen ausschließen. Der Operator NOT kann nur für Zeichenfolgen verwendet werden. Mit Zahlen oder Datumsangaben funktioniert er nicht.

AbfrageBeispiel
NOThello NOT world sucht Repositorys, die das Wort „hello“, aber nicht das Wort „world“ enthalten.

Ebenso kannst du Deine Abfrageergebnisse durch Ausschluss bestimmter Teilmengen eingrenzen. Du kannst jedem Qualifizierer ein - voranstellen, um Ergebnisse auszuschließen, die mit diesem Qualifizierer übereinstimmen.

AbfrageBeispiel
-KENNZEICHNERcats stars:>10 -language:javascript findet Repositorys mit dem Wort „cats", die mehr als 10 Sterne haben, aber nicht in JavaScript geschrieben sind.
mentions:defunkt -org:github sucht Issues, die „@defunkt“ erwähnen, aber nicht in Repositorys der Organisation GitHub enthalten sind.

Anführungszeichen für Abfragen nach Zeichenfolgen mit Leerzeichen

Wenn Deine Suchabfrage Leerzeichen enthält, musst du die gesuchte Zeichenfolge in Anführungszeichen einschließen. Ein Beispiel:

  • cats NOT "hello world" sucht Repositorys, die das Wort „cats“ enthalten, aber nicht die Wörter „hello world“.
  • build label:"bug fix" sucht Issues, die das Wort „build“ enthalten und die Kennzeichnung „bug fix“ aufweisen.

Bei Suchabfragen innerhalb von Code werden einige nicht alphanumerische Zeichen, so auch Leerzeichen, ignoriert, selbst wenn der Suchstring in Anführungszeichen steht. Dies führt oft nicht zum erwünschten Ergebnis.

Abfragen mit Benutzernamen

Wenn Deine Abfrage einen Qualifizierer verwendet, der einen Benutzernamen verlangt, beispielsweise user, actor, oder assignee, kannst du jeden GitHub Enterprise Server-Benutzernamen verwenden, um eine spezifische Person anzugeben oder @me benutzen, um den aktuellen Benutzer anzugeben.

AbfrageBeispiel
QUALIFIER:USERNAMEauthor:nat findet Commits, die von @nat verfasst wurden
QUALIFIER:@meis:issue assignee:@me findet Issues, die der Person zugewiesen sind, die die Suchresultate anschaut

Du kannst @me nur mit einem Qualifizierer verwenden und nicht als eigenen Suchbegriff, wie etwa @me main.workflow.

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Oder, learn how to contribute.