본문 바로가기

한국어 날짜와 요일 표시

Date 를 “2026년 10월 15일 목요일” 로 바꾸고, 일요일부터 시작하는 요일 글자를 써요.

무엇이 어려운가요

toLocaleDateString 은 브라우저·Node 버전에 따라 “2026. 10. 15.” 처럼 다르게 나올 수 있어요. 서버와 브라우저 결과가 다르면 Next.js 에서 hydration 오류가 나요.

직접 입력해 보세요

formatKoreanDate(날짜)
'2026년 10월 15일 목요일'
formatKoreanDate(날짜, false)
'2026년 10월 15일'

코드

npm install @bestow-ui/korean-utils
import { formatKoreanDate, KOREAN_WEEKDAYS } from '@bestow-ui/korean-utils';

formatKoreanDate(new Date(2026, 9, 15));        // '2026년 10월 15일 목요일'
formatKoreanDate(new Date(2026, 9, 15), false); // '2026년 10월 15일'

KOREAN_WEEKDAYS; // ['일', '월', '화', '수', '목', '금', '토']

알아 둘 점

  • 날짜 버튼의 스크린리더 이름(aria-label)으로 쓰기 좋아요. “15” 만 읽히는 대신 날짜 전체가 들려요.

  • Date 의 지역 시간 기준으로 읽어요. 서버에서 부를 때는 서버 시간대를 확인하세요.

React 입력 컴포넌트

DatePicker( @bestow-ui/react)는 이 함수를 쓰는 입력 칸이에요. 일요일부터 시작하는 달력과 YYYY-MM-DD 직접 입력을 함께 써요.

DatePicker 문서 보기