Javascript - Date UTC() Method

The UTC() method returns the number of milliseconds between a specified date and midnight of January 1, 1970, according to universal time.

Description

The UTC() method returns the number of milliseconds between a specified date and midnight of January 1, 1970, according to universal time.

UTC time is the same as GMT time.

Syntax

Date.UTC(year,month,day,hours,minutes,seconds,millisec)

Parameter Values

Parameter Require Description
year Required. A four-digit value representing the year, negative values are allowed
month Required. An integer representing the month
day Optional.An integer representing the day of month
hour Optional.Default 0. An integer representing the hour.
min Optional.Default 0. An integer representing the minutes.
sec Optional.Default 0. An integer representing the seconds
millisec Optional.Default 0. An integer representing the milliseconds

For the month value, the expected values are 0-11, but other values are allowed:

  • -1 will result in the last month of the previous year
  • 12 will result in the first month of the next year
  • 13 will result in the second month of the next year

For the day value, the expected values are 1-31, but other values are allowed:

  • 0 will result in the last hour of the previous month
  • -1 will result in the hour before the last hour of the previous month
  • If the month has 31 days: 32 will result in the first day of the next month
  • If the month has 30 days: 32 will result in the second day of the next month

For the hour value, the expected values are 0-23, but other values are allowed:

  • -1 will result in the last hour of the previous day
  • 24 will result in the first hour of the next day

For the minute value, the Expected values are 0-59, but other values are allowed:

  • -1 will result in the last minute of the previous hour
  • 60 will result in the first minute of the next hour

For the second value, the expected values are 0-59, but other values are allowed:

  • -1 will result in the last second of the previous minute
  • 60 will result in the first second of the next minute

For the millisecond value, the expected values are 0-999, but other values are allowed:

  • -1 will result in the last millisecond of the previous second
  • 1000 will result in the first millisecond of the next second

Return

A Number, representing the number of milliseconds between the specified date-time and midnight January 1 1970

Example

Return the number of milliseconds between a specified date and midnight January 1 1970:

Demo

//display the numbers of milliseconds between a specified date and midnight January 1, 1970.
var d = Date.UTC(2012, 02, 30);
console.log(d);/*from  w w w.  ja v a 2  s.  c  o  m*/

//Create a date object using UTC time instead of local time:
//display the local time, based on a UTC date-time.
var d = new Date(Date.UTC(2012, 02, 30));
console.log(d);

Result