This documentation is archived and is not being maintained.

setDate Method

Updated: March 2009

Sets the numeric day of the month of a Date object in the local time zone.

function setDate(numDate : Number)

numDate

Required. A numeric value equal to the numeric day of the month.

To set the day-of-the-month value using Coordinated Universal Time (UTC), use the setUTCDate method.

If the value of numDate is greater than the number of days in the month stored in the Date object or is a negative number, the date is set to a date equal to numDate minus the number of days in the stored month. For example, if the stored date is January 5, 1996, and setDate(32) is called, the date changes to February 1, 1996. Negative numbers behave similarly.

The setFullYear method can be used to set the year, month, and day of the month.

The following example illustrates the use of the setDate method.

function SetDateDemo(newdayofmonth)
{
    var d = new Date();        
    d.setDate(newdayofmonth);    
    var s = d.toLocaleString(); 
    return(s);             
}

Date

History

Reason

March 2009

Clarified remarks and example.

Information enhancement.

Show: