Flash CS3 Documentation

ActionScript 2.0 Language Reference > ActionScript classes > Date > setFullYear (Date.setFullYear method)

setFullYear (Date.setFullYear method)

Sets the year of the specified Date object, according to local time and returns the new time in milliseconds. If the month and date parameters are specified, they are set to local time. Local time is determined by the operating system on which Flash Player is running.

Calling this method does not modify the other fields of the specified Date object but Date.getUTCDay() and Date.getDay() can report a new value if the day of the week changes as a result of calling this method.

Availability: ActionScript 1.0; Flash Player 5

Parameters

year:Number - A four-digit number specifying a year. Two-digit numbers do not represent four-digit years; for example, 99 is not the year 1999, but the year 99.

month:Number [optional] - An integer from 0 (January) to 11 (December). If you omit this parameter, the month field of the specified Date object will not be modified.

date:Number [optional] - A number from 1 to 31. If you omit this parameter, the date field of the specified Date object will not be modified.

Returns

Number - An integer.

Example

The following example initially creates a new Date object, setting the date to May 15, 2004, and uses Date.setFullYear() to change the date to May 15, 2002:

var my_date:Date = new Date(2004,4,15);
trace(my_date.getFullYear()); //output: 2004
my_date.setFullYear(2002);
trace(my_date.getFullYear()); //output: 2002

See also

getUTCDay (Date.getUTCDay method), getDay (Date.getDay method)

Flash CS3