THE WORLD'S LARGEST WEB DEVELOPER SITE

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 Optional. 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: ECMAScript 1

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