Zeiträume & Ziele

Jeder KPI hat einen Zielwert und einen Zeitraum. Aus beiden zusammen entstehen die Ideal-Linie, der Ampel-Status und das Abweichungs-Badge auf dem Dashboard. Diese Seite zeigt genau, wie die beiden Zeitraum-Grenzen entstehen, was passiert, wenn ein Monat oder Quartal endet, und warum derselbe Zielwert je nach KPI-Typ zwei verschiedene Dinge bedeutet.

Die vier Zeitraum-Typen

Den Zeitraum wählst du im KPI-Dialog, im Abschnitt Ziel, über das Dropdown Zeitraum. Es gibt vier Optionen und keine weiteren.

Option	Anfang	Ende	Länge
Jahr	1. Januar des laufenden Jahres	31. Dezember des laufenden Jahres	365 oder 366 Tage
Monat	1. des laufenden Kalendermonats	letzter Tag dieses Monats	28–31 Tage
Quartal	erster Tag des laufenden Kalenderquartals	letzter Tag dieses Quartals	90–92 Tage
Benutzerdefiniert	das eingetragene Startdatum	das eingetragene Enddatum	frei

Das Quartal ergibt sich aus der aktuellen Monatsnummer: Monat 1–3 ergibt 1. Januar – 31. März, Monat 4–6 ergibt 1. April – 30. Juni und so weiter. Ausschließlich Kalenderquartale.

Jahr, Monat und Quartal beziehen sich immer auf das heutige Datum deines Macs. Keiner der drei lässt sich auf den Vormonat, das Vorjahr oder ein Geschäftsjahr richten, das nicht am 1. Januar beginnt. Dafür gibt es nur den benutzerdefinierten Zeitraum.

Benutzerdefinierter Zeitraum

Mit Benutzerdefiniert erscheinen zwei zusätzliche Felder: Startdatum und Enddatum. Beides sind Datumsfelder, beide sind Pflicht. Das Maximum des Startfelds ist an das Enddatum gebunden und das Minimum des Endfelds an das Startdatum — die beiden können sich also nicht überkreuzen.

Zwei Fehlermeldungen blockieren das Speichern:

• Start- und Enddatum wählen — eines der beiden Felder ist noch leer.
• Enddatum muss am oder nach dem Startdatum liegen — der Zeitraum läuft rückwärts. Ein Ein-Tages-Zeitraum (dasselbe Datum in beiden Feldern) ist erlaubt.

Stellst du den KPI später zurück auf Jahr, Monat oder Quartal, werden die beiden gespeicherten Daten beim Speichern gelöscht. Zurück auf Benutzerdefiniert heißt: neu eintragen.

Ein unvollständiger benutzerdefinierter Zeitraum

Das Formular lässt einen benutzerdefinierten Zeitraum mit nur einem Datum nicht speichern. Landet eine Definition trotzdem in diesem Zustand — über einen Import oder weil kpi-definitions.json von Hand bearbeitet wurde —, fällt sie kommentarlos auf das laufende Kalenderjahr zurück: 1. Januar bis 31. Dezember, und als Suffix steht auf der Karte /Jahr statt einer Datumsspanne. Wenn ein KPI /Jahr zeigt, wo du eine Spanne erwartest, ist genau das passiert.

Liegt das Enddatum vor dem Startdatum (gleicher Weg: Import oder Handarbeit, nie über das Formular), schrumpft der Zeitraum auf einen einzigen Tag.

Das Formular für den ersten KPI beim ersten Start bietet nur Jahr, Quartal und Monat an. Für einen benutzerdefinierten Zeitraum legst du den KPI dort an und bearbeitest ihn danach — oder du legst ihn direkt vom Dashboard aus an.

Wie die Länge eines Zeitraums gezählt wird

Die Länge — totalDays — ist die Anzahl ganzer Kalendertage vom Startdatum bis zum Enddatum, beide Tage eingeschlossen. Kürzer als ein Tag wird ein Zeitraum nie.

• 2026 ist kein Schaltjahr, Jahr sind also 365 Tage: 1. Januar bis 31. Dezember.
• Monat sind im Juli 31 Tage, im Februar 2026 sind es 28.
• Quartal Q1 2026 sind 90 Tage (1. Januar – 31. März), Q3 sind 92 Tage (1. Juli – 30. September).
• Ein benutzerdefinierter Zeitraum vom 1. März bis 30. Juni sind 122 Tage. Vom 1. März bis 1. März ist es 1 Tag, nicht 0.

Gezählt wird über Jahr, Monat und Tag in deiner lokalen Zeitzone, nicht über verstrichene Millisekunden. Das ist Absicht: Ein Zeitraum über eine Zeitumstellung hinweg enthält einen 23-Stunden- und einen 25-Stunden-Tag, eine Millisekunden-Rechnung wäre an der Grenze um einen Tag daneben. In Pulsaria kosten die Umstellungen im März und Oktober keinen Tag und schenken auch keinen.

