완전히 커스텀한 UI 가 필요하면 react-aria(Adobe 의 headless, 로직과 접근성만)로 직접 만든다. 기본 기능을 빨리 원하면 react-big-calendar(구글 캘린더 스타일, 날짜 라이브러리 선택 가능). 모던한 DX 와 가벼움을 원하면 Schedule-X(드래그·리사이즈, 레퍼런스 적음). 타임라인·리소스 뷰 같은 엔터프라이즈 기능이 필요하면 FullCalendar(플러그인 구조, 일부 유료, 번들 큼). 날짜 선택만이면 react-day-picker·dayzed·react-datepicker, headless 로는 use-lilius·h6s.

-- 캘린더 라이브러리: 상황으로 고른다 (위에서부터 매칭)
choose :: Need -> Library
choose FullyCustomUI = ReactAria          -- Adobe headless: 로직·접근성만, 일정 표시는 직접
choose QuickBasics   = ReactBigCalendar   -- 구글 캘린더 스타일, moment/date-fns/dayjs 선택 · 타입 아쉬움
choose ModernLight   = ScheduleX          -- React/Vue/Angular, 드래그·리사이즈 · 레퍼런스 적음
choose Enterprise    = FullCalendar       -- 플러그인, 타임라인·리소스 뷰 · 일부 유료, 번들 큼

-- 날짜 선택만: react-day-picker · dayzed · react-datepicker
-- 날짜 계산을 네이티브로 하려면: You-Dont-Need-Momentjs
-- headless: use-lilius · h6s — 찾기 어렵다, 갖다 써 보면 안다
#28

이번 달 1일과 말일 사이의 각 주 시작일을 eachWeekOfInterval 로 구하고, 주마다 그 시작일부터 6일 뒤까지를 eachDayOfInterval 로 펼치면 주 × 7 의 날짜 행렬이 된다. 첫 주와 마지막 주에는 앞뒤 달의 날짜도 들어온다.

-- 달력 행렬: 이번 달의 각 주 시작일 → 주마다 7일
matrix :: Day -> [[Day]]
matrix today = [ [w `addDays` i | i <- [0 .. 6]]       -- eachDayOfInterval { start = w, end = w + 6 }
               | w <- eachWeekOfInterval (startOfMonth today) (endOfMonth today) ]
-- 첫 주·마지막 주에는 앞뒤 달 날짜가 섞인다
#29

이벤트를 시작 시각 순으로 보며, 이미 끝난 레인 중 가장 낮은 것에 넣고, 없으면 레인을 하나 늘린다. 이렇게 하면 레인 수가 동시에 겹치는 최대 개수와 같아진다(구간 그래프의 탐욕 색칠). 겹치는 것끼리 묶은 그룹마다 레인 수를 세어 너비를 100% ÷ 레인 수, 위치를 레인 ÷ 레인 수로 둔다. 예: A 9–11, B 10–12, C 11–13 이면 A·C 가 레인 0, B 가 레인 1 이고 레인은 둘이다. D 14–15 는 새 그룹이라 혼자 전체 폭이다.

-- 겹치는 이벤트를 나란히 놓는다: 시작 순으로, 비어 있는 가장 낮은 레인에
assign :: [Event] -> [(Event, Lane)]
assign = go [] . sortOn (\e -> (start e, end e))
  where
    go _     []       = []
    go lanes (e : es) = (e, l) : go (set l (end e) lanes) es
      where l = fromMaybe (length lanes) (findIndex (<= start e) lanes)   -- 끝난 레인 중 가장 낮은 것
-- 레인 수 = 동시에 겹치는 최대 개수 (구간 그래프의 탐욕 색칠) — 가능한 한 적은 레인으로 모두 덮는 최적해다

-- 겹치는 것끼리 그룹으로 묶어 그룹마다 total 을 센다
groups :: [Event] -> [[Event]]   -- 다음 시작 < 그룹의 최대 끝이면 같은 그룹
style (lane, total) = { left = lane / total * 100%, width = 100% / total }

assign [A 9 11, B 10 12, C 11 13] == [(A, 0), (B, 1), (C, 0)]   -- total 2
#510

2025-10-28(화)이 든 주를 구한다. startOf(isoWeek) 는 ISO 8601 이라 월요일 10-27 부터 일요일 11-02 까지다 — 캘린더 UI 에 주로 쓴다. startOf(week) 는 로케일을 따라 기본 en·ko 에선 일요일 10-26 부터, en-gb 에선 월요일부터다. 시작일에 0~6일을 더해 7개를 만든다.

-- 특정 날짜가 든 주의 7일
weekDays :: Bool -> Date -> [Date]                -- iso 기본값 True: getWeekDays(date) 는 월~일
weekDays iso d = [start `addDays` i | i <- [0..6]]
  where start = startOf (if iso then IsoWeek else Week) d
-- IsoWeek: ISO 8601, 월요일 시작 (캘린더 UI 에 주로) — dayjs.extend(isoWeek) 필요
-- Week:    로케일을 따른다 — 기본 en·ko 는 일요일, en-gb 는 월요일

weekDays True "2025-10-28" == ["2025-10-27", …, "2025-11-02"]
#513