새로운 Intl.DateTimeFormat
객체를 생성하여 반환한다. new
연산자를 사용하거나 사용하지 않고도 생성자를 호출할 수 있다.
Intl.DateTimeFormat(locales[, options])
BCP 47
언어 태그 또는 Intl.Locale
인스턴스가 포함된 문자열 또는 이러한 식별값을 원소로 가진 배열을 지정한다.
다음의 확장 키워드가 허용된다. 아래의 확장 키워드와 동일한 설정을 opitions
에서도 지정할 수 있다. 만약에 동시에 지정이 되면 options
설정이 우선적으로 적용된다.
nu
: options
의 numberingSystem
와 동일ca
: options
의 calendar
와 동일hc
: options
의 hourCycle
와 동일목적에 따라 구분된 다음 아래의 프로퍼티를 포함한 객체이다.
localeMatcher
"lookup"
"best fit"
: 기본 값calendar
Intl.Locale.prototype.getCalendars()
메소드를 참고하기 바란다. 첫 번째 매개변수인 locales
에서 ca
확장 키워드를 통해서도 가능하다.numberingSystem
Intl.Locale.prototype.getNumberingSystems()
메소드를 참고하기 바란다. 첫 번째 매개변수인 locales
에서 nu
확장 키워드를 통해서도 가능하다.hour12
12
시간제를 사용할지에 대한 여부를 불리언(boolean)으로 지정한다. 기본값은 지역에 따라 다르다. 이 옵션은 첫 번째 매개변수의 확장 키워드인 hc
와 두 번째 매개변수인 options
의 hourCycle
의 설정을 재정의한다. 예를 들어서 hour12
가 true
인 경우 hourCycle
은 "h11"
또는 "h12"
로 설정되고 hour12
가 false
인 경우에는 "h23"
또는 "h24"
로 설정된다.hourCycle
"h11"
, "h12"
, "h23"
, "h24"
이다. 첫 번째 매개변수인 locales
에서 hc
확장 키워드를 통해서도 가능하다.timeZone
"Asia/Seoul"
, "Asia/Shanghai"
, "America/New_York"
같은 IANA 시간대도 인식할 수 있다.날짜와 시간 구성 요소 옵션의 기본값은 없지만 모든 구성 요소의 속성이 정의되지 않은 경우 연도, 월, 일은 기본적으로 숫자로 설정된다. 다음의 날짜와 시간 구성 요소 옵션 중 하나라도 지정되면 dateStyle
및 timeStyle
을 지정하지 않아야 한다.
weekday
"lange"
: "Thursday""short"
: "Thu""narrow"
: "T" era
"lange"
: "Anno Domini""short"
: "AD""narrow"
: "A" year
2
자리의 문자열 표현이다.month
"numeric"
: 3"2-digit"
: "03""long"
: "March""short"
: "Mar""narrow"
: "M"day
2
자리의 문자열 표현이다.dayPeriod
hourCycle
이 "h11"
또는 "h12"
로 지정된 경우에만 반영된다."narrow"
"short"
"long"
hour
2
자리의 문자열 표현이다.minute
2
자리의 문자열 표현이다.second
2
자리의 문자열 표현이다.fractionalSecondDigits
1
부터 3
까지이다.timeZoneName
"long"
: (예) Pacific Standard Time태평양 표준시"short"
: (예) PST태평양 표준시"shortOffset"
: (예) GMT-8"longOffset"
: (예) GMT-0800"shortGeneric"
: (예) PT태평양 시"longGeneric"
: (예) Pacific Time태평양 시formatMatcher
"basic"
"best fit"
: 기본 값weekday
, year
, month
, day
, hour
, minute
, second
weekday
, year
, month
, day
year
, month
, day
year
, month
month
, day
hour
, minute
, second
hour
, minute
요청에서는 formatMatcher
옵션의 설정에 따라 "best fit"
는 사용 가능한 모든 하위 집합(표현) 조합에 대해 조정되어 가장 일치하는 항목을 찾는다.
formatMatcher
옵션은 dateStyle
과 timeStyle
이 모두 지정되지 않은 경우에만 유효하다.
dateStyle
format()
메소드를 호출할 때 사용할 날짜 형식 지정 스타일을 나타낸다. 가능한 값은 다음과 같다."full"
"long"
"medium"
"short"
timeStyle
format()
메소드를 호출할 때 사용할 시간 형식 지정 스타일을 나타낸다. 가능한 값은 다음과 같다."full"
"long"
"medium"
"short"
새로운 Intl.DateTimeFormat
객체를 반환한다.
매개변수에 잘못된 값이 포함된 경우에 RangeError
예외가 발생한다.
어떤 값이 집합 구조에 없거나 허용되는 범위가 아닐 때 오류를 다루는 객체이다.
지정된 this
와 제공된 인수를 가진 배열 또는 유사 배열로 함수를 호출한다.
원본 함수와 동일한 본문을 갖는 바인딩된 함수를 만든다. this
키워드가 있는 경우 실제로 자신을 참조할 수 있도록 활성화된다.
인수를 지정하여 함수를 호출한다.
함수의 소스 코드를 반환한다.
객체가 특정 프로퍼티를 가지고 있는지를 블린(boolean
) 값으로 반환한다.
해당 객체가 다른 객체의 프로토타입 체인에 속한 객체인지를 체크한다.
매개 변수의 속성이 열거가능(enumerable)한지 여부를 체크한다.
객체를 나타내는 문자열을 작동하는 지역(locale)의 방식으로 출력이 된다.
객체를 나타내는 문자열을 반환한다.
객체의 원시(primitive) 값을 반환한다.
객체의 생성자 함수를 참조한다.
상속된 [[Prototype]]
참조하거나 설정가능하며 일반적으로 실제 코드상에서는 잘 사용되지 않는다. ECMAScript에서 사용되지 않는 비표준이지만 최신 웹브라우저에서는 비공식적으로 지원하고 있다. 따라서 곧 표준 속성으로 지원될 확률이 높다.