Dans ce quatrième cours, nous allons aborder des notions que nous manipulons quotidiennement — semaines, dates relatives, durées, fuseaux horaires — mais qui sont souvent plus complexes à coder qu’il n’y paraît.

À partir de notre classe stmp, nous allons enrichir son API avec des fonctions capables de traiter ces concepts de manière claire, robuste et réutilisable.

Nous verrons comment :

• calculer des repères calendaires (ex. le lundi d’une semaine),
• afficher des dates relatives (« aujourd’hui », « hier », « lundi prochain »),
• formater intelligemment des durées en segments lisibles,
• calculer des dates comme « dernier dimanche de mars » ou « 2ème dimanche de septembre ».

Au-delà des calculs eux-mêmes, ce cours met l’accent sur :

• la conception d’une API flexible (usage des variants),
• l’évolution anticipée du code (structure Case of pensée pour demain),
• la gestion des propriétés partagées dans une classe singleton,
• l’indirection dynamique (This[$function].apply) pour préparer l’extensibilité.

Ce cours montre que les timestamps ne servent pas uniquement à stocker des dates : ils deviennent un véritable outil d’abstraction temporelle au cœur de la logique applicative.