JavaScript Datumske funkcije in lastnosti: setUTCFullYear()

Metoda setUTCFullYear() nastavi leto objekta Date glede na univerzalni koordinirani čas (UTC). Metoda sprejme leto kot številsko vrednost in opcijsko tudi mesec in dan.

PRIMER

<!DOCTYPE html>
<html lang="sl">
<head>
    <meta charset="UTF-8">
    <title>JavaScript setUTCFullYear() – osnovni primeri</title>
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <style>
        .rezultat {
            border: 1px solid #ddd;
            padding: 15px;
            margin: 10px 0;
            border-radius: 4px;
        }
        .skupina {
            border: 1px solid #ddd;
            padding: 15px;
            margin: 12px 0;
            border-radius: 4px;
        }
        .opis {
            margin: 0 0 8px;
            font-weight: 600;
        }
        .vrstica {
            margin: 4px 0;
        }
        code {
            padding: 1px 6px;
            border: 1px solid #ccc;
            border-radius: 4px;
            font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace;
            font-size: 0.95em;
        }
        .izpis {
            border: 1px dashed #ccc;
            padding: 8px;
            border-radius: 4px;
            margin-top: 6px;
        }
    </style>
</head>
<body>
    <div class="rezultat">
        <p class="vrstica">Osnovni (izhodiščni) trenutek: <strong><span id="izhLocal"></span></strong></p>
        <div class="izpis">UTC niz: <span id="izhUTC"></span></div>
        <p class="vrstica"><em>Opomba:</em> setUTCFullYear(y, m?, d?) nastavi leto (in po želji mesec, dan) v 
        <strong>UTC</strong> kontekstu. Lokalni prikaz se lahko razlikuje glede na časovni pas.</p>
    </div>

    <div class="skupina">
        <p class="opis">1) Nastavi samo leto (UTC)</p>
        <p class="vrstica">Koda: <code>d.setUTCFullYear(2030)</code></p>
        <div class="izpis">
            Lokalni prikaz: <strong><span id="p1Local"></span></strong><br>
            UTC prikaz: <strong><span id="p1UTC"></span></strong>
        </div>
        <p class="vrstica">Pojasnilo: spremeni se le leto v UTC; mesec in dan ostaneta enaka.</p>
    </div>

    <div class="skupina">
        <p class="opis">2) Nastavi leto in mesec (0–11, UTC)</p>
        <p class="vrstica">Koda: <code>d.setUTCFullYear(2025, 0)</code> <em>(0 = januar)</em></p>
        <div class="izpis">
            Lokalni prikaz: <strong><span id="p2Local"></span></strong><br>
            UTC prikaz: <strong><span id="p2UTC"></span></strong>
        </div>
        <p class="vrstica">Pojasnilo: nastavljen je januar 2025 (UTC); dan ostane kot v izhodišču, če je veljaven.</p>
    </div>

    <div class="skupina">
        <p class="opis">3) Prestopno leto – prilagoditev 29. februarja (UTC)</p>
        <p class="vrstica">Koda: <code>new Date(Date.UTC(2024, 1, 29)); d.setUTCFullYear(2023)</code></p>
        <div class="izpis">
            Lokalni prikaz: <strong><span id="p3Local"></span></strong><br>
            UTC prikaz: <strong><span id="p3UTC"></span></strong>
        </div>
        <p class="vrstica">Pojasnilo: 2023 ni prestopno leto, zato se 29. feb samodejno prilagodi (običajno na 1. marec 
        v UTC).</p>
    </div>

    <div class="skupina">
        <p class="opis">4) Z dodatnimi parametri in prelivanjem (UTC)</p>
        <p class="vrstica">Koda: <code>d.setUTCFullYear(2024, 12, 5)</code> <em>(mesec 12 → januar 2025)</em></p>
        <div class="izpis">
            Lokalni prikaz: <strong><span id="p4Local"></span></strong><br>
            UTC prikaz: <strong><span id="p4UTC"></span></strong>
        </div>
        <p class="vrstica">Pojasnilo: vrednosti izven obsega (npr. mesec 12) se prevedejo v ustrezno leto/mesec 
        (overflow v UTC).</p>
    </div>

    <script>
        // Pomožne za izpis (lokalno in UTC)
        function fmtLocal(d) {
            return d.toLocaleString('sl-SI', {
                year: 'numeric',
                month: 'long',
                day: 'numeric',
                hour: '2-digit',
                minute: '2-digit',
                second: '2-digit',
                hour12: false
            });
        }
        function fmtUTC(d) {
            return d.toUTCString();
        }

        // Izhodišče: fiksna UTC točka (5. jul 2024 09:15:30.120 UTC)
        const izhodisce = new Date(Date.UTC(2024, 6, 5, 9, 15, 30, 120));
        document.getElementById('izhLocal').textContent = fmtLocal(izhodisce);
        document.getElementById('izhUTC').textContent = fmtUTC(izhodisce);

        // 1) setUTCFullYear(leto)
        (function () {
            const d = new Date(izhodisce);
            d.setUTCFullYear(2030);
            document.getElementById('p1Local').textContent = fmtLocal(d);
            document.getElementById('p1UTC').textContent = fmtUTC(d);
        })();

        // 2) setUTCFullYear(leto, mesec)
        (function () {
            const d = new Date(izhodisce);
            d.setUTCFullYear(2025, 0); // januar 2025 UTC
            document.getElementById('p2Local').textContent = fmtLocal(d);
            document.getElementById('p2UTC').textContent = fmtUTC(d);
        })();

        // 3) Prestopno leto: 2024-02-29 UTC -> setUTCFullYear(2023)
        (function () {
            const d = new Date(Date.UTC(2024, 1, 29, 10, 0, 0, 0)); // 29. feb 2024 UTC
            d.setUTCFullYear(2023); // 2023 ni prestopno leto
            document.getElementById('p3Local').textContent = fmtLocal(d);
            document.getElementById('p3UTC').textContent = fmtUTC(d);
        })();

        // 4) setUTCFullYear(2024, 12, 5) -> januar 2025 UTC (overflow)
        (function () {
            const d = new Date(izhodisce);
            d.setUTCFullYear(2024, 12, 5);
            document.getElementById('p4Local').textContent = fmtLocal(d);
            document.getElementById('p4UTC').textContent = fmtUTC(d);
        })();
    </script>
