> 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.md).

# Date-Time

Ce bloc de fonction fournit la date et l'heure actuelles sous forme de chaîne lisible par l'humain. Vous pouvez choisir entre plusieurs formats courants et une variante adaptée aux noms de fichiers pour enregistrer des fichiers.

## 📥 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>

`Text` La date et l'heure actuelles sous forme de chaîne, formatées selon les options sélectionnées.

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

`Format` Boîte combinée pour sélectionner le format de sortie. Choix typiques :

* Standard (YYYY-MM-DD HH:MM:SS)
* Milliseconds (YYYY-MM-DD HH:MM:SS.sss)
* Iso Format (ISO 8601)

`File Name Mode` Boîte combinée pour sélectionner un style adapté aux noms de fichiers. Options :

* Standard (chaîne lisible)
* File Name (remplace des caractères comme ":" et les espaces pour rendre la chaîne utilisable comme nom de fichier ou de dossier)

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

* Plusieurs formats date/heure pour des besoins différents (texte lisible, horodatages haute précision ou norme ISO).
* Option « filename-safe » qui transforme la date/heure en un format adapté au nommage de fichiers sans traitement supplémentaire.
* Fonctionnement simple sans entrée — renvoie l’heure système courante à chaque évaluation.

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

1. Choisissez le style de sortie souhaité avec le contrôle `Format`.
2. Si vous prévoyez d’utiliser la sortie comme partie d’un nom de fichier (pour enregistrer des images, des logs ou des vidéos), sélectionnez le mode `File Name Mode` pour obtenir une chaîne sûre.
3. Connectez la sortie `Text` aux blocs en aval qui nécessitent une information temporelle (pour nommer des fichiers, journaliser ou annoter).

## 📊 Évaluation <a href="#evaluation" id="evaluation"></a>

À chaque exécution, ce bloc lit l’horloge système et retourne une chaîne formatée en fonction des réglages `Format` et `File Name Mode`.

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

* Utilisez ce bloc avec `Image Write` ou `Image Logger` pour enregistrer des images avec un nom de fichier horodaté. Le mode `File Name` évitera automatiquement les caractères interdits.
* Combinez avec `Record Video` pour créer des enregistrements horodatés et organiser les fichiers par date/heure d’exécution.
* Associez à `CSV Export` ou `Data to JSON` pour ajouter un horodatage lisible aux lignes de données exportées ou aux journaux.
* Si vous avez besoin de composants séparés date/heure (année, mois, heure, etc.) pour une logique conditionnelle ou un affichage, envisagez d’utiliser `Date-Time List` si disponible pour obtenir des éléments structurés plutôt qu’une seule chaîne.
* Utilisez `String Merge` pour combiner l’horodatage avec d’autres textes (par exemple, ID caméra ou nom d’expérience) avant d’écrire des fichiers avec `File/Folder Operations` ou `Choose Folder`.

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

* Si les noms de fichiers générés avec l’horodatage provoquent des erreurs à l’enregistrement, basculez le mode `File Name Mode` sur `File Name` pour supprimer ou remplacer les caractères non autorisés.
* Si vous avez besoin d’une précision plus élevée pour des événements de courte durée, sélectionnez le format `Milliseconds`.
* Si des blocs en aval attendent un format d’horodatage spécifique, vérifiez que le `Format` choisi correspond à cette attente et ajustez-le si nécessaire.