Date.prototype.toLocaleDateString()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. Itâs been available across browsers since 2015ë 7ì.
Date ì¸ì¤í´ì¤ì toLocaleDateString() ë©ìëë íì§ íì¤ ìê°ë ë ì§ì ë ì§ ë¶ë¶ì ì¸ì´ì ë§ì¶° ííí 문ìì´ì ë°íí©ëë¤. Intl.DateTimeFormat API를 ì§ìíë 구íìì ì´ ë©ìëë ë¨ìí Intl.DateTimeFormatì í¸ì¶í©ëë¤.
toLocaleStringì í¸ì¶í ëë§ë¤ ë°©ëí íì§í 문ìì´ ë°ì´í°ë² ì´ì¤ìì ê²ìì ìíí´ì¼ íë¯ë¡ ë¹í¨ì¨ì ì¼ ì ììµëë¤. ë©ìëê° ëì¼í ì¸ì를 ì¬ì©íì¬ ì¬ë¬ ë² í¸ì¶ëë ê²½ì° DateTimeFormat ê°ì²´ê° ì ë¬ë ì¸ì를 기ìµíê³ ë°ì´í°ë² ì´ì¤ì ì¼ë¶ë¥¼ ìºìíê¸°ë¡ ê²°ì í ì ìì¼ë¯ë¡ Intl.DateTimeFormat ê°ì²´ë¥¼ ìì±íê³ ê·¸ format() ë©ìë를 ì¬ì©íë ê²ì´ ë ì¢ìµëë¤. ì´ë ê² í¨ì¼ë¡ì í¥í format í¸ì¶ìì ë³´ë¤ ì íë 컨í
ì¤í¸ ë´ìì íì§í 문ìì´ì ê²ìí ì ììµëë¤.
ìëí´ ë³´ê¸°
const event = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
const options = {
weekday: "long",
year: "numeric",
month: "long",
day: "numeric",
};
console.log(event.toLocaleDateString("de-DE", options));
// Expected output (varies according to local timezone): Donnerstag, 20. Dezember 2012
console.log(event.toLocaleDateString("ar-EG", options));
// Expected output (varies according to local timezone): Ø§ÙØ®Ù
ÙØ³Ø Ù¢Ù Ø¯ÙØ³Ù
Ø¨Ø±Ø Ù¢Ù Ù¡Ù¢
console.log(event.toLocaleDateString(undefined, options));
// Expected output (varies according to local timezone and default locale): Thursday, December 20, 2012
구문
toLocaleDateString()
toLocaleDateString(locales)
toLocaleDateString(locales, options)
매ê°ë³ì
locales ë° options 매ê°ë³ìë í¨ìì ëìì ì¬ì©ì ì ìíê³ ì í리ì¼ì´ì
ìì íì ì§ì ê·ì¹ì ì¬ì©í ì¸ì´ë¥¼ ì§ì í ì ìëë¡ í©ëë¤.
Intl.DateTimeFormat API를 ì§ìíë 구íì²´ìì ì´ë¬í 매ê°ë³ìë Intl.DateTimeFormat() ìì±ì 매ê°ë³ìì ì íí ëìí©ëë¤. Intl.DateTimeFormatì ì§ìíì§ ìë 구íì²´ì ë 매ê°ë³ì를 모ë 무ìíëë¡ ìì²íë¯ë¡ ì¬ì©ëë ë¡ì¼ì¼ê³¼ ë°íëë 문ìì´ì íìì ì ì ì¼ë¡ 구íì²´ì ë°ë¼ ë¬ë¼ì§ëë¤.
localesOptional-
BCP 47 ì¸ì´ íê·¸ê° í¬í¨ë 문ìì´ ëë ì´ë¬í 문ìì´ì ë°°ì´ì ëë¤.
Intl.DateTimeFormat()ìì±ìì 매ê°ë³ìì¸localesê³¼ ëìë©ëë¤.Intl.DateTimeFormatì ì§ìíì§ ìë 구íì²´ììë ì´ ë§¤ê°ë³ì를 무ìíê³ ì¼ë°ì ì¼ë¡ í¸ì¤í¸ì ë¡ì¼ì¼ì´ ì¬ì©ë©ëë¤. optionsOptional-
ì¶ë ¥ íìì ì¡°ì íë ê°ì²´ì ëë¤.
Intl.DateTimeFormat()ìì±ìì 매ê°ë³ìoptionsê³¼ ëìë©ëë¤.timeStyleìµì ì´ ë°ëì ì ìëì§ ììì¼ íë©°, ê·¸ë ì§ ìì¼ë©´TypeErrorê° ë°ìí©ëë¤.weekday,year,month,dayê° ëª¨ë ì ìëì§ ìì ê²½ì°year,month,dayì"numeric"ì¼ë¡ ì¤ì ë©ëë¤.Intl.DateTimeFormatì ì§ìíì§ ìë 구íì²´ììë ì´ ë§¤ê°ë³ì를 무ìë©ëë¤.
ì´ ë§¤ê°ë³ì ì¬ì© ë°©ë²ì ëí ìì¸í ë´ì©ì Intl.DateTimeFormat() ìì±ì를 참조íì기 ë°ëëë¤.
ë°í ê°
ì¸ì´ë³ ê·ì¹ì ë°ë¼ ì§ì ë ë ì§ì ë ì§ ë¶ë¶ì ëíë´ë 문ìì´ì ëë¤.
Intl.DateTimeFormat를 구íí 구íì²´ììë new Intl.DateTimeFormat(locales, options).format(date)ê³¼ ëì¼íë©°, ì¬ê¸°ì optionsì ììì ì¤ëª
í ëë¡ ì ê·íë©ëë¤.
ì°¸ê³ :
ëë¶ë¶ì ê²½ì° toLocaleDateString()ìì ë°íëë íìì ì¼ê´ì ì
ëë¤. ê·¸ë¬ë ê²°ê³¼ë ìê°, ì¸ì´ ë° êµ¬íì²´ì ë°ë¼ ë¬ë¼ì§ ì ììµëë¤. ëí ì¤ê³ì ë°ë¼ ë¤ìí ê²°ê³¼ê° ìì¼ë©° ëª
ì¸ìì íì©ë©ëë¤. toLocaleDateString()ì 결과를 ì ì ê°ê³¼ ë¹êµí´ìë ìë©ëë¤.
ìì
>toLocaleDateString() ì¬ì©í기
기본ì ì¼ë¡ localeì ì§ì íì§ ìê³ ì´ ë©ìë를 ì¬ì©íë©´ 기본 ë¡ì¼ì¼ê³¼ 기본 ìµì
ì¼ë¡ íìì´ ì§ì ë 문ìì´ì´ ë°íë©ëë¤.
const date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0));
// ì¸ì ìë toLocaleDateString()ë 구íì²´, 기본 ë¡ì¼ì¼, 기본 ìê°ëì ìì¡´í©ëë¤.
console.log(date.toLocaleDateString());
// America/Los_Angeles ìê°ë, en-US ë¡ì¼ì¼ìì ì¤íìì¼°ì ê²½ì° "12/11/2012" ì
ëë¤.
locales ë° options 매ê°ë³ì ì§ì ì¬ë¶ íì¸
locales ë° options 매ê°ë³ìë êµì í API ì§ìì´ ì í ì¬íì´ê³ ì¼ë¶ ìì¤í
ìë íìí ë°ì´í°ê° ìì ì ì기 ë문ì 모ë 구íì²´ìì ì§ìëì§ ìì ì ììµëë¤. êµì í를 ì§ìíì§ ìë 구íì²´ì ê²½ì° toLocaleDateString()ì íì ìì¤í
ì ë¡ì¼ì¼ì ì¬ì©íë¯ë¡ ì¬ì©ìê° ìíë ë¡ì¼ì¼ì´ ìë ì ììµëë¤. locales ë° options ë§¤ê° ë³ì를 ì§ìíë 모ë 구íì Intl를 ì§ìí´ì¼ íë¯ë¡, ìë ì½ëë¡ ì§ì ì¬ë¶ë¥¼ íì¸í ì ììµëë¤.
function toLocaleDateStringSupportsLocales() {
return (
typeof Intl === "object" &&
!!Intl &&
typeof Intl.DateTimeFormat === "function"
);
}
locales ì¬ì©í기
ì´ ìë íì§íë ë ì§ íìì ëª ê°ì§ ë³íì ë³´ì¬ì¤ëë¤. ì í리ì¼ì´ì
ì ì¬ì©ì ì¸í°íì´ì¤ìì ì¬ì©ëë ì¸ì´ì íìì ê°ì ¸ì¤ë ¤ë©´ locales ì¸ì를 ì¬ì©íì¬ í´ë¹ ì¸ì´(ë° ì¼ë¶ ëì²´ ì¸ì´)를 ì§ì í´ì¼ í©ëë¤.
const date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
// ìë íìì íì§ ìê°ëê° USì America/Los_Angeles ë¼ê³ ê°ì í©ëë¤
// US Englishë ì-ì¼-ë
ìì를 ì¬ì©í©ëë¤.
console.log(date.toLocaleDateString("en-US"));
// "12/20/2012"
// British Englishë ì¼-ì-ë
ìì를 ì¬ì©í©ëë¤.
console.log(date.toLocaleDateString("en-GB"));
// "20/12/2012"
// íêµì ì°-ì-ì¼ ìì를 ì¬ì©í©ëë¤.
console.log(date.toLocaleDateString("ko-KR"));
// "2012. 12. 20."
// í르ììì ì´ë²¤í¸. íìë ¥ Hijri ë¡ ë³íí기 ë§¤ì° ì´ë µìµëë¤
console.log(date.toLocaleDateString("fa-IR"));
// "Û±Û³Û¹Û±/Û¹/Û³Û°"
// ë¤ìê° ìëì´ë¥¼ ë§íë êµê°ìì ìëì´ë ì¤ì ìë ì«ì를 ì¬ì©í©ëë¤
console.log(date.toLocaleDateString("ar-EG"));
// "Ù¢Ù â/١٢â/٢٠١٢"
// ì¼ë³¸ì¸ì ìí´ ì´í리ì¼ì´ì
ì 2012ë
ì í¤ì´ì¸ì´ 24ë
ì´ë¼ë ì¼ë³¸ ë¬ë ¥ì ì¬ì©í길 ìí ì ììµëë¤
console.log(date.toLocaleDateString("ja-JP-u-ca-japanese"));
// "24/12/20"
// ë°ë¦¬ì´ì ê°ì´ ìì²íë ì¸ì´ë¥¼ ì§ìíì§ ìì§ë§ ì¸ëë¤ì´ì¬ì´ë¡ ëì²´ ì¸ì´ë¥¼ ì§ì í ê²½ì°
console.log(date.toLocaleDateString(["ban", "id"]));
// "20/12/2012"
options ì¬ì©í기
toLocaleDateString()ì ê²°ê³¼ë ìëì ê°ì´ options 매ê°ë³ì를 ì¬ì©íì¬ ì¬ì©ì ë§ì¶¤ ì¤ì í ì ììµëë¤.
const date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
// 긴 ë ì§ íìì í¨ê» ìì¼ì ìì²í©ëë¤
const options = {
weekday: "long",
year: "numeric",
month: "long",
day: "numeric",
};
console.log(date.toLocaleDateString("de-DE", options));
// "Donnerstag, 20. Dezember 2012"
// ì´í리ì¼ì´ì
ì UTC를 ì¬ì©í기를 ìí ì ìê³ ì´ë¥¼ ëª
ìíí©ëë¤.
options.timeZone = "UTC";
options.timeZoneName = "short";
console.log(date.toLocaleDateString("en-US", options));
// "Thursday, December 20, 2012, UTC"
ëª ì¸ì
| Specification |
|---|
| ECMAScript® 2027 Language Specification> # sec-date.prototype.tolocaledatestring> |
| ECMAScript® 2027 Internationalization API Specification> # sup-date.prototype.tolocaledatestring> |