User Guide

Date 345

setFullYear (Date.setFullYear method)

public setFullYear(year:Number, [month:Number], [date:Number]) : Number

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 Lite 2.0

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