> Mis à jour pour la version 6.0.30

Celestory sait garder une date dans une variable et calculer avec : ajouter des jours, compter ce qui reste avant une échéance, écrire une date dans la langue du joueur. Cet article s'adresse au créateur qui gère des rendez-vous, des délais, des anniversaires ou un calendrier de formation. Il présente la variable **Date**, les sept blocs de date et le bloc **Vérification de date**.

![En haut, un graphe : Maintenant relié à l'entrée « de » de Différence entre deux dates, la variable échéance choisie dans l'entrée « à », la sortie différence reliée au texte du bloc Histoire. En dessous, le haut du panneau de la variable Date échéance : mardi 15 décembre 2026, 14:00, c'est dans 23 jours](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdTRKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--fe101f4668e1e7e64c7ced4026e1e769bd604d88/aide-visuels--graphe-compte-a-rebours-variable-date.fr.png)
*le graphe Maintenant, Différence entre deux dates et Histoire, avec le panneau de la variable Date « échéance »*

## La variable Date

Une variable de type **Date** garde un instant précis : un jour et une heure. Créez-la comme n'importe quelle variable (voir [Choisir le type d'une variable](https://documentation.celestory.io/hc/celestorydoc/articles/1795347773-choisir-le-type-d-une-variable)) en choisissant le type **Date** (« Un jour et une heure, comme une échéance ou un anniversaire »). À la création, elle vaut la minute en cours.

### Saisir une date dans le panneau

Sélectionnez la variable : le panneau **Visuel** s'intitule « Date et heure ». Il propose :

- un calendrier, avec les boutons **Mois précédent** et **Mois suivant** et **Aujourd'hui** ;
- l'**Heure**, en deux champs Heures (0 à 23) et Minutes (0 à 59) : il faut d'abord choisir un jour ;
- des **Raccourcis** : **Maintenant**, **Aujourd'hui à minuit** et **Demain** (à la même heure) ;
- une phrase qui dit où se situe la date (« C'est ... ») et le fuseau horaire dans lequel elle est affichée.

![Le panneau Date et heure avec le calendrier, l'heure et les raccourcis](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBclVKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--95b86867bcb3c739b9a016216ddee6c6c6328600/aide-visuels--variable-panneau-date-complet.fr.png)
*Le panneau Date et heure avec le calendrier, l'heure et les raccourcis.*

Si la valeur enregistrée n'est pas une date valide, le panneau le dit (« Cette date est illisible ») et propose **Remplacer par maintenant**.

### Afficher une date dans un texte

Écrivez `{{échéance}}` dans un texte : le joueur lit la date et l'heure en toutes lettres, dans sa langue (par exemple « 15 octobre 2026 à 14:00 » en français ; la présentation exacte peut varier légèrement d'un navigateur à l'autre). La langue est celle choisie par le joueur, sinon celle dans laquelle le projet est écrit, sinon celle de l'appareil. Une date invalide s'écrit comme un texte vide. Pour choisir le format, utilisez le bloc **Formater une date**.

## Les blocs de date

Ajoutez-les par clic droit sur le graphe, **Ajouter un bloc**, puis tapez le nom dans « Rechercher un bloc… ». Les entrées de type date acceptent une variable Date, la sortie d'un autre bloc de date, ou une date saisie directement. Par défaut, une entrée date contient déjà une date valide : la minute où vous avez ajouté le bloc.

| Bloc | Entrées | Sorties | Exemple |
|---|---|---|---|
| Maintenant | aucune | date | L'heure de l'appareil du joueur au moment où le bloc est lu |
| Ajouter à une date | date, quantité, unité, fuseau horaire | résultat | Maintenant + 7 jours = la date de rappel |
| Différence entre deux dates | de, à, unité, fuseau horaire | différence | Jours entre Maintenant et l'échéance |
| Comparer deux dates | (flux), première date, seconde date, précision, fuseau horaire | la première est avant, identiques, la première est après | Aiguiller l'histoire selon que la date est passée |
| Formater une date | date, format, modèle personnalisé, langue, fuseau horaire | texte | « vendredi 2 octobre 2026 » |
| Extraire d'une date | date, fuseau horaire | année, mois (1-12), jour du mois, jour de la semaine (1 = lundi), heure, minute | Savoir si on est lundi |
| Date depuis des nombres | année, mois (1-12), jour du mois, heure, minute, fuseau horaire | date | Construire le 25 décembre 2026 à 20 h 30 |

### Les réglages communs

- **Unité** (Ajouter, Différence) : secondes, minutes, heures, jours, semaines, mois ou années. Par défaut : jours ;
- **Fuseau horaire** : « fuseau du joueur » (par défaut) ou « UTC » ;
- **Précision** (Comparer) : exacte, même seconde, même minute, même heure, même jour, même mois ou même année ;
- **Format** (Formater) : date courte, date longue, date complète avec jour de la semaine, heure, date et heure (par défaut), jour de la semaine, mois, ISO 8601 ou modèle personnalisé.

### Ce que fait chaque bloc

- **Ajouter à une date** accepte une quantité négative pour reculer. Ajouter un mois au 31 janvier donne le 28 février (le 29 les années bissextiles) : le mois s'arrête à son dernier jour.
- **Différence entre deux dates** compte des unités entières et donne un nombre négatif si la date « à » est avant la date « de ». Du 2 octobre 0 h au 12 octobre 23 h 59, il y a 10 jours.
- **Comparer deux dates** est un bloc de flux : il suit la sortie « la première est avant », « identiques » ou « la première est après ». Si la sortie choisie n'est reliée à rien, l'histoire s'arrête là.
- **Formater une date** écrit la date dans la **langue** indiquée (un code comme `fr` ou `en-GB`) ; si vous la laissez vide, il prend la langue du joueur, puis celle du projet, puis celle de l'appareil. Le **modèle personnalisé** suit les codes de la bibliothèque Moment : `dddd D MMMM YYYY` donne « vendredi 2 octobre 2026 » en français. Un modèle vide donne la date et l'heure.
- **Extraire d'une date** donne six nombres. Le jour de la semaine va de 1 (lundi) à 7 (dimanche).
- **Date depuis des nombres** refuse une date qui n'existe pas (mois 13, 30 février).

## Vérification de date : l'horloge du lecteur

Le bloc **Vérification de date** (entrée de flux et entrée **date**) suit la sortie **avant** tant que la date n'est pas arrivée, et la sortie **après** une fois qu'elle est passée. Il lit l'horloge de l'appareil, jamais le réseau. Si l'entrée ne contient pas de date valide, il suit la sortie **avant**. Pour un test plus fin (même jour, même mois), préférez **Comparer deux dates**.

Le bloc **Date d'aujourd'hui** est plus ancien : ses sorties **date** et **date avec heure** sont des textes, pas des dates. Pour calculer, utilisez **Maintenant**.

## Exemple : un compte à rebours avant un événement

1. Créez une variable **Date** nommée `échéance` et réglez-la dans le panneau.
2. Ajoutez un bloc **Maintenant** et un bloc **Différence entre deux dates**.
3. Reliez la sortie **date** de **Maintenant** à l'entrée **de**.
4. Dans l'entrée **à**, choisissez la variable `échéance`.
5. Laissez l'unité sur « jours ».
6. Pour afficher ce nombre au joueur, utilisez un bloc qui montre du texte et accepte les emplacements `{{nom}}`, comme **Narrateur** (Chatbot) ou **Dialogue** (Visual Novel) : écrivez par exemple `Plus que {{jours}} jours !` dans son texte. Une entrée **jours** apparaît sur le bloc : reliez-y la sortie **différence**. Le nombre s'affiche tel quel, en jours entiers. Le bloc **Histoire** ne convient pas : son entrée texte n'accepte pas de nombre.

![Le graphe du compte à rebours avec les trois blocs reliés](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcllKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f45afdd7ac63288634357a7fde0cf54d3d80d688/aide-visuels--graphe-compte-a-rebours.fr.png)
*Le graphe du compte à rebours avec les trois blocs reliés.*

Le joueur voit le nombre de jours restants, calculé à chaque lecture du bloc.

## Fuseaux horaires et pièges

- Une date est enregistrée en UTC : c'est le même instant pour tout le monde, chacun le lit dans son fuseau. Le panneau vous l'affiche dans votre fuseau horaire.
- Avec « fuseau du joueur », un joueur à Tokyo et un joueur à Paris peuvent obtenir des jours différents pour la même date. Choisissez « UTC » pour un résultat identique partout.
- Les dates viennent de l'horloge de l'appareil du joueur.
- Une **Liste** ne peut pas contenir de dates.

## Dépannage

Ces messages d'erreur, écrits en anglais, signalent un bloc de date qui ne peut pas faire son calcul pendant la lecture de l'histoire.

| Message | Solution |
|---|---|
| the input "..." holds no valid date | Reliez un bloc Maintenant, une variable Date ou un autre bloc de date, ou choisissez une date |
| ... is not a date. Month goes from 1 to 12, hour from 0 to 23, minute from 0 to 59 | Corrigez les nombres de Date depuis des nombres (le 30 février n'existe pas) |

## Voir aussi

- [🟦 Date d'aujourd'hui](https://documentation.celestory.io/hc/celestorydoc/articles/fr-blocs-date-d-aujourd-hui-78af1c)
- [🟪 Vérification de date](https://documentation.celestory.io/hc/celestorydoc/articles/fr-blocs-verification-de-date-61f31b)
- [📅 Prise de rendez-vous](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-prise-de-rendez-vous-4e235b)
- [Choisir le type d'une variable](https://documentation.celestory.io/hc/celestorydoc/articles/1795347773-choisir-le-type-d-une-variable)
- [Les variables Pourcentage et Durée](https://documentation.celestory.io/hc/celestorydoc/articles/1795347798-les-variables-pourcentage-et-duree)
