База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Четене и промяна на годината по UTC в обект Date

`getUTCFullYear()` прочита годината по UTC. `setUTCFullYear()` променя същия обект `Date` и връща новата му времева отметка. Пропуснат аргумент не е равнозначен на подадено `undefined`.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

date.getUTCFullYear()
date.setUTCFullYear(year)
date.setUTCFullYear(year, monthIndex)
date.setUTCFullYear(year, monthIndex, dayOfMonth)

getUTCFullYear() не приема аргументи и връща календарната година по UTC като цяло число, а не като низ от четири цифри. При невалидна дата връща NaN. За разлика от него getFullYear() и setFullYear() работят с местната часова зона на средата за изпълнение. Около Нова година един и същ момент може да попада в различни години по UTC и по местно време.

setUTCFullYear(year, monthIndex, dayOfMonth) променя съществуващия обект Date и връща новата времева отметка в милисекунди от началото на епохата на Unix. Годината е задължителна. Незадължителният индекс на месеца е от 0 (януари) до 11 (декември), а дните от месеца се броят от 1. Ако зададеш ден, трябва да зададеш и месец. За пропуснатите компоненти и часа се използват съответните стойности по UTC от обекта Date преди промяната. Стойностите извън обичайния диапазон се нормализират: 29 февруари става 1 март при смяна с невисокосна година.

Аргументите се преобразуват в числа. Изрично подадено undefined не означава пропускане: то се преобразува в NaN. Ако аргумент се преобразува в NaN или получената времева отметка е извън диапазона на Date, методът записва и връща NaN. Ако датата вече е била невалидна, началната стойност е 1970-01-01T00:00:00.000Z, така че валидно извикване може да я поправи.

За разлика от Date.UTC(), setUTCFullYear() не добавя 1900 към годините от 0 до 99. И двата метода на прототипа изискват this да е действителен обект Date; при извикване с несъвместима стойност на this възниква TypeError.

Примери

const date = new Date('2024-02-29T12:34:56.789Z');
console.log(date.getUTCFullYear());
console.log(date.setUTCFullYear(2023));
console.log(date.toISOString());
console.log(date.setUTCFullYear(2023, undefined));
console.log(date.getUTCFullYear());
date.setUTCFullYear(7);
console.log(date.toISOString());

Резултат

2024
1677674096789
2023-03-01T12:34:56.789Z
NaN
NaN
0007-01-01T00:00:00.000Z

При смяна на годината на 2023 г. 29 февруари се измества на 1 март, без да се променя часът по UTC. Изрично подадено `undefined` прави датата невалидна; задаването на година `7` възстановява валидна дата: 1 януари на 7-а година в полунощ по UTC.

Свързани уроци

  • JavaScript · Урок 5 · Напреднало · Версия: 4

Източници