Skip To Content

Conditions de filtre basées sur les dates

Les dates sont composées de deux éléments : la date et l’heure. En règle générale, lorsque vous configurez une condition de filtre avec un champ de type date, vous pouvez créer deux types de condition : date constante et date relative.

Remarque :

Lorsque vous indiquez une valeur de date avec un composant horaire pour un filtre, entrez le composant horaire dans votre fuseau horaire local. Le composant horaire sera ensuite converti en temps universel coordonné (UTC) en arrière-plan avant l’implémentation du filtre. Une fois le filtre implémenté, les résultats sont convertis depuis le temps universel coordonné vers votre fuseau horaire local, déterminé par les paramètres de votre navigateur Web, avant d’être affichés dans un élément de tableau de bord.

Lors du filtrage des entités par date, la couche doit également prendre en charge des fonctions SQL standardisées.

Conditions de date constante

Les conditions de date constante incluent une valeur de date spécifique. Vous pouvez indiquer cette valeur en choisissant une date dans le sélecteur de date sur l’onglet Value (Valeur) ou en choisissant un autre champ de date sur l’onglet Field (Champ). Le choix d’un champ de date fonctionne comme si vous saisissiez une valeur de date spécifique pouvant être mise à jour en fonction des changements de données apportés au champ.

Options de saisie des valeurs pour les filtres à date constante
Remarque :

L’onglet Field (Champ) apparaît uniquement si la couche de l’élément comporte plusieurs champs de date.

Une condition de filtre à date constante ne peut être créée qu’avec les opérateurs suivants :

  • is
  • n’est pas
  • est avant
  • est ou est avant
  • est après
  • est ou est après

Remarque :

Il est possible de créer une condition de filtre à date constante avec une plage de dates constantes en créant des filtres individuels avec des dates constantes et en les combinant à l’aide d’opérateurs logiques.

Conditions de date relative

Les conditions de filtre à date relative incluent une plage de valeurs de date. Cette plage peut inclure ou être ancrée au moment actuel (à savoir maintenant) ; il peut également s’agir d’une période prédéfinie (par exemple, la semaine passée). La plage ou le type d’ancrage pouvant être saisi dépend de l’opérateur que vous choisissez.

OpérateurType d’ancrage

est compris dans le dernier

Maintenant

est avant le dernier

Maintenant

est compris dans le suivant

Maintenant

est après le suivant

Maintenant

is

Prédéfinie

n’est pas

Prédéfinie

est avant

Prédéfinie

est ou est avant

Prédéfinie

est après

Prédéfinie

est ou est après

Prédéfinie

Ancrage au moment présent

L’ancrage des plages de dates au moment présent présente l’avantage de permettre l’actualisation des éléments au fur et à mesure que les données sont modifiées. Ainsi, un indicateur configuré pour afficher des données sur les 30 dernières minutes pourrait potentiellement afficher des données différentes à chaque minute si sa couche était actualisée au même rythme. Toutefois, un indicateur affichant des données du jour précédent affichera des données différentes uniquement au changement de la date du jour (c’est-à-dire après minuit) quel que soit l’intervalle d’actualisation de la couche.

Lorsque vous sélectionnez un opérateur associé à un type d’ancrage lié au moment présent, vous êtes invité à indiquer un multiplicateur d’unité (N) ainsi qu’une unité temporelle (par exemple, jour, heure, minute ou seconde). Par exemple, si la plage de dates comprend 7 jours, le multiplicateur d’unité est 7 et l’unité temporelle est le jour.

Plage de dates ancrée au moment présent
Le tableau suivant décrit ces unités temporelles. Notez que toutes les valeurs de date sont indiquées dans votre fuseau horaire local.

OpérateurUnité temporelleDescription

est compris dans le dernier

secondes

N secondes avant la seconde actuelle. La plage inclut alors la période écoulée entre cette seconde et l’heure actuelle.

minutes

N minutes avant la minute actuelle. La plage inclut alors la période écoulée entre cette minute et l’heure actuelle.

heures

N heures avant l’heure actuelle. La plage inclut alors la période écoulée entre cette heure et l’heure actuelle.

jours

Commence à minuit (00:00:00). N jours avant le jour actuel. La plage inclut alors la période écoulée entre ce jour et le jour actuel.

est avant le dernier

secondes

Commence à minuit (00:00). N secondes avant la seconde actuelle et continue indéfiniment.

minutes

Commence à minuit (00:00). N minutes avant la minute actuelle et continue indéfiniment.

heures

Commence à minuit (00:00). N heures avant l’heure actuelle et continue indéfiniment.

jours

Commence à minuit (00:00). N jours avant le jour actuel et continue indéfiniment.

est compris dans le suivant

secondes

Commence maintenant et continue pendant N secondes à compter du moment présent. La plage inclut alors la période écoulée entre l’heure actuelle et cette seconde.

minutes

Commence maintenant et continue pendant N minutes à compter du moment présent. La plage inclut alors la période écoulée l’heure actuelle et cette minute.

heures

Commence maintenant et continue pendant N heures à compter du moment présent. La plage inclut alors la période écoulée entre l’heure actuelle et cette heure.

jours

