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:

Was JQL von Haus aus kann

JQL rechnet in Kalenderzeit:

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:

  1. Auslöser: Geplant, jeden Morgen, mit einer JQL-Suche wie duedate <= "{{now.plusBusinessDays(5).format("yyyy-MM-dd")}}" AND statusCategory != Done.
  2. Aktion: ein Label wie faellig-5at setzen oder ein Kontrollkästchen-Feld.
  3. 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:

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):

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.