El mètode setUTCFullYear()
assigna l'any sencer a la data especificada d'acord amb el temps universal.
Sintaxi
objecteData.setUTCFullYear(any[, mes[, dia]])
Paràmetres
any
- Un nombre sencer que representa el valor numèric de l'any, per exemple, 1995.
mes
- Un nombre sencer entre 0 i 11 que representa el mes.
dia
- Opcional. Un nombre sencer entre 1 i 31 que representa el dia del mes. Si s'especifica el paràmetre
dia
, també s'ha d'especificar el paràmetremes
.
Descripció
Si no s'especifica els paràmetres mes
o dia
s'utilitza el valor retornat pels mètodes getMonth()
i getDate()
.
Si es passa un paràmetre que està fora del rang esperat, el mètode setUTCFullYear()
actualitza els altres paràmetres per a acceptar el nombre. Per exemple, si es passa 15 com a mes
, l'any serà incrementat en 1 (any + 1
), i s'emprarà 3 com a mes
.
Exemples
Utilitzar setUTCFullYear()
var elGranDia = new Date(); elGranDia.setUTCFullYear(1997);
Especificacions
Especificació | Estat | Comentaris |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Definició inicial. Implementat a JavaScript 1.3. |
ECMAScript 5.1 (ECMA-262) The definition of 'Date.prototype.setUTCFullYear' in that specification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Date.prototype.setUTCFullYear' in that specification. |
Standard |
Compatibilitat amb navegadors
Característica | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Suport bàsic | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Característica | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Suport bàsic | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |