Abseil Code Review · 42/79

absl::time_zone 분석

2026년 6월 11일 · Hawk · 2분 읽기

#시간대는 분류 문제다

UTC·로컬시간·IANA 이름·POSIX TZ 환경 변수 — 동일한 개념을 표현하는 방법이 너무 많다. Abseil은 한 가지만 인정한다: IANA 이름("Asia/Seoul", "America/Los_Angeles"). 이걸 통해 DST·역사적 오프셋 변경·UTC 변환을 정확히 처리한다.

1
#include "absl/time/time.h"
2

3
absl::TimeZone seoul;
4
if (!absl::LoadTimeZone("Asia/Seoul", &seoul)) {
5
    return absl::InternalError("TZ DB missing");
6
}
7

8
absl::TimeZone utc = absl::UTCTimeZone();
9
absl::TimeZone local = absl::LocalTimeZone();   // 시스템 기본

#TimeZone의 의미론

absl::TimeZone은 값 이다. 가볍게 복사·전달 가능. 내부적으로 IANA DB의 항목 포인터만 들고 있다.

LoadTimeZone은 비싸지만(파일 로드) 캐시된다. 같은 이름을 반복해 불러도 첫 호출 이후는 빠르다.

#변환의 세 시나리오

#1. UTC Time → Civil (지역 시계)

1
absl::Time t = absl::Now();
2
absl::CivilSecond cs = absl::ToCivilSecond(t, seoul);
3
// "지금이 한국 시계로 몇 시인가"

#2. Civil + TimeZone → UTC Time

1
absl::CivilSecond cs(2026, 5, 24, 9, 0, 0);
2
absl::Time t = absl::FromCivil(cs, seoul);
3
// "한국 시각 09:00은 절대 시간으로 언제인가"

#3. Time → Time (시간대만 바꾼 표현)

absl::Time은 시간대를 모른다. UTC epoch 기준 절대값이므로 “시간대 변환”이라는 개념이 없다. 변환은 항상 표시 시점에 일어난다.

1
absl::Time t = absl::Now();
2
std::string seoul_str = absl::FormatTime(absl::RFC3339_full, t, seoul);
3
std::string la_str    = absl::FormatTime(absl::RFC3339_full, t, la);
4
// 같은 t, 다른 표시

이 점이 가장 헷갈리는데, 한 번 익히면 코드가 훨씬 깨끗해진다. 내부 저장은 항상 absl::Time(UTC epoch), 표시·파싱 시점에만 TimeZone이 등장한다.

#DST 모호성 처리

봄/가을의 DST 전환 시각은 민감하다. 한 시각이 사라지거나 두 번 나타난다.

1
absl::TimeZone la;
2
absl::LoadTimeZone("America/Los_Angeles", &la);
3

4
absl::CivilSecond skipped(2026, 3, 8, 2, 30, 0);  // DST 시작 — 02:30 없음
5
absl::TimeZone::CivilInfo info = la.At(skipped);
6

7
switch (info.kind) {
8
    case absl::TimeZone::CivilInfo::UNIQUE:
9
        // 보통 경우
10
        break;
11
    case absl::TimeZone::CivilInfo::SKIPPED:
12
        // DST 시작 — 시각이 존재하지 않음
13
        // info.trans: 전환 직후 시각
14
        // info.pre / info.post: 두 가지 해석
15
        break;
16
    case absl::TimeZone::CivilInfo::REPEATED:
17
        // DST 종료 — 시각이 두 번 일어남
18
        break;
19
}

FromCivil은 분기 없이 부르면 합리적 기본값(보통 post-transition)을 선택한다. 청구·알람처럼 정확도가 중요한 곳만 At()로 명시 처리한다.

#시스템 TimeZone

absl::LocalTimeZone()은 OS에 따라 다음을 본다.

OS	출처
Linux/macOS	`TZ` 환경 변수 → `/etc/localtime` symlink
Windows	레지스트리 + ICU

서버 코드는 명시적 TZ를 권장한다. 운영자가 머신 시간대를 바꾸면 동작이 달라지는 일을 막는다.

1
// 회피 — 호스트 의존
2
auto local = absl::LocalTimeZone();
3

4
// Good — 서비스 TZ 명시
5
absl::TimeZone svc;
6
ABSL_CHECK(absl::LoadTimeZone(absl::GetFlag(FLAGS_service_timezone), &svc));

#TZ DB 가용성

LoadTimeZone은 OS의 zoneinfo 파일(/usr/share/zoneinfo)을 읽는다. 컨테이너 베이스 이미지가 slim이면 zoneinfo가 없을 수 있다.

1
# Debian slim
2
RUN apt-get install -y tzdata
3

4
# Alpine
5
RUN apk add --no-cache tzdata

Abseil은 zoneinfo 파일이 없으면 LoadTimeZone이 false를 반환한다. 빌드에 임베드된 zoneinfo가 필요하면 absl::FixedTimeZone(offset_seconds)로 폴백한다.

1
absl::TimeZone svc;
2
if (!absl::LoadTimeZone("Asia/Seoul", &svc)) {
3
    LOG(WARNING) << "tzdata missing, using +09:00 fixed";
4
    svc = absl::FixedTimeZone(9 * 60 * 60);
5
}

FixedTimeZone은 DST·역사적 변경을 모른다. 비상용에 한정.

#작은 예시 — 사용자 별 알림 시간

1
struct User {
2
    std::string id;
3
    std::string tz_name;   // "Asia/Seoul" 등
4
    absl::CivilSecond preferred_local;  // 09:00:00 등
5
};
6

7
absl::Time NextNotification(const User& u, absl::Time now) {
8
    absl::TimeZone tz;
9
    if (!absl::LoadTimeZone(u.tz_name, &tz)) {
10
        tz = absl::UTCTimeZone();
11
    }
12

13
    absl::CivilDay today = absl::ToCivilDay(now, tz);
14
    absl::CivilSecond candidate(today, u.preferred_local.hour(),
15
                                       u.preferred_local.minute(),
16
                                       u.preferred_local.second());
17
    absl::Time t = absl::FromCivil(candidate, tz);
18

19
    if (t <= now) {
20
        // 오늘 시각이 지났으면 내일
21
        candidate = absl::CivilSecond(today + 1,
22
                                      u.preferred_local.hour(),
23
                                      u.preferred_local.minute(),
24
                                      u.preferred_local.second());
25
        t = absl::FromCivil(candidate, tz);
26
    }
27
    return t;
28
}

저장은 absl::Time 하나, 표시는 사용자 TZ. DST 전환일에도 동작이 명확하다.

#코드 리뷰 체크리스트

1
// 회피 — 시간대 가정
2
int hour = (epoch_seconds / 3600) % 24;  // 어디 시간?
3

4
// Good — TZ 명시
5
absl::Time t = absl::FromUnixSeconds(epoch_seconds);
6
int hour = absl::ToCivilHour(t, user_tz).hour();

1
// 회피 — 문자열로 TZ 표현
2
std::string tz_offset = "+0900";
3

4
// Good — IANA 이름
5
std::string tz_name = "Asia/Seoul";   // DST·역사 변경 자동 처리

1
// 회피 — TZ 로드 실패 무시
2
absl::TimeZone tz;
3
absl::LoadTimeZone(name, &tz);   // 반환값 무시
4

5
// Good
6
if (!absl::LoadTimeZone(name, &tz)) {
7
    return absl::InvalidArgumentError(absl::StrCat("unknown tz: ", name));
8
}