사용 규칙
시간과 타임존
모든 시각은 오프셋이 명시된 형식으로 제공합니다. 날짜 필드와 시각 필드는 의미가 다릅니다.
표기
- 시각은 RFC 3339 에 오프셋을 붙여 제공합니다:
2026-08-14T09:03:00+09:00 - 한국 매장은 항상
+09:00입니다. - UTC 로 변환해 저장하셔도 되지만, 날짜 필드와 비교할 때는 주의가 필요합니다.
!
시각을 UTC 날짜로 자르지 마세요
2026-08-14T02:00:00+09:00 을 UTC 로 바꾸면 2026-08-13 이 됩니다.
매장 기준으로는 8월 14일 새벽 근무입니다. 날짜 집계는 반드시 매장 로컬 기준으로 하세요.날짜 필드
work_date, schedule_date, from, to 는
시각이 아니라 매장 로컬 날짜입니다. YYYY-MM-DD 형식이고
타임존이 없습니다.
같은 레코드의 두 종류 필드
{
"work_date": "2026-08-14", // 매장 기준 근무 일자
"clock_in_at": "2026-08-14T22:00:00+09:00", // 실제 출근 시각
"clock_out_at": "2026-08-15T06:00:00+09:00" // 다음 날 새벽 퇴근
}이 근무는 8월 14일 근무로 집계됩니다. 퇴근 시각이 15일이라고 해서 15일로 세면 안 됩니다.
자정을 넘기는 근무
- 근무 일자는 출근 시점의 매장 날짜를 따릅니다.
- 스케줄도 마찬가지로
planned_end_at이 다음 날이 될 수 있습니다. - 시간대별 통계에서는 근무 구간을 분 단위로 쪼개 각 시간에 배분합니다. 22시~06시 근무는 8개 시간대에 나뉘어 들어갑니다.
진행 중인 근무
아직 퇴근하지 않은 세션은 status: "open" 이며, 퇴근 시각과 근무시간 필드가 모두 null 입니다.
!
null 을 0 으로 바꾸지 마세요
근무시간이 0분인 것이 아니라 아직 확정되지 않은 것입니다. 0 으로 처리하면 인건비가 낮게
집계됩니다. 집계에서 제외하거나 별도로 표시하세요.
자정을 넘겨 아직 근무 중인 세션은 조회 기간 밖이더라도 함께 반환됩니다. 그렇지 않으면 "지금 근무 중인 사람"이 누락되기 때문입니다.