Get to know MDN better
Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
L'objet Temporal.PlainTime représente une heure sans date ni fuseau horaire ; par exemple, un évènement récurrent qui se produit à la même heure chaque jour. Il est fondamentalement représenté comme une combinaison de valeurs d'heure, de minute, de seconde, de milliseconde, de microseconde et de nanoseconde.
Un PlainTime est essentiellement la partie temps d'un objet Temporal.PlainDateTime, avec les informations de date supprimées. Comme les informations de date et d'heure n'ont pas beaucoup d'interaction, toutes les informations générales sur les propriétés de temps sont documentées ici.
Les objets PlainTime peuvent être sérialisés et analysés en utilisant le format RFC 9557 (angl.), une extension du format ISO 8601 / RFC 3339 (angl.). La chaîne de caractères a la forme suivante :
HH:mm:ss.sssssssss HHUn nombre à deux chiffres compris entre 00 et 23. Il peut être précédé du désignateur de temps T ou t.
mm FacultatifUn nombre à deux chiffres compris entre 00 et 59. Par défaut 00.
ss.sssssssss FacultatifUn nombre à deux chiffres compris entre 00 et 59. Peut être suivi facultativement d'un . ou , et d'un à neuf chiffres. Par défaut 00. Les composants HH, mm et ss peuvent être séparés par : ou rien. Vous pouvez omettre soit ss seul, soit ss et mm, donc l'heure peut être sous l'une des trois formes : HH, HH:mm ou HH:mm:ss.sssssssss.
En option, vous pouvez inclure la date, le décalage horaire, l'identifiant du fuseau horaire et le calendrier, au format PlainDateTime, mais ces éléments seront ignorés. Une chaîne de caractères contenant uniquement une date sera rejetée. Les autres annotations au format [clé=valeur] sont également ignorées, et elles ne doivent pas avoir le drapeau critique.
Lors de la sérialisation, vous pouvez configurer les chiffres fractionnaires de la seconde.
Crée un nouvel objet Temporal.PlainTime en fournissant directement les données sous-jacentes.
Retourne un nombre (-1, 0 ou 1) indiquant si la première heure est avant, identique ou après la deuxième heure. Équivaut à comparer les champs heure, minute, seconde, milliseconde, microseconde et nanoseconde un par un.
Temporal.PlainTime.from()Crée un nouvel objet Temporal.PlainTime à partir d'un autre objet Temporal.PlainTime, d'un objet avec des propriétés de temps ou d'une chaîne de caractères au format RFC 9557.
Ces propriétés sont définies sur Temporal.PlainTime.prototype et partagées par toutes les instances de Temporal.PlainTime.
Temporal.PlainTime.prototype.constructorLa fonction constructeur qui a créé l'objet instance. Pour les instances de Temporal.PlainTime, la valeur initiale est le constructeur Temporal.PlainTime().
Temporal.PlainTime.prototype.hourRetourne un entier de 0 à 23 représentant le composant heure de cette heure.
Temporal.PlainTime.prototype.microsecondRetourne un entier de 0 à 999 représentant le composant microseconde (10-6 seconde) de cette heure.
Temporal.PlainTime.prototype.millisecondRetourne un entier de 0 à 999 représentant le composant milliseconde (10-3 seconde) de cette heure.
Temporal.PlainTime.prototype.minuteRetourne un entier de 0 à 59 représentant le composant minute de cette heure.
Temporal.PlainTime.prototype.nanosecondRetourne un entier de 0 à 999 représentant le composant nanoseconde (10-9 seconde) de cette heure.
Temporal.PlainTime.prototype.secondRetourne un entier de 0 à 59 représentant le composant seconde de cette heure.
Temporal.PlainTime.prototype[Symbol.toStringTag]La valeur initiale de la propriété [Symbol.toStringTag] est la chaîne de caractères "Temporal.PlainTime". Cette propriété est utilisée dans Object.prototype.toString().
Retourne un nouvel objet Temporal.PlainTime représentant cette heure avancée d'une durée donnée (sous une forme convertible par Temporal.Duration.from()), en faisant le tour de l'horloge si nécessaire.
Temporal.PlainTime.prototype.equals()Retourne true si cette heure est équivalente en valeur à une autre heure (sous une forme convertible par Temporal.PlainTime.from()), et false sinon. Elles sont comparées par leurs valeurs temporelles. Équivaut à Temporal.PlainTime.compare(this, other) === 0.
Temporal.PlainTime.prototype.round()Retourne un nouvel objet Temporal.PlainTime représentant cette heure arrondie à l'unité donnée.
Temporal.PlainTime.prototype.since()Retourne un nouvel objet Temporal.Duration représentant la durée entre une autre heure (sous une forme convertible par Temporal.PlainTime.from()) et cette heure. La durée est positive si l'autre heure est avant cette heure, et négative si elle est après.
Temporal.PlainTime.prototype.subtract()Retourne un nouvel objet Temporal.PlainTime représentant cette heure reculée d'une durée donnée (sous une forme convertible par Temporal.Duration.from()), en faisant le tour de l'horloge si nécessaire.
Temporal.PlainTime.prototype.toJSON()Retourne une chaîne de caractères représentant cette heure dans le même format RFC 9557 que l'appel à toString(). Destiné à être appelé implicitement par JSON.stringify().
Temporal.PlainTime.prototype.toLocaleString()Retourne une chaîne de caractères représentant cette heure dans un format sensible à la langue.
Temporal.PlainTime.prototype.toString()Retourne une chaîne de caractères représentant cette heure dans le format RFC 9557.
Temporal.PlainTime.prototype.until()Retourne un nouvel objet Temporal.Duration représentant la durée entre cette heure et une autre heure (sous une forme convertible par Temporal.PlainTime.from()). La durée est positive si l'autre heure est après cette heure, et négative si elle est avant.
Temporal.PlainTime.prototype.valueOf()Lève une TypeError, ce qui empêche les instances de Temporal.PlainTime d'être converties implicitement en primitives lorsqu'elles sont utilisées dans des opérations arithmétiques ou de comparaison.
Temporal.PlainTime.prototype.with()Retourne un nouvel objet Temporal.PlainTime représentant cette heure avec certains champs remplacés par de nouvelles valeurs.
| Temporal # sec-temporal-plaintime-objects |
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Cette page a été modifiée le 29 mars 2026 par les contributeur·ice·s du MDN.
Votre modèle pour un internet meilleur.
Visitez la société mère à but non lucratif de Mozilla Corporation, la Fondation Mozilla.
Certaines parties de ce contenu sont protégées par le droit d'auteur ©1998—2026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.