# Date & heure actuelles

> Affichez une horloge et déclenchez des actions à une date précise. Choisissez entre le type Date du Datastore ou le Timestamp, en fonction de vos usages.

https://docs.pandasuite.com/fr/essentials/data/timestamp-current-date-and-time/

**Utilisez la date et l’heure actuelles pour afficher des informations et déclencher des actions au moment exact.**

Vous pouvez travailler avec un type de donnée *Date* du [Datastore](https://docs.pandasuite.com/fr/essentials/data/datastore/) (souvent plus pratique à éditer) ou avec un *timestamp* (référence universelle).

[Image : Application sur téléphone affichant la date et l'heure du moment : 7 juil. 2023, au-dessus de 11:03 en grands chiffres]

Dans cet article, vous allez :

- comprendre ce qu’est le *timestamp* et où le trouver dans PandaSuite
- afficher la date/heure dans l’interface (formatée)
- déclencher une action automatiquement à une date/heure précise
- appliquer les bonnes pratiques (unités, fuseaux horaires, variable “garde”)

## Exemples d’usage

- Débloquer automatiquement une section “Événement” à son heure de début
- Afficher une pop-up le jour J
- Masquer une offre à sa date d’expiration
- Lancer une animation ou changer d’état au moment souhaité

## Deux approches complémentaires

### Type Date (Datastore)

- Lisible et éditable directement dans le [Datastore](https://docs.pandasuite.com/fr/essentials/data/datastore/) (ex. 20/11/2020 10:21:05).
- Idéal pour paramétrer des dates de début/fin sans convertisseur externe.
- Comparaisons et formats simplifiés.

Quand l’utiliser:

- Vous souhaitez saisir/mettre à jour des dates dans PandaSuite Studio.
- Vous ne voulez pas passer par un convertisseur externe.

### Timestamp (référence universelle)

Le *timestamp* correspond au nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC. Il est basé sur l’horloge de l’appareil.

Dans votre projet, il est accessible via le data binding : **Depuis le projet** > **Contexte** > **Timestamp**

Pour définir le timestamp d’une date, si vous utilisez un convertisseur en ligne, vérifiez l’unité :

- En secondes : 1704067200
- En millisecondes : 1704067200000

Dans PandaSuite, nous utilisons la valeur en millisecondes.

[Image : Fenêtre Données dans PandaSuite Studio : le chemin Projet > Contexte et la valeur Timestamp en millisecondes sont encadrés]

## Afficher l'heure dans une application

Objectif : afficher la date/heure actuelle, avec le format de votre choix.

1. Insérez un bloc de texte dans votre écran.
2. Ajoutez un [data binding](https://docs.pandasuite.com/fr/essentials/data/data-binding/) sur le **Contenu** et choisissez **Projet** > **Contexte** > **Timestamp** comme source de données.
3. Appliquez la [fonction Format Date](https://docs.pandasuite.com/fr/essentials/data/functions/) pour définir l’affichage (exemples: HH:mm, dd/MM/yyyy)

[Image : Éditeur de la fonction Format Date pour un bloc de texte, avec les paramètres Type, Style date, Style heure et Fuseau horaire]

Astuce de formatage :

- *Format Date* attend une valeur en millisecondes.
- Choisissez le fuseau horaire dans la fonction (ex: UTC, Europe/Paris).
- Exemples de codes : *HH:mm* (24 h), *dd/MM/yyyy*, *EEEE d MMMM yyyy*.

[Vidéo : Afficher la date dans PandaSuite](https://www.youtube.com/embed/bcN3pEwMqys?&hl=fr&cc_lang_pref=fr&cc_load_policy=1)

## Déclencher une action à une date/heure précise

Objectif : lancer automatiquement une action quand l’heure actuelle atteint votre date cible.

### Étape 1 : définir la date cible (en millisecondes)

#### Option A — Convertisseur externe

Utilisez un convertisseur (ex: <https://www.epochconverter.com/>).

Vérifiez l’unité: récupérez la valeur en millisecondes (ex: 1735689600000 pour 1 janvier 2025 00:00:00 UTC).

Pour “minuit à Paris”: calculez le timestamp correspondant à 00:00:00 Europe/Paris, puis utilisez la valeur UTC (le timestamp représente toujours un instant absolu).

#### Option B — 100% PandaSuite (recommandé si vous éditez la date dans Studio)

Créez une propriété de type Date dans votre [Datastore](https://docs.pandasuite.com/fr/essentials/data/datastore/) (ex: `date_cible`).

Vous pouvez ensuite récupérer directement son timestamp avec la fonction **Get Timestamp**.

Cette valeur utilise la même unité que **Projet > Contexte > Timestamp** : vous pouvez donc les comparer directement dans une condition.

> **Attention : Horloge de l’appareil**
>
> Le déclenchement s’appuie sur l’horloge locale. Un changement manuel d’heure
> ou une horloge imprécise peuvent décaler l’exécution. Pour les cas sensibles
> (conformité, jeu-concours), préférez une référence côté serveur via une API
> (composant HTTP).

### Étape 2 : configurer un composant Condition

Cliquez sur **Composants** > **Condition**. Placez-le au niveau du **Projet** si l’action peut intervenir n’importe où dans l’application. Renommez-le (ex. “Condition date atteinte”).

Dans les propriétés du composant Condition, ajoutez une condition avec une expression :

- Données : **Projet** > **Contexte** > **Timestamp**
- Fonction : *Supérieur ou égal à*
- Valeur : votre timestamp cible (en millisecondes)

Activez **Évaluation automatique**.

Note : Évaluation automatique relance la condition quand ses attributs changent, mais le Timestamp ne se met pas à jour tout seul. Il faut programmer son évaluation (étape 3).

### Étape 3 : programmer l'évaluation

Choisissez l’une des options suivantes selon le niveau de précision souhaité:

#### Option 1 — Évaluation périodique (précise, recommandée)

- Ajoutez un **Minuteur** au niveau du **Projet**.
- Durée : 1 s.
- Lecture automatique : activée.
- Répétition : activée.
- Dans **Actions** du Minuteur:
  - Déclencheur : Fin lecture
  - Action : **Agir sur un composant** > **Condition** > **Évaluer la condition**
  - Le cycle se répète toutes les secondes, la condition se déclenche dès que Timestamp ≥ cible.

#### Option 2 — Évaluation événementielle (simple, moins précise)

- Projet > Déclencheurs :
  - Lancement de projet > Agir sur un composant > Condition > Évaluer la condition
  - Gain de focus > Agir sur un composant > Condition > Évaluer la condition
- Utile si l’application n’a pas besoin d’une précision à la seconde.

### Étape 4 : ajouter l’action à exécuter “quand la condition est vraie”

Sélectionnez votre composant **Condition** > **Actions**.
Déclencheur : **Évaluation de la condition**.
Ajoutez votre action, par exemple :

- **Agir sur un composant** > **Multi-état** > **Changer d’état** (débloquer un contenu)
- **Agir sur un composant** > **Pop-up** > **Ouvrir une Pop-up**
- **Changer d’écran**
- ...

[Vidéo : Créer des conditions avec Timestamp](https://www.youtube.com/embed/IS_0Kf7BlFk?&hl=fr&cc_lang_pref=fr&cc_load_policy=1)

## Exemple guidé : débloquer une section le jour J

Préparer les états :

- Créez un état “Avant” (section masquée) et un état “Après” (section visible) via les états d’écran ou un composant Multi-état.

Condition :

- Configurez “Date atteinte” (Timestamp ≥ Cible), évaluation automatique activée.

Actions :

- Sur “Évaluation de la condition”: Multi-état > Changer d’état vers “Après”.

Tester :

- Utilisez un timestamp proche (dans quelques minutes) pour valider.

Validation attendue:

- Avant la date cible: section masquée.
- Après la date cible: section visible et persistante.

## Bonnes pratiques et points d’attention

- Unités : utilisez un timestamp en millisecondes dans la condition. Si vous avez des secondes, multipliez par 1000.
- Fuseau horaire : calculez correctement la date cible selon la zone désirée, puis utilisez sa valeur UTC en millisecondes.
- Horloge locale : l’heure est celle de l’appareil. Pour des cas sensibles (ex. conformité légale), privilégiez une source de temps validée côté serveur via API (HTTP).
- Déclenchement unique : si besoin, utilisez une variable de type booléan “garde” et mettez-la à true après exécution.
- Portée : placez la Condition au niveau du Projet si le déclenchement doit être global.

## Ressources utiles

- [Composant Condition](https://docs.pandasuite.com/fr/essentials/components/condition/)
- [Propriétés et déclencheurs du Projet](https://docs.pandasuite.com/fr/essentials/project-properties/project-properties-and-actions/)
- [Actions interactives](https://docs.pandasuite.com/fr/essentials/interactions/interactive-actions/)
- [Minuteur](https://docs.pandasuite.com/fr/essentials/components/timer/)
- [Fonction Format Date](https://docs.pandasuite.com/fr/essentials/data/functions/)

[Modèle : Timestamp](https://pandasuite.com/fr/templates/date-heure/)