</body>
</html>

REZULTAT

Interaktivni primer prikazuje nastavitev leta (ter po želji tudi meseca in dneva) v UTC kontekstu z metodo setUTCFullYear(). V polje vnesete leto (obvezno), po želji pa še mesec (0–11) in dan (1–31). Gumb »Nastavi UTC leto« ustvari kopijo izvirnega datuma in na njej kliče setUTCFullYear(leto[, mesec[, dan]]). Spodaj sta prikazana »Izvirni datum« in »Nov datum« v dveh pogledih: lokalni čas (glede na časovni pas sistema) in UTC. Dovoljene vrednosti za leto so približno od −271821 do 275760 (JavaScript omejitve). Če vnesete samo leto, se ohranita trenutni mesec in dan; pri neveljavnih kombinacijah (npr. 31. april) JavaScript datum samodejno prilagodi (preliv na veljavni datum).

Preizkusi setUTCFullYear()

Leto:

Mesec (neobvezno):

Dan (neobvezno):

Izvirni datum:

Lokalni čas:

UTC čas:

Nov datum:

Lokalni čas:

UTC čas:

Opombe:

setUTCFullYear() lahko sprejme do tri parametre:
- leto (obvezno)
- mesec (0-11, neobvezno)
- dan (1-31, neobvezno)
Dovoljene vrednosti za leto:
- Minimum: -271821
- Maximum: 275760
Če vnesete samo leto, se ohranita trenutni mesec in dan
Če vnesete neveljavno kombinacijo (npr. 31. april), se datum samodejno prilagodi

Zanimivost: Pri delu z zgodovinskimi datumi bodite pozorni na:

Gregorijanski koledar se je začel uporabljati leta 1582
Pred tem se je uporabljal Julijanski koledar
JavaScript uporablja Gregorijanski koledar tudi za datume pred 1582