Alle Daten sind lokale Kalendertage. Ein reines YYYY-MM-DD wird als lokale Mitternacht gelesen, ein Zeitraum verschiebt sich also nicht je nach Zeitzone um einen Tag.

Was beim Wechsel in den nächsten Zeitraum passiert

Zeitraum-Grenzen werden nicht gespeichert. Sie werden bei jedem Rendern neu aus dem heutigen Datum berechnet. Es gibt keinen geplanten Job, keine Migration und damit auch nichts, was beim Wechsel schiefgehen könnte.

Um lokale Mitternacht am Monatsersten wird das Fenster eines Monats-KPI zum neuen Monat. Konkret:

1. Anfang, Ende und totalDays sind die des neuen Monats.
2. Bei einem kumulativen Ziel fällt das Ideal am ersten Tag auf 0 zurück und steigt von dort neu.
3. Das kleine Diagramm auf der KPI-Karte umfasst immer den ganzen Zeitraum von Anfang bis Ende — die Punkte des Vormonats sind dort also nicht mehr zu sehen.
4. Das große Diagramm auf der KPI-Detailseite reicht nie vor den Zeitraum-Anfang zurück, egal ob du 7T, 30T oder 90T wählst.

Was beim Wechsel nicht passiert:

• Deine erfassten Werte werden nicht zurückgesetzt, archiviert oder je Zeitraum gefiltert. Der Verlauf eines KPI ist eine durchgehende Reihe.
• Der aktuelle Wert ist immer der zuletzt erfasste Wert, ohne Ausnahme. Ist dein letzter Eintrag vom 28. Juli und du öffnest die Karte am 3. August, steht diese Juli-Zahl weiterhin als aktueller Wert da — und wird gegen das August-Ideal bewertet.
• Der Zielwert wird nicht übertragen, verdoppelt oder zurückgesetzt. Ein KPI hat genau einen Zielwert, und der gilt für den jeweils laufenden Zeitraum.

Am ersten Tag eines Zeitraums ist das Ideal eines kumulativen KPI exakt 0. Bei „Höher ist besser“ ist damit an diesem einen Tag jeder nicht-negative Wert Im Plan. Das Abweichungs-Badge auf der Dashboard-Karte wird ausgeblendet, solange das Ideal 0 ist; die Pill auf der KPI-Detailseite nicht — dort steht dann +0% vs. Ideal.

Wie der Zielwert gelesen wird: kumulativ oder wiederkehrend

Direkt unter dem Zeitraum steht KPI-Typ mit zwei Karten. Die Wahl ändert den Zielwert nicht — sie ändert, womit er an einem bestimmten Tag verglichen wird.

Kumulatives Ziel

Wert summiert sich zum Ziel (z.B. Umsatz). Der Zielwert ist der Endpunkt, den du bis zum Ende des Zeitraums erreichen willst. Die Ideal-Linie steigt linear von 0 auf den Zielwert:

Ideal(Datum) = Zielwert ÷ totalDays × verstrichene Tage seit Zeitraum-Anfang

Der erste Tag zählt als null verstrichene Tage, das Ideal startet also bei 0. Am letzten Tag des Zeitraums liegt es bei Zielwert × (totalDays − 1) ÷ totalDays — in einem 31-Tage-Monat sind das 96,77 % des Zielwerts. Den vollen Zielwert erreicht die Linie erst am Tag nach dem Zeitraum-Ende. Ein KPI, der sein Ziel genau am letzten Tag trifft, steht deshalb leicht über dem Ideal, nicht exakt darauf.

Die Beschriftungen folgen dieser Wahl: In der Fußzeile der Karte steht ideal: …, das Abweichungs-Badge sagt vs. Ideal, und die Diagramm-Legende zeigt Ideal-Trend.

Wiederkehrender Wert

Je Periode ein neuer Messwert gegen einen Zielwert (z.B. MAU). Der Zielwert ist eine feste Messlatte. Das Ideal ist an jedem Tag des Zeitraums der Zielwert — keine Rampe, keine Summierung.

Der Zeitraum bleibt trotzdem relevant: Er bestimmt das Fenster, das die Diagramme zeichnen, und das Kürzel neben dem Zielwert. Er skaliert nur das Ideal nicht mehr.

Hier steht in der Fußzeile Ziel: …, das Abweichungs-Badge sagt vs. Ziel, und Legende wie Tooltip zeigen Ziel.

Voreingestellt ist Kumulatives Ziel. Bei Connector-KPIs wird der Typ aus der gewählten Metrik der Connector-Library vorbelegt, zusammen mit Einheit, Richtung, Zeitraum und Zeitplan. Das Erste-KPI-Formular im Onboarding hat gar kein KPI-Typ-Feld — was dort entsteht, ist immer kumulativ. Die Starter-Pakete auf demselben Schritt setzen den Typ dagegen pro KPI.

