--- title: Date.UTC() slug: Web/JavaScript/Reference/Global_Objects/Date/UTC tags: - Date - JavaScript - Method - Reference translation_of: Web/JavaScript/Reference/Global_Objects/Date/UTC ---
Date.UTC()
메서드는 {{jsxref("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
day
{{optional_inline}}hour
{{optional_inline}}minute
{{optional_inline}}second
{{optional_inline}}millisecond
{{optional_inline}}주어진 날짜와 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()
메서드는 {{jsxref("Date")}} 생성자와 다른 점이 두 가지 있습니다.
Date.UTC()
는 현지 시간 대신 국제 표준시(UTC)를 사용합니다.Date.UTC()
는 {{jsxref("Date")}} 객체를 만드는 대신 시간 값을 숫자로 반환합니다.주어진 매개변수가 통상적인 범위를 벗어나면 Date.UTC()
메서드는 다른 매개변수 값을 조절해 계산합니다. 예를 들어, 월 값으로 15를 사용하면 연도가 1 증가(year + 1
)하고, 월 계산에는 3을 대신 사용합니다.
Date.UTC()
는 {{jsxref("Date")}}의 정적 메서드이므로, 사용자가 생성한 {{jsxref("Date")}} 인스턴스에서 호출하지 않고 Date.UTC()
형태로 사용합니다.
Date.UTC()
사용하기다음 예제는 현지 시간 대신 UTC를 사용하여 {{jsxref("Date")}} 객체를 생성합니다.
var utcDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0));
Specification | Status | Comment |
---|---|---|
{{SpecName('ESDraft', '#sec-date.utc', 'Date.UTC')}} | {{Spec2('ESDraft')}} | |
{{SpecName('ES6', '#sec-date.utc', 'Date.UTC')}} | {{Spec2('ES6')}} | |
{{SpecName('ES5.1', '#sec-15.9.4.3', 'Date.UTC')}} | {{Spec2('ES5.1')}} | |
{{SpecName('ES1')}} | {{Spec2('ES1')}} | Initial definition. Implemented in JavaScript 1.0. |
{{Compat("javascript.builtins.Date.UTC")}}
Date.UTC()가 두 개 미만의 매개변수를 받은 경우, ECMAScript 2017은 {{jsxref("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