날짜 입력에서 11월 3일을 골랐는데 저장 후 11월 2일로 보인다면, 먼저 그 값이 달력 날짜인지 한 순간의 시각인지 확인하세요. 마감일처럼 “어느 날”이 필요한 필드를 임의로 자정 시각으로 바꾸고 다른 시간대로 표시하면 하루가 어긋날 수 있습니다.
날짜가 바뀐 최초 지점을 찾으세요
| 값의 의미·관찰 | 첫 확인 | 분리할 처리 |
|---|---|---|
| 마감일·생일처럼 달력의 어느 날 | 입력 value·API 필드·DB 타입 | 날짜 문자열을 시각으로 자동 변환했는가 |
| 이미 발생한 이벤트의 시각 | Z 또는 offset을 포함한 시각과 표시 시간대 | 같은 순간을 어느 지역의 날짜로 보여 줄 것인가 |
| 날짜 문자열 파싱 뒤 하루 전으로 보임 | UTC 파싱 후 getDate 같은 로컬 접근자 사용 | UTC 구성 요소와 로컬 구성 요소 혼용 |
| 지역 자정을 ISO로 바꿨더니 전날 | toISOString().slice(0, 10) | UTC로 직렬화한 날짜를 원래 달력 날짜로 재사용했는가 |
합성 날짜 한 개를 입력 value → 만든 payload → 실제 요청 → 저장 값 → 다시 받은 값 → 화면 순으로 비교하세요. 처음 바뀌는 지점을 고치며 모든 값에 하루를 더하거나 9시간을 일괄 보정하지 않습니다. 그런 보정은 다른 시간대·계절·입력 의미에서 새로운 오류를 만듭니다.
date 입력의 문자열과 Date 객체는 다른 계약입니다
date 입력의 표시 형식은 사용자 환경에 따라 달라도 value는 정규화된 날짜 문자열입니다. valueAsDate로 읽으면 날짜의 시작을 UTC로 표현한 Date 또는 null이므로, 로컬 getDate로 읽을 때 선택한 날과 다를 수 있습니다. 실제 값이 필요한 달력 날짜 필드라면 value를 읽고 계약에 맞게 검증해 보존하는 방식을 검토하세요.
JavaScript에서 new Date(‘2026-11-03’)처럼 날짜만 있는 형식은 UTC로 해석됩니다. 반대로 new Date(2026, 10, 3)은 실행 환경의 지역 자정이며 월 인자는 0부터 셉니다. toISOString은 UTC로 바꾸므로 두 입력 방식을 섞어 왕복시키면 원래 의미를 잃을 수 있습니다. 아래 비교는 브라우저의 날짜 선택기를 실행하는 예제가 아니라 Date 생성·직렬화 차이를 보는 코드입니다.
const dateOnly = new Date('2026-11-03');
console.log(dateOnly.toISOString()); // 2026-11-03T00:00:00.000Z
console.log(dateOnly.getDate()); // 실행 환경의 시간대에 따라 다를 수 있음
const localMidnight = new Date(2026, 10, 3); // 11월 3일 지역 자정
console.log(localMidnight.toISOString().slice(0, 10));
// 이 문자열을 원래 달력 날짜를 보존하는 방법으로 사용하지 마세요.
필수 달력 날짜를 문자열로 검증하는 함수
다음은 예제 업무 범위가 2000~2099년이고 빈 날짜를 허용하지 않는 경우의 함수입니다. 정확히 YYYY-MM-DD 형식을 받고 월별 일수·윤년을 검사합니다. 잘못된 날짜를 다음 달로 자동 보정하지 않고 공백도 조용히 지우지 않습니다. 전체 HTML 날짜 연도 범위·과거 달력·기간 계산·시간대 있는 예약을 처리하는 범용 라이브러리는 아닙니다.
function requireCalendarDate(value) {
// 예제의 업무 범위는 2000~2099년의 필수 날짜입니다.
// 일반 HTML date 입력이 허용하는 전체 연도 범위의 파서는 아닙니다.
if (typeof value !== 'string' || !/^[0-9]{4}-[0-9]{2}-[0-9]{2}$/.test(value)) {
throw new TypeError('날짜 형식은 YYYY-MM-DD여야 합니다.');
}
const year = Number(value.slice(0, 4));
const month = Number(value.slice(5, 7));
const day = Number(value.slice(8, 10));
if (year < 2000 || year > 2099 || month < 1 || month > 12) {
throw new RangeError('예제의 연도·월 범위를 벗어났습니다.');
}
const leap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
const monthDays = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
if (day < 1 || day > monthDays[month - 1]) {
throw new RangeError('존재하지 않는 날짜입니다.');
}
return value; // 시간·시간대로 바꾸지 않고 날짜 문자열을 유지합니다.
}
function makeDueDatePayload(rawValue) {
return { dueDate: requireCalendarDate(rawValue) };
}
makeDueDatePayload(‘2026-11-03’)은 dueDate 문자열을 가진 객체만 만들며 저장하지 않습니다. 선택 날짜가 없을 때 null을 허용할지, 필드 자체를 생략할지는 API별로 따로 정하세요. 현재 함수는 그런 값을 오류로 처리합니다. 서버도 같은 날짜 의미와 허용 범위를 검증하고, DB·드라이버가 이 필드를 시각으로 자동 변환하는지 확인해야 합니다.
브라우저 입력에 연결할 때의 경계
아래 HTML과 호출부는 위 함수와 함께 검토할 설명용 조각입니다. 실제 date 선택기·reportValidity·이벤트 연결은 이 글 작성 과정에서 실행하지 않았습니다. 폼이 전송되었는지와 필드가 수집되었는지는 FormData 수집 가이드의 별도 경계입니다.
<label for="due-date">마감일</label>
<input id="due-date" name="dueDate" type="date"
min="2000-01-01" max="2099-12-31" required>
// 위 함수가 같은 스크립트에 있다고 가정한 설명용 호출부입니다.
// 사용자가 확인하는 버튼의 핸들러 안에서 호출하세요.
const field = document.querySelector('#due-date');
if (field.reportValidity()) {
const payload = makeDueDatePayload(field.value);
// 여기서도 실제 요청이나 저장은 하지 않습니다.
console.log(payload); // 합성 날짜만 사용하세요.
}
브라우저의 required·min·max 검사만으로 서버 검증을 대신하지 않습니다. 실제 앱에서는 오류를 사용자에게 표시하고, payload를 만든 상태와 서버가 저장을 확인한 상태를 구분하세요. 입력의 표시 문자열을 잘라 보내거나 toISOString으로 달력 날짜를 대신하지 않습니다.
세 시간대에서 직접 실행한 비교 결과
2026년 11월 3일 Node.js v24.22.1에서 실제 Date·Intl과 위 문자열 검증 함수를 실행했습니다. TZ를 UTC·Asia/Seoul·America/Los_Angeles로 지정한 별도 프로세스 세 개에서 같은 비교 묶음 8개씩을 확인했습니다. 총 24회 묶음 실행이며 서로 다른 브라우저·기기 시험 24건이 아닙니다.
| 동일 코드 | UTC | 서울 | 로스앤젤레스 |
|---|---|---|---|
| new Date(‘2026-11-03’)의 로컬 연·월·일 | 2026-11-03 | 2026-11-03 | 2026-11-02 |
| new Date(2026, 10, 3)의 ISO 날짜 부분 | 2026-11-03 | 2026-11-02 | 2026-11-03 |
| makeDueDatePayload의 dueDate | 2026-11-03 | 2026-11-03 | 2026-11-03 |
추가로 2000·2024년 2월 29일과 월말·연도 경계를 확인했고, 2026년 2월 29일·4월 31일·월/일 범위 오류·빈 값·형식 오류·범위 밖 연도는 거절되는 것을 관찰했습니다. 같은 순간 2026-11-02T15:30:00Z를 Intl의 명시적 시간대로 표시하면 서울은 11월 3일, 로스앤젤레스는 11월 2일이었습니다. 이 경우에는 날짜 차이가 표시 정책에 따른 정상 결과입니다.
이 실행에는 HTMLInputElement·실제 날짜 선택기·브라우저 폼 검사·서버 API·DB/ORM 왕복이 포함되지 않았습니다. HTML과 호출 코드는 정적 검토이며 위 표를 valueAsDate를 실제로 읽은 관찰로 해석하지 마세요.
저장 왕복 전에 확인할 항목
- 필드가 달력 날짜인지 시각인지 API 문서에 씁니다. 미래 예약의 지역 시각과 시간대가 필요한 경우에는 이 날짜 전용 함수로 시각을 만들지 않습니다.
- 대상 브라우저에서 빈 값·윤년·범위 끝 날짜를 직접 선택하고 value·검증 메시지를 확인합니다. 이름이나 disabled 때문에 수집이 빠지는지도 따로 봅니다.
- 테스트 API·DB·드라이버를 거쳐 다시 읽었을 때 동일한 문자열인지 확인합니다. 저장 실패를 다음 화면 표시만으로 성공으로 판단하지 않습니다.
- 같은 데이터로 다른 시간대의 클라이언트에서 다시 엽니다. 달력 날짜는 그대로 보존되는지, 시각은 제품이 지정한 지역에 맞게 표시되는지 구분합니다.
저장소 접근·JSON 문제는 작은 설정 저장 가이드, HTTP Retry-After의 실제 시각 해석은 429·재시도 가이드에서 다룹니다. 날짜 필드에 임의 시각을 넣어 서로 다른 문제를 합치지 않습니다.
직접 대조한 공식 자료
2026년 11월 3일 아래 원문의 date 입력, UTC 변환, Date 형식과 표시 시간대 규칙을 직접 확인했습니다. 예제의 연도·필수 값 제한은 이 글의 별도 정책입니다.