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
Източници
- ECMAScript® 2024 Language Specification — Date.prototype.getUTCFullYear
- ECMAScript® 2024 Language Specification — Date.prototype.setUTCFullYear
- ECMAScript® 2024 Language Specification — Date.UTC
- ECMAScript® 2024 Language Specification — TimeClip
- Date.prototype.getUTCFullYear() - JavaScript | MDN
- Date.prototype.setUTCFullYear() - JavaScript | MDN