SelectedPeriod
Das Feld SelectedPeriod ermöglicht das Filtern der API-Daten nach einer Zeitspanne. Statt Start- und Enddatum manuell einzugeben, kannst du Optionen wie Last7Days, CurrentMonth, PreviousQuarter usw. auswählen, um einfach festzulegen, welchen Zeitraum deine Daten oder Berichte enthalten sollen.
Einsatzbereiche
Nutze das Feld SelectedPeriod, um:
- Monitoring-Daten ohne Berechnen der genauen Datumsangaben zu filtern;
- geplante Berichte zu erstellen, die automatisch relative Zeiträume enthalten, Last Month zeigt zum Beispiel immer die Daten des vorherigen Monats;
- Daten für häufige Zeiträume wie das aktuelle Quartal oder die letzten 24 Stunden abzurufen.
Optionen
Es gibt die folgenden Zeitraum-Optionen:
Aktuelle Zeiträume
Diese Optionen decken den aktuellen, unvollständigen Zeitraum vom Beginn des Zeitraums bis zum akuellen Zeitpunkt ab:
CurrentDayCurrentWeekCurrentMonthCurrentQuarterCurrentYear
Wenn der aktuelle Zeitpunkt der 26. November 2025 um 14:30 Uhr ist, enthält CurrentDay die Zeit 26. November 2025 00:00 bis 26. November 2025 14:30 (von Mitternacht bis zum aktuellen Moment).
Vorherige Zeiträume
Diese Optionen decken den vollständigen Zeitraum ab, der vorherig beendet wurde:
PreviousDayPreviousWeekPreviousMonthPreviousQuarterPreviousYear
Wenn die aktuelle Zeit 26. November 2025 um 14:30 Uhr ist, enhält PreviousDay die Daten vom 25. November 2025 00:00 bis 25. November 2025 23:59 (der vollständige vorherige Kalendertag).
„Letzte X‟-Zeiträume
Diese Optionen decken eine Reihe bestimmter vollständiger Zeiträume ab, vom aktuellen Zeitpunkt rückwärts zählend: Der aktuelle unvollständige Zeitraum ist nicht standardmäßig enthalten.
Nach Stunden:
Last2HoursLast6HoursLast12HoursLast24HoursLast48Hours
Nach Tagen:
Last7DaysLast30DaysLast60DaysLast90DaysLast365Days
Nach Monat:
Last3MonthsLast6MonthsLast12MonthsLast24Months
Wenn du Zeiträume wie letzte Stunden, Tage oder Monate wählst, kannst du den aktuellen Zeitraum einschließen, sodass die neuesten Daten enthalten sind. Wenn du zum Beispiel Last24Hours wählst, stellt das Aktivieren von Inklusive der aktuellen Stunde sicher, dass die Daten von der laufenden Stunde ebenfalls enthalten sind.
Beispiel: Die aktuelle Zeit ist 26. November 2025, 14:30 Uhr und der ausgewählte Zeitraum ist Last24Hours. Ohne Inklusive der aktuellen Stunde enthält der Zeitraum Daten von 25. November 2025 14:00 Uhr bis 26. November 2025 14:00 Uhr (vollständige 24 Stunden). Mit Aktivieren von Inklusive der aktuellen Stunde enthält der Zeitraum Daten von 25. November 2025 14:00 Uhr bis 26. November 2025 14:30 Uhr (vollständige 24 Stunden und die aktuelle, unvollständige Stunde von 14:00 bis 14:30 Uhr)
Verwandte Felder
Wenn du genaue Kontrolle über den exakten Zeitraum haben möchtest, kannst du die Datenfelder Start und End statt SelectedPeriod nutzen. Diese Felder akzeptieren exakte Datums- und Uhrzeitwerte im Format YYYY-MM-DDTHH:MM:SS (zum Beispiel 2025-01-20T08:00:00).