Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Date — časovni žigi in leto UTC

Date shranjuje časovni žig. Naučite se prebrati in spremeniti leto UTC, razumeti spreminjanje objekta ter normalizacijo datumov, tudi premik 29. februarja v neprestopnem letu na 1. marec.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

new Date(milliseconds)
new Date(isoString)
date.getUTCFullYear()
date.setUTCFullYear(year[, month[, day]])

Date je vgrajeni objekt ECMAScript, ki shranjuje število milisekund od 1970-01-01T00:00:00.000Z ali NaN za neveljaven datum. Časovnega pasu ne shranjuje. Lokalne metode isti časovni žig razlagajo glede na časovni pas okolja; metode UTC uporabljajo UTC.

Date.prototype.getUTCFullYear() vrne celotno leto UTC ali NaN za neveljaven datum. Date.prototype.setUTCFullYear(year[, month[, day]]) spremeni objekt in vrne nastali časovni žig, ne pa objekta Date. Meseci uporabljajo indekse 0–11, dnevi v mesecu pa se začnejo z 1. Če je prvotni datum veljaven, metoda za vsak izpuščeni argument za mesec ali dan kot vhod uporabi prvotno vrednost po UTC. Normalizacija lahko v rezultatu spremeni mesec in dan. Če je rezultat veljaven, ura po UTC ostane nespremenjena.

Setter normalizira vrednosti: sprememba leta pri 29. februarju v neprestopno leto da 1. marec. Leto v obsegu 0–99 se razume dobesedno, drugače kot pri konstruktorju Date z več argumenti. Pri neveljavnem datumu setter kot izhodišče uporabi časovni žig 0; neveljavni številski argumenti lahko kljub temu povzročijo NaN.

Primer uporablja izrecni Z in metode UTC, zato rezultat ni odvisen od lokalnega časovnega pasu. Preveri tudi, ali se vrnjeni časovni žig ujema s spremenjenim objektom.

Primeri

const date = new Date("2024-02-29T12:00:00.000Z");
console.log(date.getUTCFullYear());
const timestamp = date.setUTCFullYear(2025);
console.log(date.toISOString());
console.log(timestamp === date.getTime());

Rezultat

2024
2025-03-01T12:00:00.000Z
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri