[▶️ Vidéo : anatomie du bloc Date d'aujourd'hui](https://celestory-docs-videos.netlify.app/fr/anatomie-bloc/date.html)


![Date d aujourd hui](https://celestory-docs-illustrations.netlify.app/fr/Datedaujourdhui_FR.svg)

Le bloc Date d'aujourd'hui permet de récupérer la date actuelle au moment précis où le joueur passe par ce bloc. Il est particulièrement utile pour horodater un événement, limiter l'accès à une fonctionnalité dans le temps, ou afficher la date au joueur.

Ses deux sorties sont des **textes**. Pour obtenir une vraie date, que vous pourrez ranger dans une variable Date, comparer, additionner ou formater, utilisez plutôt le bloc [Maintenant](lien:blocs-celestory/traitement-des-donnees/maintenant.md), introduit avec la variable Date.

## 📥 Entrées

-   Ce bloc ne nécessite pas d'entrée spécifique : Il prend directement la date et l'heure du système au moment de son exécution.

## 📤 Sorties

-   date (Texte) : Renvoie la date sous un format simple "Année-Mois-Jour", sans zéro devant le mois ni le jour (par exemple : 2024-11-21, ou 2024-3-7 pour le 7 mars).
-   dateWithTime (Texte) : Renvoie la date complète incluant l'heure exacte et le fuseau horaire au format "ISO 8601" (par exemple : 2024-11-21T15:30:00.000Z). Ce format est idéal pour les échanges avec des APIs ou des bases de données.

## 💡 Exemple d'utilisation

Scénario : Enregistrement de la date de dernière connexion d'un joueur

1. Le joueur se connecte à son espace personnel dans le jeu.
1. Le flux passe par le bloc Date d'aujourd'hui pour récupérer la date et l'heure actuelles.
1. La sortie dateWithTime est connectée à un bloc Assignation pour stocker cette valeur dans une variable Texte derniereConnexion.
1. Le bloc Assignation enregistre la date au format ISO dans la variable.
1. Pour afficher la date dans un message sous une forme lisible (« 21 novembre 2024 »), passez plutôt par un bloc Maintenant relié à un bloc Formater une date.

## ⚙️ Détails Techniques

-   Gestion du fuseau horaire : Le format ISO 8601 (dateWithTime) inclut automatiquement le fuseau horaire UTC (indiqué par le Z final).
-   Sortie date : l'année est celle du calendrier de l'appareil du joueur, alors que le mois et le jour sont ceux du calendrier UTC. Autour de minuit, ou du passage au nouvel an, le jour affiché peut donc être décalé d'une journée par rapport à la date que le joueur voit chez lui. Pour une date dans le fuseau du joueur (ou en UTC, au choix), utilisez Maintenant avec Formater une date.
-   Actualisation : La date et l'heure sont capturées au moment exact où le bloc est exécuté, sans mise à jour ultérieure.

## 🔗 Voir aussi

-   [Maintenant](lien:blocs-celestory/traitement-des-donnees/maintenant.md) : donne l'instant présent comme une vraie date, utilisable avec les variables Date et les autres blocs de date.
-   [Formater une date](lien:blocs-celestory/traitement-des-donnees/formater-une-date.md) : écrit une date dans la langue du joueur, avec le format de votre choix.

---

*Version documentée : v3*