Date Picker
캘린더에서 날짜·기간·여러 날짜를 선택할 때 사용하는 컴포넌트입니다.

Date Picker는 캘린더에서 날짜를 직접 골라 입력받는 컴포넌트입니다. 날짜 그리드를 핵심으로, Layout에 따라 화면에 바로 펼쳐지거나(Inline) 입력 필드를 눌러 Popover·Sheet로 떠오릅니다. Selection으로 하루·기간·여러 날짜 중 어떤 방식으로 고를지 정합니다.
시간(시·분) 입력은 Date Picker에 포함되지 않습니다. 날짜와 시간을 함께 받아야 할 때는 Date Picker와 Time Picker를 나란히 배치합니다.
Anatomy
Date Picker는 Header, Weekday Row, Date Grid로 구성됩니다.
- Header: 현재 연·월과 이전·다음 버튼으로 구성됩니다. 연·월을 누르면 월·연도를 고르는 휠이 열립니다.
- Weekday Row: 요일 이름 7개를 표시합니다. 주 시작 요일은 지역마다 다르며, 한국에서는 일요일부터 시작합니다.
- Date Grid: 날짜를 요일에 맞춰 배치한 그리드입니다. 달의 앞뒤 빈 자리는 비워 둡니다. Visible Range가 Week이면 한 주, Two Weeks이면 두 주만 보여줍니다.
월·연도 전환
연·월을 누르면 날짜 그리드 자리에 월·연도를 고르는 휠이 나타납니다. 연과 월이 휠 두 개로 나란히 놓이고, 가운데 강조된 줄이 현재 선택입니다. 휠을 굴려 고른 뒤 연·월을 다시 누르면 날짜 그리드로 돌아옵니다.
Week·Two Weeks는 날짜 그리드가 낮아 휠을 담을 수 없으므로, 휠을 연·월 아래 패널로 띄웁니다. 패널은 아래 콘텐츠를 밀어내지 않고 그 위에 겹쳐집니다.
연·월 옆 화살표는 휠이 닫혀 있으면 ▼, 열려 있으면 ▲로 바뀌어 지금 상태를 알려줍니다.
이전·다음 버튼은 화면에 보이는 범위만큼 이동합니다. Month는 한 달, Week는 한 주, Two Weeks는 두 주씩입니다. 멀리 떨어진 월로 갈 때는 휠을 씁니다. 이동하면 새 날짜가 누른 버튼 쪽에서 살짝 밀려 들어오며 나타나, 어느 방향으로 넘어갔는지 알 수 있습니다.
Properties
Selection
날짜를 어떤 방식으로 선택할지 정하는 Property입니다.
- Single: 하루를 선택합니다. 날짜를 누르면 Selected로 표시됩니다. Inline은 누르는 즉시 값이 정해지고, Popover·Sheet는 선택 버튼을 눌러 확정합니다. 입주 가능일·방문 약속일에 씁니다.
- Range: 시작일과 종료일로 기간을 선택합니다. 첫 탭에서 Range Start를 지정하고, 두 번째 탭에서 시작일 이후면 Range End로 지정되어 사이가 In Range로 이어집니다. 시작일 이전을 누르면 그 날짜를 새 시작일로 바꿉니다. 범위가 정해진 뒤 다시 탭하면 기존 범위를 해제하고 새로 시작합니다. 광고 기간·여행 일정에 씁니다.
- Multiple: 여러 날짜를 따로따로 선택합니다. 칸을 누를 때마다 Selected가 토글되고, 이미 고른 날짜를 다시 누르면 선택이 풀립니다. 모임 후보일에 씁니다.
Range는 시작·종료 칸을 채우고 그 사이를 연결된 띠로 잇습니다. Multiple은 고른 날짜를 각각 독립된 칸으로 표시하며 띠로 잇지 않습니다.
Visible Range
캘린더가 한 번에 보여주는 날짜 범위를 정합니다.
| Value | 범위 | 대표 사용처 |
|---|---|---|
| Month (기본) | 한 달의 날짜 그리드 전체 | 입주 가능일·광고 기간·소비기한 등 대부분 |
| Two Months | 두 달을 가로로 나란히 | 데스크탑에서 Range를 선택할 때 |
| Continuous | 여러 달을 세로로 이어 붙여 스크롤로 탐색 | 모바일 Sheet에서 Range를 선택할 때 |
| Week | 한 주(7칸)만 가로로 | 모임 일정 캘린더처럼 날짜로 콘텐츠 탐색 |
| Two Weeks | 두 주(14칸)를 두 줄로 | 긴 폼에서 가까운 일정을 고를 때 |
Visible Range는 Layout·Selection과 따로 정합니다. 모바일 폼에서는 Month가 기본이고, 데스크탑에서 Range를 고를 때는 Two Months, 모바일 Sheet에서 Range를 고를 때는 Continuous를 검토합니다. Week은 캘린더가 날짜별 콘텐츠 탐색 자체를 맡을 때 씁니다.
Two Weeks는 Month보다 높이를 줄이면서도 다음 주까지 이어서 보여줍니다. 한 화면에서 날짜를 여러 번 고르는 긴 폼처럼, Month를 쌓으면 스크롤이 길어질 때 씁니다. 다른 Visible Range와 같은 좌·우 화살표로 두 주씩 이동하고, 제목에는 첫 줄에서 더 많은 날짜가 속한 월을 표시합니다.
Continuous는 이전·다음 버튼과 연·월 대신 스크롤로 이동합니다. 요일 줄은 위에 고정해 어느 달로 스크롤해도 요일이 보이고, 각 달은 연·월 제목과 날짜 그리드를 묶어 반복합니다. Range와 함께 쓰면 하단에 선택 버튼과 초기화 버튼을 둡니다.
Date Cell
날짜 칸이 가지는 상태입니다. 날짜의 성격을 색·배경으로 구분해, 고를 수 있는 날짜와 이미 고른 날짜를 한눈에 알 수 있게 합니다.
| State | 설명 |
|---|---|
| Enabled | 선택할 수 있는 기본 상태입니다. |
| Pressed | 칸을 누르고 있는 동안의 상태입니다. |
| Today | 오늘 날짜입니다. 옅은 배경으로 표시합니다. |
| Selected | 선택된 날짜입니다(Single·Multiple). 채운 배경으로 표시합니다. |
| Range Start / Range End | 기간의 시작·종료 날짜입니다(Range). 채운 배경으로 표시합니다. |
| In Range | 기간 사이의 날짜입니다(Range). 시작·종료를 잇는 연결된 띠로 표시합니다. |
| Disabled | 선택할 수 없는 날짜입니다. 지난 날짜나 예약 불가일에 사용합니다. |
데스크탑에서는 포인터가 올라간 Hover, 키보드 포커스를 받은 Focused 상태가 더해집니다.
달의 앞뒤 빈 자리(이전·다음 달 날짜)는 흐리게 표시하지 않고 비워 둡니다.
이미 확정되어 바꿀 수 없는 값은 Read Only로 표시합니다. 채움 배경은 유지하되 톤을 낮추고, 눌러도 반응하지 않습니다. Selected·Range Start·Range End에 적용할 수 있습니다.
Guidelines
Layout 선택하기
날짜 선택이 화면에서 차지하는 비중과 플랫폼에 따라 Layout을 정합니다.
- Inline: 날짜 선택이 화면의 핵심 작업이거나, 글쓰기·설정 플로우의 한 단계일 때 사용합니다. 캘린더가 흐름 안에 바로 보여 추가 탭 없이 날짜를 고릅니다. 입주 가능일·광고 기간·모임 일정처럼 단계형 플로우에서 주로 쓰며, 값 확정은 화면의 다음·완료 버튼이 맡습니다.
- Sheet: 모바일 폼에서 입력 필드를 눌러 날짜를 고를 때 사용합니다. 캘린더가 하단 시트로 올라오고, 시트 안의 선택 버튼으로 선택을 확정합니다.
- Popover: 데스크탑 폼에서 입력 필드 바로 아래 패널로 캘린더를 띄울 때 사용합니다. 아래 공간이 부족하면 위쪽에 띄웁니다.
Popover·Sheet를 여는 입력 필드에는 Input Button이나 Field를 씁니다. 라벨·도움말 같은 폼 요소와 입력 필드의 상태, 캘린더 아이콘 노출은 해당 컴포넌트 가이드를 따르고, 캘린더가 열려 있는 동안 입력 필드는 Open 상태로 표시합니다.
진입 시 보여줄 월
캘린더를 처음 열면 오늘이 속한 월을 먼저 보여줍니다. 사용자가 현재 시점을 기준으로 빠르게 판단할 수 있습니다. 이미 선택된 날짜가 있으면 그 날짜가 속한 월을 먼저 보여줍니다. Range는 시작일, Multiple은 가장 이른 선택일이 속한 월을 기준으로 합니다.
기간·여러 날짜 선택 안내
Range에 최소·최대 기간 제약이 있으면 Callout으로 미리 안내합니다. 사용자가 선택을 마친 뒤 에러를 마주하기 전에 제약을 알 수 있게 돕습니다. 시작일만 찍힌 미완성 범위에서는 선택 버튼을 비활성화합니다.
Multiple의 최소·최대 개수 제약도 Callout으로 안내합니다. 선택할 때마다 남은 개수를 알 수 있게 하면 좋습니다.
수정할 수 없는 날짜 다루기
수정할 수 없는 날짜는 두 가지로 구분합니다. 이미 확정된 값은 Read Only로, 고를 수 없는 날짜는 Disabled로 표시합니다. Read Only는 흐리게 표시하되 채움 배경을 남겨 값이 있다는 것을 알 수 있게 하고, Disabled는 배경 없이 흐리게만 표시합니다.
진행 중인 광고 기간을 연장하는 경우가 대표적입니다. 시작일만 Read Only로 고정하고, 종료일은 자유롭게 선택합니다. 캘린더 전체가 보기 전용인 화면이라면 셀마다 지정하지 않고 캘린더 전체를 Read Only로 둡니다.
Last updated on