JavaScript Date.UTC()
Example
Get the number of milliseconds between a date and January 1, 1970:
let ms = Date.UTC(2020, 02, 30);
Try it Yourself »
More "Try it Yourself" examples below.
Description
The Date.UTC() method returns the number of milliseconds between a specified date and midnight of January 1, 1970, according to UTC.
Notes
UTC (Universal Time Coordinated) is the time set by the World Time Standard.
UTC time is the same as GMT time (Greenwich Mean Time).
Browser Support
Date.UTC()
is an ECMAScript1 (ES1) feature.
ES1 (JavaScript 1997) is fully supported in all browsers:
Chrome | Edge | Firefox | Safari | Opera | IE |
Yes | Yes | Yes | Yes | Yes | Yes |
Syntax
Date.UTC(year, month, day, hours, minutes, seconds, millisec)
Date.UTC() is a static method of the Date object.
You cannot use it on a date like d.UTC()
The syntax is always Date.UTC().
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:
|
day | Optional. An integer representing the day of month
Expected values are 1-31, but other values are allowed:
If the month has 31 days:
If the month has 30 days:
|
hour | Optional. Default 0. An integer representing the hour.
Expected values are 0-23, but other values are allowed:
|
min | Optional. Default 0. An integer representing the minutes.
Expected values are 0-59, but other values are allowed:
|
sec | Optional. Default 0. An integer representing the seconds
Expected values are 0-59, but other values are allowed:
|
millisec | Optional. Default 0. An integer representing the milliseconds
Expected values are 0-999, but other values are allowed:
|
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:
let d = new Date(Date.UTC(2020, 02, 30));
Try it Yourself »