Sets the numeric date in the Date object using Universal Coordinated Time (UTC).

dateObj.setUTCDate(numDate) 

Arguments

dateObj

Required. Any Date object.

numDate

Required. A numeric value equal to the numeric date.

Remarks

To set the date using local time, use the setDate 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 setUTCDate(32) is called, the date changes to February 1, 1996. Negative numbers have a similar behavior.

Example

The following example illustrates the use of the setUTCDate method.

function SetUTCDateDemo(newdate){
   var d, s;                   //Declare variables.
   d = new Date();             //Create Date object.
   d.setUTCDate(newdate);      //Set UTC date.
   s = "Current setting is ";
   s += d.toUTCString(); 
   return(s);                  //Return new setting.
}

Requirements

Version 3

See Also

Date Object Methods | getDate Method | getUTCDate Method | setDate Method

Applies To: Date Object