Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Temporal.ZonedDateTime : méthode startOfDay()

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

La méthode startOfDay() des instances de Temporal.ZonedDateTime retourne un objet Temporal.ZonedDateTime représentant le premier instant de cette date dans le fuseau horaire. Elle a généralement une heure de 00:00:00, mais peut être différente si minuit n'existe pas à cause d'un changement de décalage, auquel cas la première heure existante est retournée.

Elle est équivalente à l'appel de withPlainTime() sans argument.

Syntaxe

js
startOfDay()

Paramètres

Aucun.

Valeur de retour

Un objet Temporal.ZonedDateTime avec l'instant t, tel que :

  • La date à t est différente de la date une nanoseconde avant t.
  • La date à t est identique à la date de this.

Exemples

Utiliser la méthode startOfDay()

js
// Aux États-Unis, les transitions d'heure d'été ont lieu à 2 h, donc minuit existe
const dt = Temporal.ZonedDateTime.from(
  "2024-03-10T12:00:00-04:00[America/New_York]",
);
console.log(dt.startOfDay().toString()); // "2024-03-10T00:00:00-05:00[America/New_York]"

// Au Brésil, les transitions d'heure d'été avaient lieu à minuit, donc minuit n'existait pas
const dt2 = Temporal.ZonedDateTime.from(
  "2015-10-18T12:00-02:00[America/Sao_Paulo]",
);
console.log(dt2.startOfDay().toString()); // "2015-10-18T01:00:00-02:00[America/Sao_Paulo]"

Spécifications

Spécification
Temporal
# sec-temporal.zoneddatetime.prototype.startofday

Compatibilité des navigateurs

Voir aussi