TheTime

TheTime est une classe immutable qui représente une durée signée en millisecondes de manière type-safe. Il s'utilise dans le contexte du namespace date, en particulier avec TheDate (ex: addTime, subtractTime, formatTime).

Exemple interactif

Syntaxe

class TheTime {}
type SerializedTheTime = `time${number}${"-" | "+"}`

Relation entre TheTime et SerializedTheTime

• TheTime : objet immutable pour les calculs de durée dans les APIs date.
• SerializedTheTime : représentation sérialisée pour transport/stockage texte.
• Conversion objet -> sérialisé : D.serialize(theTime).
• Conversion sérialisé -> objet : D.createTime(serialized) ou D.createTimeOrThrow(serialized).
• Les valeurs de TheTime peuvent être positives ou négatives : ce n'est pas une valeur absolue par défaut.

Cas d'usage

• Représenter une durée normalisée (heures, minutes, secondes) en une valeur immutable.
• Représenter des décalages dans le futur ou le passé (durées positives ou négatives).
• Ajouter ou soustraire une durée à une date (TheDate) avec addTime et subtractTime.
• Formater une durée via formatTime.

Voir aussi

• createTime - Construit une valeur TheTime.
• serialize - Convertit TheTime en SerializedTheTime.
• addTime - Ajoute une durée à TheDate ou TheTime.