거래 시각과 타임존을 정확히 처리하는 방법

한 거래에 여러 시각이 존재한다

거래 발생 시각, API 수신 시각, 평가 완료 시각은 서로 다릅니다. 성능 지연을 측정할 때와 거래 패턴을 분석할 때 사용하는 시각도 달라야 합니다. 원래 거래 시각을 수신 시각으로 덮어쓰면 과거 거래가 현재 거래처럼 보입니다.

공개 입력 형식

GUARDIAN의 현재 공개 거래 입력 paidAt은 한국 시간 기준 14자리 문자열입니다. 예를 들어 20261007143005는 서울의 2026년 10월 7일 14시 30분 5초입니다. 내부에서 사용하는 UTC 또는 ISO 표현을 공개 입력에 그대로 넣지 말고 요청 필드를 확인하세요.

날짜 경계 예시

서울의 10월 7일 00시 30분은 UTC로 10월 6일 15시 30분입니다. 같은 거래를 UTC 날짜로 그룹화하면 서울 기준 일별 그래프와 하루 차이가 날 수 있습니다. 저장 형식과 별개로 집계 기준 시간대를 명시해야 합니다.

표시 오류 방지

빈 문자열, 존재하지 않는 날짜, 잘못된 길이를 검사한 뒤 날짜 객체로 변환합니다. 유효하지 않은 값을 화면에서 강제로 포맷하면 오류가 발생할 수 있으므로 값 없음 표시로 처리합니다. 브라우저가 해외 시간대여도 서울 기준 화면은 같은 시각을 보여 주는지 테스트하세요. 정확한 순서 비교에는 원본 시각 외에도 수신 순서와 고유 식별자가 필요할 수 있습니다.

가상 검증 사례

가상 거래의 paidAt 20261008003000은 UTC 2026-10-07T15:30:00.000Z에 해당합니다. 서울 날짜로 집계하면 10월 8일이고 UTC 날짜로 집계하면 10월 7일입니다. 존재하지 않는 날짜 20260230003000은 거절해야 합니다.

이 사례는 실측 성능이나 실제 고객 자료가 아닙니다. 제품의 적용 범위는 GUARDIAN 공개 API 계약를 기준으로 확인합니다.