> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/function-blocks/blocks-reference/input-output/data-inputs/date-time-list.md).

# Date-Time List

Ce bloc de fonction fournit la date et l'heure actuelles sous forme de valeurs textuelles distinctes. Il est utile pour horodater des images, vidéos, logs, ou pour piloter une logique basée sur le temps dans votre scénario.

## 📥 Entrées <a href="#inputs" id="inputs"></a>

Ce bloc de fonction n'a pas d'entrées.

## 📤 Sorties <a href="#outputs" id="outputs"></a>

`Year` — Année courante sous forme de texte (ex. 2026)\
`Month` — Mois courant sous forme de texte avec zéro initial (ex. 01..12)\
`Day` — Jour du mois sous forme de texte avec zéro initial (ex. 01..31)\
`Hour` — Heure au format 24h sous forme de texte (ex. 00..23)\
`Minute` — Minute courante sous forme de texte (ex. 00..59)\
`Second` — Seconde courante sous forme de texte (ex. 00..59)\
`Milliseconds` — Valeur sub-seconde haute résolution (millisecondes/microsecondes) sous forme de texte

Toutes les sorties sont des valeurs textuelles, prêtes à être concaténées dans des noms de fichiers, des overlays ou des données journalisées.

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

`Current Date` — Étiquette en lecture seule affichant la date/heure courante pour un aperçu rapide\
`See Live Time` — Zone de texte en direct affichant le dernier horodatage (se met à jour lorsque le scénario s'exécute)

Ce sont des widgets d'affichage pour vous aider à vérifier visuellement l'heure courante pendant l'exécution du scénario.

## 🎨 Fonctionnalités <a href="#features" id="features"></a>

* Valeurs en temps réel : les sorties sont rafraîchies à chaque exécution pour obtenir des horodatages à jour.
* Valeur sub-seconde précise : utile lorsque vous avez besoin d'horodatages à haute résolution.
* Sorties textuelles : faciles à concaténer avec d'autres blocs textuels pour des noms de fichiers ou des overlays.
* Aucune configuration requise : déposez simplement le bloc dans le flux et utilisez les sorties.

## ⚙️ Mécanisme d'exécution <a href="#running-mechanism" id="running-mechanism"></a>

À chaque exécution du scénario, ce bloc lit l'horloge système et met à jour les étiquettes affichées ainsi que les sorties textuelles listées ci-dessus. Ces sorties peuvent ensuite être consommées par d'autres blocs pour enregistrer des horodatages, annoter des images ou prendre des décisions basées sur le temps.

## 📝 Instructions d'utilisation <a href="#usage" id="usage"></a>

1. Placez le bloc dans votre workflow. Aucune entrée n'est requise.
2. Connectez la ou les sorties dont vous avez besoin (par exemple, utilisez `Year`, `Month`, `Day` ensemble pour construire une chaîne de date).
3. Utilisez d'autres blocs pour formater ou sauvegarder les données horodatées (voir Astuces pour les combinaisons courantes).

## 💡 Astuces et bonnes pratiques <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Pour écrire la date/heure courante sur une image pour des archives visuelles, combinez ce bloc avec `Write Date On Image` ou `Write Text On Image`.
* Pour sauvegarder des images avec des noms de fichiers horodatés, fusionnez les sorties date/heure dans une chaîne de nom de fichier (utilisez `String Merge`) puis connectez-la à `Image Logger` ou `Image Write`.
* Pour horodater des enregistrements vidéo, envoyez les sorties textuelles dans l'entrée `File Name` de `Record Video` afin que chaque enregistrement porte l'heure de début.
* Pour créer des journaux horodatés (CSV ou JSON), combinez les sorties avec `Data to JSON` ou `CSV Export`.
* Pour déclencher des actions à des moments précis, utilisez `Datetime Compare` avec des blocs logiques (par ex. `Rising Edge` ou `Logic Input`) pour former des contrôles/conditions temporelles simples.
* Pour une vérification visuelle rapide pendant le développement, prévisualisez les images avec `Show Image` après avoir superposé l'heure via `Write Text On Image`.

## 🛠️ Dépannage <a href="#troubleshooting" id="troubleshooting"></a>

* Si les horodatages semblent incorrects, vérifiez l'horloge système et les paramètres de fuseau horaire de votre ordinateur.
* Si vous avez besoin d'un format différent (par exemple sans zéros initiaux ou en format 12 heures), utilisez des blocs `String Operations` ou `String Merge` pour reformater les sorties textuelles avant utilisation.