Mendix DB를 BI 도구에 연결해 대시보드를 만들었더니, 조치 기한과 검출일이 시스템 화면보다 하루 빠르게 보인다는 문의가 들어왔다. 데이터 오류가 아니었다. Mendix는 날짜를 UTC로 저장하고 화면에서만 사용자 시간대로 바꿔 보여준다.
문제
시스템 화면에는 3월 5일인데 BI 대시보드에는 3월 4일
원인
한국 시간 3월 5일 0시는 UTC로 3월 4일 15시. BI 도구는 DB 값을 그대로 읽음
해결
DB를 직접 읽는 쪽에서 +9시간 보정. 날짜만 쓰는 속성은 처음부터 Localize 설정을 끄는 방법도 있음
같은 값이 두 날짜로 보이는 과정
Mendix 화면
입력2026-03-05 (한국 시간 0시)
표시2026-03-05
UTC 변환 저장
DB를 직접 읽는 도구
DB 값2026-03-04 15:00:00
날짜만 표시2026-03-04
DB를 읽는 쪽에서 보정
SQL (MySQL)
SELECT DATE(DATE_ADD(duedate, INTERVAL 9 HOUR)) AS 조치기한,
DATE(DATE_ADD(detectdate, INTERVAL 9 HOUR)) AS 검출일
FROM issue$inspectionissue;
-- 또는 CONVERT_TZ (오프셋 표기는 시간대 테이블 없이 동작)
SELECT CONVERT_TZ(duedate, '+00:00', '+09:00') AS 조치기한
FROM issue$inspectionissue;BI 도구에서 계산 컬럼으로 처리해도 되지만, 보고용 뷰나 결과 테이블을 만들 때 한 번에 보정해 두면 이후 사용하는 쪽마다 따로 신경 쓰지 않아도 된다.
속성 설정으로 막는 방법
DateTime 속성에는 Localize 설정이 있다. 끄면 시간대 변환 없이 UTC 기준으로 저장하고 표시한다. 시각이 의미 없는 날짜 필드에 맞는 설정이다.
| 필드 성격 | Localize | 예시 |
|---|---|---|
| 날짜만 의미 있음 | 끔 | 조치 기한, 검출일, 생년월일 |
| 시각이 의미 있음 | 켬 | 로그인 시각, 등록 일시, 메일 발송 시각 |
운영 중인 속성의 설정을 바꿀 때이미 저장된 값은 바뀌지 않는다. 설정을 바꾸면 과거 데이터와 새 데이터의 기준이 달라지므로, 기존 값을 일괄 보정하는 작업을 같이 계획해야 한다.
같은 원인으로 생기는 다른 문제
- SQL로 월별 집계를 하면 매월 1일 0~9시 데이터가 전월로 들어감
- "오늘 마감" 조건을 SQL로 걸면 오전 9시 전후로 결과가 달라짐
- 엑셀로 내려받은 원본 값과 화면 값이 다름
관련 글: 11편 SSO 로그 테이블로 MAU와 재방문율 구하는 SQL
점검 목록
- DB를 직접 읽는 도구, 쿼리, 동기화 SQL에 시간대 보정이 있는가
- 날짜만 쓰는 속성의 Localize 설정을 확인했는가
- 문의가 오면 화면 값과 DB 원본 값을 같이 보여줄 수 있는가
시리즈 목차 16편
- PI 담당자가 로우코드로 사내 시스템을 직접 만들고 운영한 기록
- Mendix Datagrid2 대신 HTMLSnippet과 JS로 목록 화면 만들기
- Mendix SPA에서 HTMLSnippet JS가 꼬이는 이유: 이벤트 중복과 DOM 공존
- Mendix mx.data.commit이 조용히 실패할 때
- Mendix Java heap OOM 추적기: base64 이미지 컬럼
- Mendix 커밋 롤백, 용량 문제가 아니었다: FileDocument 전환기
- Mendix 첫 접속 지연 줄이기: 워밍업과 캐시
- Mendix SAML SSO 자동 로그인과 딥링크 유지
- Mendix Studio Pro에서 안 바뀌는 스타일 main.scss로 바꾸기
- Mendix MPK 파일 열어서 마이크로플로우 구조 보기
- SSO 로그 테이블로 MAU와 재방문율 구하는 SQL
- Mendix DateTime이 BI 도구에서 하루 빠르게 보이는 이유 (현재 글)
- 대시보드 숫자가 틀렸을 때 확인하는 순서
- 보기 좋은 대시보드에서 할 일을 알려주는 대시보드로
- 여러 점검 시스템을 하나로 합치는 데이터 모델
- 데이터 비전공자에게 분석 결과 보고하기