Latest web development tutorials
 

JavaScript UTC() Method

< JavaScript Date Object

Example

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

var d = Date.UTC(2012,02,30);

The result of d will be:

Try it Yourself »

More "Try it Yourself" examples below.


Definition and Usage

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

Tip: The Universal Coordinated Time (UTC) is the time set by the World Time Standard.

Note: UTC time is the same as GMT time.


Browser Support

Method
UTC() Yes Yes Yes Yes Yes

Syntax

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

Parameter Values

Parameter Description
year Required. A four-digit value representing the year, negative values are allowed
month Required. An integer representing the month

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
day Required. An integer representing the day of month

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
hour Optional. Default 0. An integer representing the hour.

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
min Optional. Default 0. An integer representing the minutes.

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
sec Optional. Default 0. An integer representing the seconds

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
millisec Optional. Default 0. An integer representing the milliseconds

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

Technical Details

Return Value: A Number, representing the number of milliseconds between the specified date-time and midnight January 1 1970
JavaScript Version: 1.0

Examples

More Examples

Example

Create a date object using UTC time instead of local time:

var d = new Date(Date.UTC(2012,02,30));

The result of d will be:

Try it Yourself »

< JavaScript Date Object