Wechselst du bei einem bestehenden KPI den Typ, wird sein gesamter Verlauf gegen die neue Ideal-Linie neu bewertet. Beim Ändern des Zielwerts gilt dasselbe: Es gibt keine Zielwert-Historie, jeder vergangene Tag wird so nachgerechnet, als hätte die neue Zahl schon immer gegolten.

Ein durchgerechnetes Beispiel

Ein KPI Umsatz, Einheit EUR, Zielwert 12000, Richtung Höher ist besser, Zeitraum Monat, Typ Kumulatives Ziel. Heute ist der 25. Juli 2026.

Der Zeitraum ist der 1. bis 31. Juli 2026, totalDays ist also 31 und ein Tagesanteil am Ziel beträgt 12000 ÷ 31 = 387,10 EUR.

Datum	Verstrichene Tage	Ideal
1. Jul	0	0,00 EUR
10. Jul	9	3.483,87 EUR
25. Jul	24	9.290,32 EUR
31. Jul	30	11.612,90 EUR
1. Aug	—	0,00 EUR (neuer Zeitraum)

Angenommen, dein letzter Eintrag lautet 9000. Am 25. Juli zeigt die Karte dann:

• Fußzeile links: 12.000 EUR/Monat. Fußzeile rechts: ideal: 9.290 EUR — die Einheit EUR wird ab 1.000 ohne Nachkommastellen ausgegeben.
• Abweichungs-Badge: Die Differenz ist 9000 − 9290,32 = −290,32, also 3,1 % des Ideals. Das Badge zeigt -3% vs. Ideal in Amber (dahinter, aber weniger als 10 %).
• Status: 9000 liegt über 90 % des Ideals (8.361,29), aber unter dem Ideal selbst — der Punkt ist amber, das Badge sagt Gefährdet.

Derselbe KPI als Wiederkehrender Wert beantwortet eine andere Frage. Das Ideal ist an jedem Julitag 12.000 EUR, 9000 liegt also 25 % darunter: Das Badge zeigt -25% vs. Ziel in Rot, der Status ist Aus dem Plan, weil der Wert unter 90 % der Messlatte liegt. Kumulativ fragt habe ich diesen Monat bisher 12.000 verdient?, wiederkehrend fragt stehe ich gerade bei 12.000?

Wo der Zeitraum in der Oberfläche auftaucht

Das Zeitraum-Kürzel steht direkt hinter der Einheit, ohne Leerzeichen — in der Fußzeile der KPI-Karte und in der Ziel-Pill auf der KPI-Detailseite:

Zeitraum	Kürzel	Beispiel
Jahr	/Jahr	50.000 EUR/Jahr
Monat	/Monat	12.000 EUR/Monat
Quartal	/Quartal	15.000 EUR/Quartal
Benutzerdefiniert	die beiden Daten	1. Mär – 30. Jun

Ein benutzerdefinierter Zeitraum zeigt statt eines Kürzels sein Start- und Enddatum, formatiert in der App-Sprache: 1. Mär – 30. Jun auf Deutsch, Mar 1 – Jun 30 auf Englisch. Ein unvollständiger benutzerdefinierter Zeitraum zeigt /Jahr — passend zum Jahr, auf das er stillschweigend zurückgefallen ist.

Was Zeiträume nicht können

Danach musst du nicht suchen:

• Es gibt keinen Wochen-, Tages- oder rollierenden N-Tage-Zeitraum. Die vier oben sind alle.
• Es gibt keine Geschäftsjahr-Einstellung und keine Möglichkeit, einen vergangenen Monat, ein vergangenes Quartal oder Jahr anzusehen. Nur ein benutzerdefinierter Zeitraum kann auf eine abgeschlossene Periode zeigen.
• Der Verlauf ist ausschließlich linear. Keine Saisonalität, keine Wochentags-Gewichtung, keine Anlaufkurve, keine Meilensteine.
• Es gibt keine Prognose. Nichts rechnet deine aktuelle Laufrate auf das Zeitraum-Ende hoch.
• Die Status-Schwellen (90 % / 110 % des Ideals) sind fest und pro KPI nicht einstellbar.
• Diagramme, Status-Zeitleiste und Verlaufstabelle lesen aus den letzten 90 Datumstagen, an denen es überhaupt einen Eintrag gibt — für irgendeinen KPI. Bei einem Jahres-KPI mit täglicher Erfassung fallen die frühesten Monate aus diesen Ansichten heraus; die Eintragsdateien auf der Platte bleiben unangetastet.

Wie es weitergeht

• Ideal-Linie & Status — wie aus dem Ideal „Im Plan“, „Gefährdet“ und „Aus dem Plan“ wird
• Aufbau eines KPI — die übrigen Felder im selben Dialog
• Werte erfassen — wie ein Wert auf einem Datum landet
• KPI-Detailseite — wo Ideal, Abweichung und Verlaufstabelle stehen