Temporal.ZonedDateTime : propriété day

Disponibilité limitée

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

La propriété d'accesseur day des instances de Temporal.ZonedDateTime retourne un entier positif représentant l'index du jour dans le mois de cette date, basé sur 1, ce qui correspond au numéro de jour que vous verriez sur un calendrier. Elle dépend du calendrier.

Le mutateur d'accesseur de day est undefined. Vous ne pouvez pas modifier cette propriété directement. Utilisez la méthode with() pour créer un nouvel objet Temporal.ZonedDateTime avec la nouvelle valeur souhaitée.

Pour des informations générales et plus d'exemples, voir Temporal.PlainDate.prototype.day.

Pour PlainDate, day ne peut être non continu que si le calendrier saute des jours. Pour ZonedDateTime, day peut également être non continu si le fuseau horaire change son décalage de 24 heures ; cela s'est réellement produit. Voir l'exemple ci-dessous.

Exemples

Utiliser la propriété `day`

const dt = Temporal.ZonedDateTime.from("2021-07-01[America/New_York]"); // calendrier ISO 8601
console.log(dt.day); // 1

Jours discontinus

Pour mieux aligner les horaires avec ses partenaires commerciaux en Asie, le pays de Samoa a changé son fuseau horaire de l'autre côté de la ligne de changement de date internationale, décalant son offset de -10:00 à +14:00 (heure d'été). Cela a entraîné un changement brutal de 24 heures dans l'heure locale, sautant ainsi complètement le jour du 30 décembre 2011. 2011-12-29T23:59:59-10:00[Pacific/Apia] est immédiatement suivi par 2011-12-31T00:00:00+14:00[Pacific/Apia].

const dt = Temporal.ZonedDateTime.from(
  "2011-12-29T23:59:59-10:00[Pacific/Apia]",
);
console.log(dt.day); // 29
const nextDay = dt.add({ seconds: 1 });
console.log(nextDay.day); // 31

C'est pourquoi vous devriez toujours privilégier add() et subtract() pour manipuler les dates et les heures, plutôt que de modifier directement la propriété day.