JQL mit Arbeitstagen: Jira-Vorgänge finden, die in N Arbeitstagen fällig sind
English · Deutsch
Von Kayabyte · Aktualisiert am 11. November 2026
Kurz gesagt: JQL in Jira Cloud hat keine Funktionen für Arbeitstage. Relative Angaben wie duedate <= 5d und Funktionen wie endOfWeek() zählen Kalendertage, Wochenenden und Feiertage sind also eingeschlossen. Arbeitstage in JQL sind seit 2010 ein offener Wunsch (JRACLOUD-22506, über 350 Stimmen). Die Umwege: mit Kalendertagen großzügig rechnen oder ein Datum in der Automatisierung berechnen und in ein Feld schreiben. Daywise: Business Days & Holiday Calendars for Jira ergänzt JQL um businessDaysFromNow() und businessDaysAgo(), mit einem Kalender pro Team.
Typische Suchen:
- Arbeit, die in den nächsten 5 Arbeitstagen fällig ist.
- Anfragen, die seit 3 Arbeitstagen niemand angefasst hat.
- Vorgänge, die seit mehr als 10 Arbeitstagen offen sind.
Was JQL von Haus aus kann
JQL rechnet in Kalenderzeit:
duedate <= 7dfindet Arbeit, die in den nächsten 7 Kalendertagen fällig ist.duedate <= endOfWeek()findet Arbeit, die bis Ende dieser Woche fällig ist (der Wochenbeginn hängt von Ihren Jira-Einstellungen ab).updated <= -3dfindet Arbeit, die seit 3 Kalendertagen nicht aktualisiert wurde.
Kalendertage als Näherung. Fünf Arbeitstage sind meist sieben Kalendertage, duedate <= 7d passt also in einer normalen Woche. Um Feiertage herum stimmt es nicht, für Teams ohne Montag-bis-Freitag-Woche auch nicht, und der Fehler wächst mit N: 10 Arbeitstage sind nur dann 14 Kalendertage, wenn nichts dazwischen liegt. In Deutschland kommen Feiertage hinzu, die je Bundesland verschieden sind.
Umweg: die Automatisierung rechnen lassen
Die Jira-Automatisierung kennt Arbeitstage (Montag bis Freitag, ohne Feiertage) über die Smart Values plusBusinessDays und minusBusinessDays. Eine geplante Regel kann sie in ihrer JQL verwenden und passende Vorgänge markieren:
- Auslöser: Geplant, jeden Morgen, mit einer JQL-Suche wie
duedate <= "{{now.plusBusinessDays(5).format("yyyy-MM-dd")}}" AND statusCategory != Done. - Aktion: ein Label wie
faellig-5atsetzen oder ein Kontrollkästchen-Feld. - Eine zweite geplante Regel entfernt das Label von Arbeit, die nicht mehr passt.
Filter und Boards suchen dann nach labels = faellig-5at. Das funktioniert, aber:
- Feiertage und Betriebsferien werden ignoriert; Arbeitstage sind in der Automatisierung immer Montag bis Freitag.
- Eine Regel pro Frage (fällig in 5, liegt seit 3, offen seit 10), jede mit eigenem Label zum Aufräumen.
- Das Label ist nur so aktuell wie der letzte Lauf der Regel.
- Geplante Regeln zählen zu Ihrem Automatisierungskontingent.
Daywise: Arbeitstage in JQL
Daywise ist die App, die wir dafür entwickeln. Sie ergänzt zwei JQL-Funktionen und zwei durchsuchbare Felder, gezählt mit einem Kalender pro Team (Arbeitswoche, Arbeitszeiten, Zeitzone, Feiertage nach Land und Region, Betriebsferien):
duedate <= businessDaysFromNow(5): fällig innerhalb von fünf Arbeitstagen.created <= businessDaysAgo(10): vor mehr als zehn Arbeitstagen erstellt.- Mit Kalendername für ein bestimmtes Team:
duedate <= businessDaysFromNow(5, "Büro München"). - Felder Business days open und Business days to due date, zum Beispiel
"Business days to due date" < 0für überfällige Arbeit oder"Business days open" > 10.
Gut zu wissen: Die Funktionen liefern ein Datum, sie funktionieren also mit Datumsfeldern und den Operatoren =, !=, <, <=, > und >=. Jira speichert das Ergebnis jeder Funktion, und Daywise aktualisiert es stündlich und bei jeder Kalenderänderung. Die Feiertagsdaten stammen aus dem Open-Source-Projekt date-holidays; prüfen Sie die Vorschau der freien Tage für Ihren Kalender. Daywise ändert keine SLA-Kalender in Jira Service Management. Die App läuft auf Atlassian Forge, ruft nichts außerhalb von Atlassian auf, ihre Oberfläche ist auf Englisch, und sie ist im Atlassian Marketplace erhältlich.
Beispiele
| Frage | JQL von Haus aus (Kalendertage) | Mit Daywise |
|---|---|---|
| Fällig in 5 Arbeitstagen | duedate <= 7d (Näherung) |
duedate <= businessDaysFromNow(5) |
| Überfällig | duedate < now() |
"Business days to due date" < 0 |
| Vor mehr als 10 Arbeitstagen erstellt | created <= -14d (Näherung) |
created <= businessDaysAgo(10) |
| Seit 3 Arbeitstagen nicht aktualisiert | updated <= -3d (zählt Wochenenden mit) |
updated <= businessDaysAgo(3) |
FAQ
Hat JQL eine Funktion für Arbeitstage? Nicht in Jira Cloud. Das ist der offene Wunsch JRACLOUD-22506. Arbeitstage gibt es nur in Smart Values der Automatisierung.
Warum schließt duedate <= 5d das Wochenende ein? Relative Angaben in JQL sind Kalenderzeit; 5d bedeutet fünf Kalendertage ab jetzt.
Kann der Umweg über die Automatisierung Feiertage auslassen? Nein. Arbeitstage in der Automatisierung sind immer Montag bis Freitag, ohne Feiertagsliste.
Kann ich für verschiedene Teams verschiedene Feiertage verwenden? Von Haus aus nicht. Mit Daywise bekommt jedes Team einen Kalender, den Sie in der Funktion nennen oder einem Projekt zuordnen.
Jira und Atlassian sind Marken von Atlassian. Kayabyte ist ein unabhängiger Entwickler und weder mit Atlassian verbunden noch von Atlassian empfohlen oder unterstützt.