Grundlagen der Suchsyntax
Für Suchen auf GitHub Enterprise können Sie Abfragen erstellen, die nach bestimmten alphanumerischen Zeichenfolgen suchen.
Inhalt dieses Artikels
- Abfrage nach Werten mit einem Vergleichsoperator
- Abfrage nach Werten innerhalb eines Wertebereichs
- Abfrage nach Datums- und Zeitangaben
- Ausschluss bestimmter Ergebnisse
- Anführungszeichen für Abfragen nach Zeichenfolgen mit Leerzeichen
Abfrage nach Werten mit einem Vergleichsoperator
Mit >, >=, < und <= können Sie nach Werten suchen, die größer, größer oder gleich, kleiner oder kleiner oder gleich einem anderen Wert sind.
| Abfrage | Beispiel |
|---|---|
>n |
cats stars:>1000 sucht Repositorys, die das Wort „cats“ enthalten und 1000 Sterne haben. |
>=n |
cats topics:>=5 sucht Repositorys, die das Wort „cats“ enthalten und mindestens fünf Themen haben. |
<n |
cats size:<10000 sucht Code, der das Wort „cats“ in Dateien enthält, die kleiner als 10 KB sind. |
<=n |
cats stars:<=50 sucht Repositorys, die das Wort „cats“ enthalten und höchstens 50 Sterne haben. |
Auch mit Bereichsabfragen können Sie nach Werten suchen, die größer oder gleich bzw. kleiner oder gleich einem anderen Wert sind.
| Abfrage | Beispiel |
|---|---|
n..* |
cats stars:10..*
entspricht stars:>=10 und sucht Repositorys, die das Wort „cats“ enthalten und mindestens 10 Sterne haben. |
*..n |
cats stars:*..10
entspricht 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 können Sie nach Werten innerhalb eines Wertebereichs suchen. Dabei ist der erste Wert n die untere und der zweite Wert <2>n</2> die obere Grenze des gesuchten Bereichs.
| Abfrage | Beispiel |
|---|---|
n..n |
cats 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 können Sie nach Datums- und Zeitangaben vor oder nach einem bestimmten Datum/Uhrzeit oder innerhalb eines Datums-/Zeitbereichs suchen. Date formatting must follow the ISO8601 standard, which is YYYY-MM-DD (year-month-day).
| Abfrage | Beispiel |
|---|---|
>YYYY-MM-DD |
cats created:>2016-04-29 sucht Issues, die das Wort „cats“ enthalten und nach dem 29. April 2016 erstellt wurden. |
>=YYYY-MM-DD |
cats created:>=2017-04-01 sucht Issues, die das Wort „cats“ enthalten und am oder nach dem 1. April 2017 erstellt wurden. |
<YYYY-MM-DD |
cats pushed:<2012-07-05 sucht Code mit dem Wort „cats“ in Repositorys, in die vor dem 5. Juli 2012 ein Push erfolgt ist. |
<=YYYY-MM-DD |
cats created:<=2012-07-04 sucht Issues, die das Wort „cats“ enthalten und am oder vor dem 4. Juli 2012 erstellt wurden. |
YYYY-MM-DD..YYYY-MM-DD |
cats pushed:2016-04-30..2016-07-04 sucht Repositorys, die das Wort „cats“ enthalten und in die 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-DD |
cats created:*..2012-04-30 sucht Issues, die das Wort „cats“ enthalten und vor dem 30. April 2012 erstellt wurden. |
You can also add optional time information THH:MM:SS+00:00 after the date, to search by the hour, minute, and second. That's T, followed by HH:MM:SS (hour-minutes-seconds), and a UTC offset (+00:00).
| Abfrage | Beispiel |
|---|---|
YYYY-MM-DDTHH:MM:SS+00:00 |
cats 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. |
YYYY-MM-DDTHH:MM:SSZ |
cats 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 können Sie 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.
| Abfrage | Beispiel |
|---|---|
NOT |
hello NOT world sucht Repositorys, die das Wort „hello“, aber nicht das Wort „world“ enthalten. |
Ebenso können Sie Ihre Abfrageergebnisse durch Ausschluss bestimmter Teilmengen eingrenzen. Sie können jedem Suchkennzeichner ein - voranstellen, um Ergebnisse auszuschließen, die mit diesem Kennzeichner übereinstimmen.
| Abfrage | Beispiel |
|---|---|
-KENNZEICHNER |
cats stars:>10 -language:javascript sucht Repositorys, die das Wort „cats“ enthalten und 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 Ihre Suchabfrage Leerzeichen enthält, müssen Sie 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.