SelectedPeriod
Le champ SelectedPeriod vous permet de sélectionner une période à utiliser pour filtrer vos données d’API. Au lieu de saisir manuellement des dates de début et de fin, vous pouvez sélectionner des options comme Last7Days, CurrentMonth ou PreviousQuarter, pour indiquer facilement quelle période vos données ou votre rapport doivent couvrir.
Exemples d’utilisation
Vous pouvez utiliser le champ SelectedPeriod pour :
- Filtrer des données de surveillance sans devoir calculer les dates exactes.
- Créer des rapports planifiés qui couvrent automatiquement des périodes relatives. Par exemple, la valeur du dernier mois couvre toujours les données du mois précédent.
- Récupérer les données de périodes utilisées fréquemment, comme le trimestre en cours ou les dernières 24 heures.
Options disponibles
Les périodes suivantes sont disponibles :
Périodes en cours
Ces options couvrent la période en cours, depuis le début de la période jusqu’à maintenant :
CurrentDayCurrentWeekCurrentMonthCurrentQuarterCurrentYear
Par exemple, le 26 novembre 2025 à 14h30, la valeur CurrentDay va du 26 novembre 2025 à 00h00 au 26 novembre 2025 à 14h30 (soit de minuit au moment présent).
Périodes passées
Ces options couvrent la période complète la plus récente :
PreviousDayPreviousWeekPreviousMonthPreviousQuarterPreviousYear
Par exemple, le 26 novembre 2025 à 14h30, la valeur PreviousDay va du 25 novembre 2025 à 00h00 au 25 novembre 2025 à 23h59 (soit la journée précédente complète).
Périodes les plus récentes
Ces options couvrent un nombre donné de périodes complètes, en comptant à rebours depuis maintenant. La période en cours n’est pas incluse par défaut.
En heures :
Last2HoursLast6HoursLast12HoursLast24HoursLast48Hours
En jours :
Last7DaysLast30DaysLast60DaysLast90DaysLast365Days
En mois :
Last3MonthsLast6MonthsLast12MonthsLast24Months
Lorsque vous sélectionnez des périodes comme les dernières “x” heures, les derniers “x” jours ou les derniers “x” mois, vous pouvez inclure la période en cours pour que le rapport contienne les données les plus à jour. Par exemple, si vous sélectionnez Last24Hours, cochez l’option Include current hour pour inclure aussi les données de l’heure en cours.
Par exemple, imaginons que le moment présent soit le 26 novembre 2025 à 14h30 et que la période sélectionnée soit Last24Hours. Dans l’option Include current hour, la période va du 25 novembre 2025 à 14h00 au 26 novembre 2025 à 14h00 (soit les dernières 24 heures dans leur intégralité). Avec l’option Include current hour, la période va du 25 novembre 2025 à 14h00 au 26 novembre 2025 à 14h30 (soit les dernières 24 heures dans leur intégralité, plus l’heure non terminée qui va de 14h00 à 14h30).
Champs liés
Si vous avez besoin de définir précisément une période, vous pouvez utiliser les champs de date Start et End au lieu du champ SelectedPeriod. Ces champs acceptent les valeurs exactes de date et d’heure au format YYYY-MM-DDTHH:MM:SS (par exemple, 2025-01-20T08:00:00).