NATIVE

settings_applicationsObject  >   settings_applicationsDate  >   settings_applications[[Prototype]]

NATIVE

Editing
  • account_tree
  • bug_report

stringtimeStringtoLocaleTimeString([string, Arraylocales, Objectoptions]])

Date 객체가 생성된 시점의 시간 부분을 현지 사용 언어에 맞는 문자열 형식으로 반환한다.

구문

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

생락하면 웹브라우저의 기본 Locale 값을 사용하지만 직접 지정할 수도 있다.

매개 변수

string, Arraylocales선택

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

Objectoptions선택

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

  • dateStyle: 날짜 형식 스타일이며 가능한 값은 다음과 같다.
    • 'full'
    • 'long'
    • 'medium'
    • 'short'
  • timeStyle: 시간 형식 스타일이며 가능한 값은 다음과 같다.
    • 'full'
    • 'long'
    • 'medium'
    • 'short'
  • fractionalSecondDigits: 호출할 때 적용할 소수 시간(초) 포맷
    • 0~3 사이의 값
  • calendar: 달력 선택
    • "buddhist", "chinese","coptic", "ethiopia", "ethiopic", "gregory", "hebrew", "indian", "islamic", "iso8601","japanese", "persian", "roc" 값 중에서 선택
  • numberingSystem: 번호 매김 시스템
    • "arab", "arabext", "bali", "beng", "deva", "fullwide", "gujr", "guru", "hanidec", "khmr", "knda","laoo", "latn", "limb", "mlym", "mong","mymr","orya","tamldec","telu","thai","tibt" 값 중에서 선택
  • 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)

반환

stringtimeString

Date 객체의 시간 부분을 현지화된 형식의 문자열로 반환한다.

버전 명세

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

지원 웹브라우저