업무에서 달력 주차를 여러 도메인에서 계산하여 사용하고 있고, 최근 2024년 12월 30일에 계산된 달력 주차가 각 도메인마다 상이했던 문제가 발생했다.
예를 들면 A 라는 도메인에서 계산된 월 주차는 25W01 이였지만 B라는 도메인에서 계산된 주차는 24W52 였다.
왜 이런 문제가 발생하는지와 표준화 하는 방법에 대해 살펴보자.
1. 도메인마다 표준화되어 있지 않고 다양한 방식으로 계산
문제는 2024년 12월 30일을 계산하는 주차에서 문제가 발생했다.
이는 ISO 8601과 같은 표준을 따르지 않고, 다양한 계산 방식을 통해 계산을 진행했기
때문에 결과값이 다르게 노출되었다.
ISO 8601 표준은 국제적으로 가장 널리 사용되며, 연도 변경 시 주차 계산에서 발생할 수 있는 혼란을 줄일수 있다.
2. 국제 표준화 기구인 ISO 8601
국제 표준 ISO 8601 에 따르면 매주의 시작일은 월요일에서 시작해서 일요일에 끝난다.
매월의 첫 주는 4일 이상이 포함된 주를 기준으로 한다.
즉, 목요일 기준으로 계산이 진행되며, 목요일이 어느쪽에 포함되어
있는지 보면 된다.
2024년 12월 30일 또는 2024년 12월 31일의 달력을 보면 목요일이 2025년에
포함되어 있기 때문에 25W01, 즉 1주차에 해당한다.
3. 언어와 플랫폼에서 제공하는 표준 라이브러리 사용
직접 주차를 계산하기 보다, 표준 라이브러리에서 제공하는 기능을 사용하는 것이 안전하다.
3-1) Java
- java.time.LocalDate 와 WeekFields.ISO
import java.time.LocalDate;
import java.time.temporal.WeekFields;
import java.util.Locale;
LocalDate date = LocalDate.of(2024, 12, 30);
// ISO 8601 기준으로 연도 및 주차 계산
WeekFields weekFields = WeekFields.ISO;
int weekOfYear = date.get(weekFields.weekOfWeekBasedYear());
int year = date.get(weekFields.weekBasedYear());
// 결과 출력
System.out.println("ISO 8601 기준: " + year + "W" + String.format("%02d", weekOfYear));
3-2) Python
- datetime
import datetime
# 날짜 설정
date = datetime.date(2024, 12, 30)
# ISO 8601 기준으로 연도 및 주차 계산
iso_year, iso_week, _ = date.isocalendar()
# 결과 출력
print(f"ISO 8601 기준: {iso_year}W{iso_week:02}")
또는 지시자를 사용할 경우는 아래와 같다.
datetime_target.strftime("%GW%V") # 2025W01
or
datetime_target.strftime("%gW%V") # 25W01
3-3) SQL
SELECT YEARWEEK('2024-12-30', 3) AS iso_yearweek,
YEAR('2024-12-30' + INTERVAL 1-DAYOFWEEK('2024-12-30') DAY) AS iso_year,
WEEK('2024-12-30', 3) AS iso_week;
3-4) pyspark
# DataFrame 생성
df = spark.createDataFrame(data, schema)
# ISO 8601 연도 및 주차 계산
result_df = df.withColumn("iso_year", date_format("date", "g")) \
.withColumn("iso_week", date_format("date", "V"))
Referrence
https://docs.python.org/ko/3.9/library/datetime.html