수면 날짜와 일일 노트

밤 시작일은 iPhone과 Android의 기본 설정입니다. 화요일 아침에 지난밤 수면을 내보내려면 보통 어제인 월요일을 선택합니다. Health.md의 일일 수면 요약은 현지 시간 12:00부터 다음 날 12:00까지, 즉 월요일 정오부터 화요일 정오까지를 사용합니다. 일반 활동 요약의 자정 경계와 다릅니다.

내보내기 설정에서 아침 종료일을 선택하면 각 수면 세션 전체가 내보내기 시간대에서 끝난 날짜에 포함되며 정오에 잘리지 않습니다. 월요일 밤에 시작해 화요일 아침에 끝난 수면은 **화요일(오늘)**로 내보내세요. 화요일 낮잠도 화요일에 포함됩니다. 설정 변경은 새 작업에 적용되며, 저장된 작업은 수락 당시의 날짜 배정 방식을 유지합니다.

수면이 어제 노트에 표시되는 이유

이 구간은 자정 이후에 잠들어도 일반적인 하룻밤을 함께 다룹니다. 시작 정오는 포함하고 다음 정오는 제외합니다. 수면이 정오를 넘으면 인접한 일일 요약에 각각 반영될 수 있습니다. 원본 타임스탬프를 노트 날짜에 맞춰 바꾸지는 않습니다.

Apple과 Android 모두 두 수면 날짜 배정 방식을 지원합니다. 지표, 수면 단계, 원본 기록과 집계 방식은 플랫폼에 따라 다를 수 있습니다.

어떤 날짜를 내보내나요?

밤 시작일: 다음은 현지 시간의 가상 예시이며 실제 건강 기록이 아닙니다.

수면 또는 활동	내보낼 날짜
월요일 23:45부터 화요일 07:30	월요일
화요일 01:00부터 화요일 07:30	화요일이 아닌 월요일
화요일 낮잠 14:00부터 14:30	화요일
화요일 걸음 수와 활동	화요일
월요일 밤 수면과 화요일 활동	월요일과 화요일

내보내기의 현지 시간대를 확인하세요. 다른 앱의 기상일이나 파일 수정 시간이 일지 날짜를 결정하지 않습니다.

예상한 노트가 비어 있다면

일지 날짜와 선택한 수면 지표를 확인합니다.
시계나 원본 앱이 Apple Health 또는 Health Connect와 동기화될 때까지 기다린 뒤 미리 보고 같은 날짜를 다시 내보냅니다.
접근 권한을 확인합니다. iPhone의 빈 HealthKit 결과만으로 읽기 거부 여부를 알 수 없습니다. Android에서는 원본이 지원되는 기록을 Health Connect에 실제로 썼는지 확인합니다.
저장 위치와 기록됨, 건너뜀, 실패 결과를 확인합니다. 미리 보기는 파일 저장 성공을 증명하지 않습니다. 누락은 0이 아닙니다.

Daily Note Injection과 API Endpoint 요약은 해당 작업에서 선택한 수면 날짜 배정 방식을 따릅니다. 원본 데이터 동기화가 늦으면 그 방식에 맞는 날짜를 다시 내보내거나 일정의 이전 날짜 포함 범위를 확인하세요. 백그라운드 실행 시각은 목표이며 쓰기 성공을 보장하지 않습니다.

요약, 원본 기록과 세션 쿼리

원시 또는 정규 기록은 원본 시각과 자체 날짜 귀속 규칙을 유지합니다. 일일 합계에서 세션을 복원하거나 원본 구간을 추가 수면으로 합산하지 마세요.

밤 시작일: Apple의 원시 아카이브는 원본 시작 시각을 기준으로 현지 자정부터 다음 자정까지의 날짜에 기록을 배정합니다. 반면 수면 요약은 정오부터 다음 정오까지의 일지 구간에 맞춰 시간 구간을 자릅니다. 따라서 원시 Sleep Analysis 쿼리가 성공해 아침 기록이 포함되어도 해당 날짜의 수면 요약은 비어 있을 수 있습니다. 요약 누락을 조사하기 전에 이전 일지 날짜를 내보내고 time_context.calendar_timezone을 확인하세요. 예를 들어 9월 22일 04:03–11:52 UTC 기록은 UTC에서는 모두 9월 21일 요약에 속합니다. Europe/Lisbon에서는 마지막 52분이 현지 정오 이후이므로 그 부분은 9월 22일 요약에 반영됩니다.

수면 단계 집계에 명시적인 inBed 기록이 꼭 필요한 것은 아닙니다. 해당 기록이 없으면 Apple 요약은 사용 가능한 잠든 상태의 수면 단계 구간의 합집합을 사용합니다. 침대에 머문 시간 데이터가 없다고 해서 그 시간이 생성되지는 않습니다. 요약 쿼리 실패는 diagnostics.partial_failures에 표시되어야 합니다. 쿼리가 성공했지만 조건에 맞는 구간이 없는 것은 정상적인 데이터 부재입니다. 안정 시 심박수는 별도의 달력 날짜별 쿼리를 사용하며 실제 안정 시 심박수 측정이 필요합니다. 수면 단계나 읽기 권한만으로는 이 측정값이 제공되지 않습니다.

healthmd_sleep_sessions는 지원되는 Apple Health CLI/MCP 설정이 필요합니다. Android 형식 지정 MCP 쿼리는 현재 지원되지 않습니다.플랫폼 기능과 MCP를 확인하세요.

일정, 문제 해결, 형식 안내도 참고하세요.