Commence maintenant et continue jusqu’à 23:59:59. N jours à partir de maintenant. La plage inclut alors la période écoulée entre le jour actuel et ce jour.

est après le suivant

secondes

Commence à minuit (00:00). N secondes après la seconde actuelle et continue indéfiniment.

minutes

Commence à minuit (00:00). N minutes après la minute actuelle et continue indéfiniment.

heures

Commence à minuit (00:00). N heures après l’heure actuelle et continue indéfiniment.

jours

Commence à minuit (00:00). N jours après le jour actuel et continue indéfiniment.

Ancrage à une période prédéfinie

Il convient d’utiliser des plages de dates ancrées à une période prédéfinie lorsqu’il n’est pas nécessaire de mettre à jour les données aussi fréquemment que la couche, ce qui est le cas si vous utilisez une plage de dates ancrée au moment présent.

Lorsque vous sélectionnez un opérateur associé à un type d’ancrage prédéfini, vous devez indiquer un intervalle sur l’onglet Period (Période).

Plage de dates ancrée à une période prédéfinie

Ces périodes sont basées sur les unités suivantes. Notez que les heures de début et de fin sont toujours exprimées dans votre fuseau horaire local.

  • Day (Jour) : un jour commence à minuit, a une durée de 24 heures et se termine à 23:59:59. Au format horaire militaire, un jour commence à 00:00:00, a une durée de 24 heures et se termine à 23:59:59.
  • Week (Semaine) : une semaine commence à minuit 00:00:00 le dimanche, a une durée de 7 jours consécutifs et se termine à 23:59:59 le septième jour, à savoir le samedi.
  • Month (Mois) : un mois est défini selon le calendrier grégorien. Chaque mois commence à minuit (00:00:00) (heure locale) le premier jour du mois et se termine à 23:59:59 (Heure locale) le dernier jour du mois.
  • Quarter (Trimestre) : chaque année est divisée en trimestres de trois mois, comme décrit ci-dessous.
    • 1st quarter (1er trimestre) : janvier à mars
    • 2nd quarter (2nd trimestre) : avril à juin
    • 3rd quarter (3ème trimestre) : juillet à septembre
    • 4th quarter (4ème trimestre) : octobre à décembre
  • Year (Année) : une année est une période de 12 mois commençant à minuit (00:00:00) le 1er janvier et se terminant à 23:59:59 le 31 décembre.

Période prédéfinieDescription

Maintenant

Date et heure actuelles.

Aujourd’hui

Commence à minuit (00:00:00) le jour actuel et a une durée de 24 heures.

Hier

Commence à minuit (00:00:00) le jour précédant le jour actuel et a une durée de 24 heures.

Demain

Commence à minuit (00:00:00) le jour suivant le jour actuel et a une durée de 24 heures.

Cette semaine

Commence à minuit (00:00:00) le premier jour de la semaine actuelle et a une durée de 7 jours.

La semaine dernière

Période de 7 jours qui se termine immédiatement avant le début de la semaine actuelle. La semaine dernière commence à minuit (00:00:00) le premier jour de la semaine qui précède la semaine actuelle et a une durée de 7 jours.

La semaine prochaine

Période de 7 jours qui se commence immédiatement après la fin de la semaine actuelle. La semaine prochaine commence à minuit (00:00:00) le premier jour de la semaine suivant la semaine actuelle et a une durée de 7 jours.

Ce mois-ci

Commence à minuit (00:00:00) le premier jour du mois actuel et se termine à 23:59:59 le dernier jour du mois.

Le mois dernier

Commence à minuit (00:00:00) le premier jour du mois qui précède le mois actuel et se termine à 23:59:59 le dernier jour du mois.

Le mois prochain

Commence à minuit (00:00:00) le premier jour du mois qui suit le mois actuel et se termine à 23:59:59 le dernier jour du mois.

Ce trimestre

Commence à minuit (00:00:00) le premier jour du trimestre actuel, a une durée de trois mois et se termine à 23:59:59 le dernier jour du trimestre.

Le trimestre dernier

Commence à minuit (00:00:00) le premier jour du trimestre qui précède immédiatement le trimestre actuel, a une durée de trois mois et se termine à 23:59:59 le dernier jour du trimestre.

Le trimestre prochain

Commence à minuit (00:00:00) le premier jour du trimestre qui suit le trimestre actuel, a une durée de trois mois et se termine à 23:59:59 le dernier jour de ce trimestre.

Cette année

Commence à minuit (00:00:00) le 1er janvier de l’année actuelle et a une durée de 12 mois (jusqu’à 23:59:59 le 31 décembre).

Année dernière

Commence à minuit (00:00:00) le 1er janvier de l’année qui précède immédiatement l’année actuelle et a une durée de 12 mois (jusqu’à 23:59:59 le 31 décembre).

L'année prochaine

Commence à minuit (00:00:00) le 1er janvier de l’année qui suit immédiatement l’année actuelle et a une durée de 12 mois (jusqu’à 23:59:59 le 31 décembre).

Cumul annuel jusqu’à ce jour

Commence à minuit (00:00:00) le 1er janvier de l’année actuelle et continue jusqu’à ce jour. Cette période diffère de This year (Cette année) car cette dernière peut inclure des dates futures contrairement à Year to date (Cumul annuel jusqu’à ce jour).