NATIVE

settings_applicationsObject  >   settings_applicationsIntl  >   settings_applicationsIntl.DateTimeFormat  >   settings_applicationsConstructor

NATIVE

Editing
  • account_tree
  • bug_report

Intl.DateTimeFormatdateTimeFormatIntl.DateTimeFormat([ string, Arraylocales[ , Objectoptions]])

새로운 Intl.DateTimeFormat 객체를 생성하여 반환한다. new 연산자를 사용하거나 사용하지 않고도 생성자를 호출할 수 있다.

구문

형식
Intl.DateTimeFormat(locales[, options])

매개 변수

string, Arraylocales선택

BCP 47 언어 태그 또는 Intl.Locale 인스턴스가 포함된 문자열 또는 이러한 식별값을 원소로 가진 배열을 지정한다.

다음의 확장 키워드가 허용된다. 아래의 확장 키워드와 동일한 설정을 opitions에서도 지정할 수 있다. 만약에 동시에 지정이 되면 options 설정이 우선적으로 적용된다. 

  • nu : options의 numberingSystem와 동일
  • ca : options의 calendar와 동일
  • hc : options의 hourCycle와 동일
Objectoptions선택

목적에 따라 구분된 다음 아래의 프로퍼티를 포함한 객체이다.

지역 옵션
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
UTC에 따른 시간대를 지정한다. 기본값은 런타임의 기본 시간대이다. "Asia/Seoul", "Asia/Shanghai", "America/New_York"같은 IANA 시간대도 인식할 수 있다.
날짜와 시간 구성 요소 옵션

날짜와 시간 구성 요소 옵션의 기본값은 없지만 모든 구성 요소의 속성이 정의되지 않은 경우 연도, 월, 일은 기본적으로 숫자로 설정된다. 다음의 날짜와 시간 구성 요소 옵션 중 하나라도 지정되면 dateStyle 및 timeStyle을 지정하지 않아야 한다.

weekday
평일에 대한 표현을 나타낸다. 가능한 값은 다음과 같다. 참고로 예를 든 것은 영어권(en-us)의 목요일이다.
  • "lange" : "Thursday"
  • "short" : "Thu"
  • "narrow" : "T" 
era
시대의 명칭을 나타낸다. 가능한 값은 다음과 같다. 참고로 예로 든 것은 영어권(en-us)의 "서기(기원후)"이다.
  • "lange" : "Anno Domini"
  • "short" : "AD"
  • "narrow" : "A" 
year
연도에 대한 표현을 나타낸다. 가능한 값은 숫자와 숫자로 구성된 2자리의 문자열 표현이다.
month
달에 대한 표현을 나타낸다. 가능한 값은 다음과 같다. 참고로 예를 든 것은 영어권(en-us)의 3월이다.
  • "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.DateTimeFormatdateTimeFormat

새로운 Intl.DateTimeFormat 객체를 반환한다.

매개변수에 잘못된 값이 포함된 경우에 RangeError 예외가 발생한다.

Exception

RangeError

어떤 값이 집합 구조에 없거나 허용되는 범위가 아닐 때 오류를 다루는 객체이다.

상속 계층 탐색

Function

  • Properties

    • arguments

      함수에 전달된 인수를 조회한다. 유사 배열로 참조되며 인덱스로 접근이 가능하다.

    • caller

      지정된 함수를 호출한 함수를 참조한다. strict 모드에서는 사용할 수 없다.

    • length

      함수에 사용 되고 있는 인수의 개수를 조회한다.

    • name

      함수 이름을 조회한다.

    • prototype

      생성자 함수(constructor function)에 의해 생성된 인스턴스(instance)에게 상속되어지는 생성자의 프로토타입을 나타낸다.

  • Methods

    • apply()

      지정된 this와 제공된 인수를 가진 배열 또는 유사 배열로 함수를 호출한다.

    • bind()

      원본 함수와 동일한 본문을 갖는 바인딩된 함수를 만든다. this 키워드가 있는 경우 실제로 자신을 참조할 수 있도록 활성화된다.

    • call()

      인수를 지정하여 함수를 호출한다.

    • toString()

      함수의 소스 코드를 반환한다.

Object

  • Methods

    • hasOwnProperty()

      객체가 특정 프로퍼티를 가지고 있는지를 블린(boolean) 값으로 반환한다.

    • isPrototypeOf()

      해당 객체가 다른 객체의 프로토타입 체인에 속한 객체인지를 체크한다.

    • propertyIsEnumerable()

      매개 변수의 속성이 열거가능(enumerable)한지 여부를 체크한다.

    • toLocaleString()

      객체를 나타내는 문자열을  작동하는 지역(locale)의 방식으로 출력이 된다.

    • toString()

      객체를 나타내는 문자열을 반환한다.

    • valueOf()

      객체의 원시(primitive) 값을 반환한다.

  • Properties

    • constructor

      객체의 생성자 함수를 참조한다.

    • __proto__

      상속된 [[Prototype]] 참조하거나 설정가능하며 일반적으로 실제 코드상에서는 잘 사용되지 않는다. ECMAScript에서 사용되지 않는 비표준이지만 최신 웹브라우저에서는 비공식적으로 지원하고 있다. 따라서 곧 표준 속성으로 지원될 확률이 높다.

      현재는 표준 사양에 명시되었다.

버전 명세

ECMAScript Internationalization API Specification
#sec-intl-datetimeformat-constructor

지원 웹브라우저

©2024 devdic.com, Korea

출처를 밝힌 리소스 이외의 본 레퍼런스에 사용된 모든 생성물의 소유 및 저작권은 devdic.com에 있습니다. 특별히 재배포를 금지한 것 이외는 재배포가 가능하며 반드시 출처를 표기해 주시기 바랍니다.
현재는 베타 버전으로 미등록 및 불완전한 콘텐츠가 일부 있을 수 있습니다. 오류 및 기술 자료 제보(건의)는 언제든지 환영하며 감사드립니다.
기본적으로 W3C 기술 사양을 기준으로 작성하였으며 일반적이지 않은 기술 설명에 대한 내용의 일부는 Mozilla의 MDN web docs에서 도움 받았음을 밝힙니다. 그들을 존경합니다.

master@cydemy.com