Sets the date and time value in the Date object.

dateObj.setTime(milliseconds) 

Arguments

dateObj

Required. Any Date object.

milliseconds

Required. An integer value representing the number of elapsed seconds since midnight, January 1, 1970 GMT.

Remarks

If milliseconds is negative, it indicates a date before 1970. The range of available dates is approximately 285,616 years from either side of 1970.

Setting the date and time with the setTime method is independent of the time zone.

Example

The following example illustrates the use of the setTime method.

function SetTimeTest(newtime){
   var d, s;                  //Declare variables.
   d = new Date();            //Create Date object.
   d.setTime(newtime);        //Set time.
   s = "Current setting is ";
   s += d.toUTCString();
   return(s);                 //Return new setting.
}

Requirements

Version 1

See Also

Date Object Methods | getTime Method

Applies To: Date Object