Metodo setUTCFullYear
Aggiornamento: novembre 2007
Consente di impostare il valore dell'anno nell'oggetto Date in base al formato UTC (Tempo universale coordinato, Universal Coordinated Time).
function setUTCFullYear(numYear : Number [, numMonth : Number [, numDate : Number]])
Argomenti
numYear
Obbligatorio. Valore numerico che rappresenta l'anno.numMonth
Facoltativo. Valore numerico che rappresenta il mese.numDate
Facoltativo. Valore numerico che rappresenta la data.
Note
Per tutti i metodi set che prevedono argomenti facoltativi, se un argomento facoltativo non viene specificato, verrà utilizzato il valore restituito dai corrispondenti metodi get. Se, ad esempio, l'argomento numMonth è facoltativo ma non viene specificato, verrà utilizzato il valore restituito dal metodo getUTCMonth.
Inoltre, se il valore di un argomento è maggiore del relativo intervallo o è un numero negativo, gli altri valori memorizzati verranno modificati di conseguenza.
Per impostare l'anno utilizzando l'ora locale, è possibile utilizzare il metodo setFullYear.
L'intervallo di anni supportato dall'oggetto Date è compreso approssimativamente tra 285.616 anni prima e 285.616 anni dopo il 1970.
Esempio
Nell'esempio seguente viene illustrato l'utilizzo del metodo setUTCFullYear.
function SetUTCFullYearDemo(newyear){
var d, s; //Declare variables.
d = new Date(); //Create Date object.
d.setUTCFullYear(newyear); //Set UTC full year.
s = "Current setting is ";
s += d.toUTCString();
return(s); //Return new setting.
}