ApplicationStartTime |
Heure de début de l'application |
|---|---|
| Lucee | |
Syntaxe
| ApplicationStartTime( ); |
Description
Cette fonction permet de fournir des informations sur l'heure à laquelle l'étendue de l'application actuelle a été créée.
Remarques
- La fonction ApplicationStartTime() retourne l'heure exacte à laquelle l'étendue de l'application (Application scope) a été initialisée. Cela permet aux développeurs de connaître la durée de vie de l'application depuis son démarrage ou son dernier redéploiement, ce qui est utile pour la surveillance et le diagnostic.
- Cette fonction ne prend aucun paramètre, ce qui la rend très simple à utiliser. Elle renvoie généralement un objet date/heure compatible avec les opérations de manipulation de date en CFML, permettant de l'afficher, de la comparer ou de la journaliser facilement dans le code de l'application.
- ApplicationStartTime() est particulièrement utile pour le suivi des performances et la gestion du cache. Connaître le moment de démarrage de l'application peut aider à déterminer si certaines données mises en cache doivent être invalidées ou si un redémarrage de l'application est nécessaire pour prendre en compte des mises à jour.
- Elle est aussi pratique pour le journal de bord ou la surveillance d'applications critiques. Par exemple, on peut comparer l'heure de démarrage avec l'heure actuelle pour calculer la durée d'activité de l'application, ce qui permet de détecter des redémarrages inattendus ou des interruptions de service.
- L'utilisation de ApplicationStartTime() peut aider à diagnostiquer des problèmes liés à la session ou aux variables de l'application. Si certaines données semblent incohérentes, savoir depuis combien de temps l'étendue Application est active permet de comprendre si les problèmes viennent d'un redémarrage récent ou d'une accumulation de données persistantes.
- Cette fonction est également utile pour des interfaces d'administration ou des tableaux de bord internes. Les administrateurs peuvent afficher l'heure de démarrage de l'application afin de vérifier l'état actuel du serveur et la stabilité des applications déployées, ce qui facilite le suivi opérationnel.
- ApplicationStartTime() complète les autres fonctions de diagnostic de Lucee, comme la vérification des sessions ou des caches. Elle permet d'obtenir rapidement un point de référence temporel sur l'application, ce qui est indispensable dans des environnements multi-utilisateurs ou multi-environnements où les changements doivent être suivis avec précision.
- Enfin, cette fonction est robuste et ne modifie aucune donnée de l'application. Elle fournit uniquement une information en lecture sur le moment de création de l'étendue Application, ce qui la rend sûre à utiliser dans tous les contextes, qu'il s'agisse de développement, de test ou de production.
Exemple
Voici des exemples typiques d'utilisation de cette fonction :
- app_start = ApplicationStartTime();
- dump(app_start);
- </cfscript>
on obtiendra un résultat ressemblant à ceci :
Date Time (Etc/UTC){ts '2025-10-08 01:22:33'}
Dernière mise à jour : Jeudi, le 14 Août 2025