Date.toLocaleDateString([locale[, options]])
Date.toLocaleDateString()
메서드는 날짜를 지정한 로케일의 문자열 표현으로 변환한다.
첫 번째 인자인 로케일(locale) 문자열을 지정하면 해당 언어 및 국가에 적합한 날짜 형식을 반환한다. 로케일을 명시하지 않았다면 웹 브라우저의 기본 로케일 window.navigator.language
값을 사용한다.
두 번째 인자인 options
는 날짜 형식을 더 상세하게 지정할 수 있는 옵션 객체다. 연도, 월, 일 등의 표현 방식을 원하는 방식으로 설정할 수 있다. 더 자세한 내용은 MDN 참고.
new Date().toLocaleDateString('en-US'); // '7/1/2022'
new Date().toLocaleDateString('ko-KR'); // '2022. 7. 1.'
// 날짜와 시간을 상세히 지정하여 출력
new Date().toLocaleDateString('ko-KR', {
weekday: 'long', // 요일 표시 (긴 이름으로 표시, 가능한 값: 'long', 'short', 'narrow')
year: 'numeric', // 연도 표시 (숫자로 표시, 가능한 값: 'numeric', '2-digit')
month: 'long', // 월 표시 (긴 이름으로 표시, 가능한 값: 'numeric', '2-digit', 'long', 'short', 'narrow')
day: 'numeric', // 일 표시 (숫자로 표시, 가능한 값: 'numeric', '2-digit')
hour: '2-digit', // 시간 표시 (2자리 숫자, 가능한 값: 'numeric', '2-digit')
minute: '2-digit', // 분 표시 (2자리 숫자, 가능한 값: 'numeric', '2-digit')
second: '2-digit', // 초 표시 (2자리 숫자, 가능한 값: 'numeric', '2-digit')
timeZoneName: 'long' // 시간대 이름 (긴 이름으로 표시, 가능한 값: 'long', 'short')
}); // '2022년 7월 1일 목요일 오전 12시 19분 1초 한국 표준시'
자주 사용하는 로케일 목록은 아래와 같다. Saimana.com 사이트에서 더 많은 국가별 로케일 목록을 확인할 수 있다. 참고로 Saimana 사이트에선 로케일 코드가 언더스코어로 _
구분돼 있지만, 자바스크립트의 로케일 코드는 하이픈 -
을 사용하기 때문에 이 부분만 바꿔서 사용하면 된다.
로케일 코드 | 설명 (지역 - 언어) |
---|---|
en-US |
미국 - 영어 |
en-GB |
영국 - 영어 |
es-ES |
스페인 - 스페인어 |
es-MX |
멕시코 - 스페인어 |
fr-FR |
프랑스 - 프랑스어 |
de-DE |
독일 - 독일어 |
it-IT |
이탈리아 - 이탈리아어 |
pt-PT |
포르투갈 - 포르투갈어 |
pt-BR |
브라질 - 포르투갈어 |
ru-RU |
러시아 - 러시아어 |
zh-CN |
중국 본토 - 중국어 간체 |
zh-TW |
대만 - 중국어 번체 |
ja-JP |
일본 - 일본어 |
ko-KR |
한국 - 한국어 |
ar-SA |
사우디아라비아 - 아랍어 |