Date.UTC()

Date.UTC() 메서드는 Date 생성자와 비슷한 매개변수를 받지만, 모두 UTC로 취급합니다. 반환 값은 1970년 1월 1일 00:00:00 UTC부터 매개변수가 나타내는 시간의 차이를 밀리초로 나타낸 수입니다.

구문

ECMAScript 2017 이상:

Date.UTC(year[, month[, day[, hour[, minute[, second[, millisecond]]]]])

ECMAScript 2016 이하: (month 필수)

Date.UTC(year, month[, day[, hour[, minute[, second[, millisecond]]]]])

매개변수

year
네 자리 연도.
month
월을 나타내는 0(1월)에서 11(12월) 사이의 정수. ECMAScript 2016까지는 필수 매개변수였으나, ECMA2017부터는 선택사항입니다.
day Optional
일을 나타내는 1에서 31 사이의 정수. 기본값은 1입니다.
hour Optional
시를 나타내는 0에서 23 사이의 정수. 기본값은 0입니다.
minute Optional
분을 나타내는 0에서 59 사이의 정수. 기본값은 0입니다.
second Optional
초를 나타내는 0에서 59 사이의 정수. 기본값은 0입니다.
millisecond Optional
밀리초를 나타내는 0에서 999 사이의 정수. 기본값은 0입니다.

반환 값

주어진 날짜와 1970년 1월 1일 00:00:00 UTC의 차이를 밀리초로 나타낸 숫자.

설명

Date.UTC()는 날짜 및 시간을 받고, 1970년 1월 1일 00:00:00 UTC와의 차이를 밀리초 수로 나타내 반환합니다.

0에서 99 사이의 연도는 20세기(1900 + year)로 취급합니다. 즉 95를 입력할 경우 1995로 취급합니다.

Date.UTC() 메서드는 Date 생성자와 다른 점이 두 가지 있습니다.

  • Date.UTC()는 현지 시간 대신 국제 표준시(UTC)를 사용합니다.
  • Date.UTC()Date 객체를 만드는 대신 시간 값을 숫자로 반환합니다.

주어진 매개변수가 통상적인 범위를 벗어나면 Date.UTC() 메서드는 다른 매개변수 값을 조절해 계산합니다. 예를 들어, 월 값으로 15를 사용하면 연도가 1 증가(year + 1)하고, 월 계산에는 3을 대신 사용합니다.

Date.UTC()Date의 정적 메서드이므로, 사용자가 생성한 Date 인스턴스에서 호출하지 않고 Date.UTC() 형태로 사용합니다.

예제

Date.UTC() 사용하기

다음 예제는 현지 시간 대신 UTC를 사용하여 Date 객체를 생성합니다.

var utcDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0));

명세

Specification Status Comment
ECMAScript Latest Draft (ECMA-262)
The definition of 'Date.UTC' in that specification.
Draft
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Date.UTC' in that specification.
Standard
ECMAScript 5.1 (ECMA-262)
The definition of 'Date.UTC' in that specification.
Standard
ECMAScript 1st Edition (ECMA-262) Standard Initial definition. Implemented in JavaScript 1.0.

브라우저 호환성

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
UTCChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yesnodejs Full support Yes

Legend

Full support  
Full support

호환성 참고사항

매개변수를 두 개 미만 제공하는 경우

Date.UTC()가 두 개 미만의 매개변수를 받은 경우, ECMAScript 2017은 NaN을 반환할 것을 요구합니다. 이를 지원하지 않던 엔진은 업데이트됐습니다. (bug 1050755, ecma-262 #642를 참고하세요)

Date.UTC();
Date.UTC(1);

// Safari: NaN 
// Chrome/Opera/V8: NaN

// Firefox <54: non-NaN
// Firefox 54+: NaN

// IE: non-NaN
// Edge: NaN

같이 보기