일자 및 일시 API 응답 포맷 통일

[Kirade]

배경

프론트에 일자 혹은 일시 응답시 전달하는 데이터 포멧에 대한 합의가 되어있지 않은것 같습니다. 그래서 개발자의 재량에 맞춰 포맷이 일관되지 않은 형태로 관리되고 있습니다. 이런 일관되지 않은 상황을 해결하기 위해 통일된 형태를 제안하려고 합니다.

제안

일자

• %Y-%m-%d
• ex) 2025-06-13

일시

• %Y-%m-%dT%H:%M:%S%z
• ex) 2025-06-13T09:12:34+0900

앞으로 API 작성시 위의 형태로 통일하려고합니다. 관련해서 궁금한점이 있거나 더 나은 제안이 있으시면 말씀해주세요.

참고

프론트 팀 논의 쓰레드

[twins1040]

0900 -> 09:00 따옴표 추가 제안 드립니다.

지금 구성도 ISO8601 을 준수하고 있지만 RFC3339 도 만족시킬 수 있으면 좀 더 좋을 것 같습니다.
API 를 만드는 입장에서는 ISO 는 너무 포괄적이어서 ISO8601 의 실용적 서브셋인 RFC3339 를 준수하는 것이 좋을 것 같습니다

[Kirade]

현재 콜론이 추가된 형태에 대응하는 포맷 코드같은것이 존재하지 않아서 제안해주신 형태를 사용하려면 추가적인 작업이 필요해 보이네요.
전용 필드를 하나 정의하면 가능할듯합니다.

[twins1040]

RFC3339 는 web 표준이어서 별도 포맷 코드가 필요 없습니다만

# Python
from datetime import datetime, timezone, timedelta

# KST offset
kst = timezone(timedelta(hours=9))
dt = datetime(2025, 6, 13, 9, 12, 34, tzinfo=kst)
print(dt.isoformat())  # 2025-06-13T09:12:34+09:00

// RFC 3339 KST string을 Date 객체로
const kstString = "2025-06-13T09:12:34+09:00";
const dateObj = new Date(kstString);

console.log(dateObj);
// Mon Jun 13 2025 09:12:34 GMT+0900 (한국 표준시)

[Kirade]

DRF 의 시리얼라이저를 통해 format 을 지정할때 사용할 포맷 코드가 없다는 뜻이었습니다.
뒤쪽 타임존 표시할때 %Z 나 %z 를 사용하는데 둘 다 RFC3339 표준에 안맞습니다.
python3.12 에 %:z 가 추가되면 위 형태 표기가 가능해질 것 같긴 합니다.

# 콜론 없는 형태 ( +0900 )
some_datetime = serializers.DateTimeField(format="%Y-%m-%dT%H:%M:%S%z")

포맷 코드

[twins1040]

그렇군요. 3.12 이후에나 재검토 가능하겠네요. 답변 감사합니다.