NATIVE

settings_applicationsObject  >   settings_applicationsDate  >   settings_applications[[Prototype]]

NATIVE

Editing
  • account_tree
  • bug_report

stringdateStringtoLocaleString(string, Arraylocales, Objectoptions]])

Date 객체가 생성된 시점의 날짜의 문자열 표현을 지역의 언어에 맞는 형식으로 반환한다.

구문

형식
date.toLocaleString([locales[, options]])

매개 변수

string, Arraylocales선택

BCP 47 언어 태그를 나타내는 문자열이거나 이러한 문자열을 원소로 갖는 배열을 지정한다. 생략하면 웹브라우저의 기본 값을 사용한다.

Objectoptions선택

다음의 속성들을 전부 또는 일부 포함한 객체로 지정할 수 있다.

  • dateStyle: 날짜 형식 스타일이며 가능한 값은 다음과 같다.
    • 'full'
    • 'long'
    • 'medium'
    • 'short'
  • timeStyle: 시간 형식 스타일이며 가능한 값은 다음과 같다.
    • 'full'
    • 'long'
    • 'medium'
    • 'short'
  • localeMatcher: 사용할 locale 일치 알고리즘이며 기본 값은 "best fit"이다.
    • 'best fit'
    • 'lookup'
  • timeZone: 사용할 시간대
    • Asia/ShanghaiAsia/KolkataAmerica/New_York
  • hour12: 12시간을 사용할지 여부
    • true
    • false
  • hourCycle: 사용할 시간 주기
    • 'h11'
    • 'h12'
    • 'h23'
    • 'h24'
  • formatMatcher: 사용할 형식 일치 알고리즘이며 기본 값은 'best fit'이다.
    • 'basic'
    • 'best fit'
  • weekday: 요일을 나타낸다.
    • 'long'(예: Thursday)
    • 'short'(예: Thu)
    • 'narrow'(예: T)
  • era: 시대의 표현
    • 'long'(예: Anno Domini)
    • 'short'(예: AD)
    • 'narrow'(예: A)
  • year: 연도를 나타냄
    • 'numeric'(예: 2020)
    • '2-digit'(예: 20)
  • month: 월을 나타냄
    • 'numeric'(예: 5)
    • '2-digit'(예: 05)
    • 'long'(예: March)
    • 'short'(예: Mar)
    • 'narrow'(예: M)
  • day: 일을 표현
    • 'numeric'(예: 1)
    • '2-digit'(예: 01)
  • hour: 시간을 표현
    • 'numeric'(예: 1)
    • '2-digit'(예: 01)
  • minute: 분을 표현
    • 'numeric'(예: 1)
    • '2-digit'(예: 01)
  • second: 초를 표현
    • 'numeric'(예: 1)
    • '2-digit'(예: 01)
  • timeZoneName: 시간대 이름을 나타냄
    • 'long'(예: British Summer Time)
    • 'short'(예: GMT+1)

반환

stringdateString

지정한 사용 언어에 따라 날짜 형식을 가진 문자열을 반환한다.

버전 명세

ECMAScript 2024(15th Edition)
#sec-date.prototype.tolocalestring
ECMAScript Internationalization API Specification
#sup-date.prototype.tolocalestring

지원 웹브라우저