Abseil Code Review · 40/79

absl::Time Format·Parse

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

#FormatTime — 단일 진입점

표준 라이브러리의 시간 포맷팅은 std::put_time, std::strftime, std::format(C++20) 셋으로 갈라져 있다. Abseil은 absl::FormatTime 하나로 통합한다.

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

3
absl::Time t = absl::Now();
4
absl::TimeZone utc = absl::UTCTimeZone();
5

6
std::string s = absl::FormatTime("%Y-%m-%dT%H:%M:%S%Ez", t, utc);
7
// "2026-05-24T16:23:45+00:00"

세 가지 형태가 있다.

호출	결과
`FormatTime(t)`	기본 — RFC3339, UTC, 나노초 포함
`FormatTime(format, t, tz)`	사용자 포맷
`FormatTime(format, t, tz, fmt_kind)`	추가 옵션(드물게 사용)

#포맷 specifier

strftime 계열을 따르되 RFC3339 친화 확장을 추가한다.

1
absl::Time t = absl::FromCivil(absl::CivilSecond(2026, 5, 24, 16, 23, 45), utc);
2

3
absl::FormatTime("%Y-%m-%d %H:%M:%S", t, utc);
4
// "2026-05-24 16:23:45"
5

6
absl::FormatTime("%E4Y-%m-%d", t, utc);
7
// "2026-05-24"  — %E4Y는 4자리 연도 보장
8

9
absl::FormatTime("%H:%M:%E*S", t, utc);
10
// "16:23:45"   — %E*S는 가변 정밀도 초(소수점 자동 트림)
11

12
absl::FormatTime("%Ez", t, utc);
13
// "+00:00"     — RFC3339 시간대 오프셋

%E 접두는 Abseil 확장이다. * 부분은 정밀도 가변, 숫자는 고정 자릿수.

Specifier	의미
`%Y`, `%m`, `%d`	연/월/일
`%H`, `%M`, `%S`	시/분/초
`%E4Y`	4자리 연도(음수도 처리)
`%E*S`	초 + 자동 소수점
`%E3S`	초 + 3자리 소수점(ms)
`%E6S`	초 + 6자리 소수점(μs)
`%Ez`	`+HH:MM` 시간대
`%E*z`	`+HHMM` 또는 `+HH:MM`(원본 유지)

#미리 정의된 포맷 문자열

자주 쓰는 포맷은 상수로 제공한다.

1
absl::FormatTime(absl::RFC3339_full, t, utc);
2
// "2026-05-24T16:23:45.123456789+00:00"
3

4
absl::FormatTime(absl::RFC3339_sec, t, utc);
5
// "2026-05-24T16:23:45+00:00"
6

7
absl::FormatTime(absl::RFC1123_full, t, utc);
8
// "Sun, 24 May 2026 16:23:45 +0000"
9

10
absl::FormatTime(absl::RFC1123_no_wday, t, utc);
11
// "24 May 2026 16:23:45 +0000"

코드 리뷰에서 직접 만든 포맷 문자열 보다 상수를 권장한다. 일관성과 검색성이 좋아진다.

#ParseTime — 반대 방향

1
absl::Time parsed;
2
std::string err;
3
if (!absl::ParseTime("%Y-%m-%d %H:%M:%S", "2026-05-24 16:23:45", utc, &parsed, &err)) {
4
    LOG(ERROR) << "parse failed: " << err;
5
}

시그니처는 출력 매개변수 두 개를 받는다.

1
bool ParseTime(absl::string_view format,
2
               absl::string_view input,
3
               absl::TimeZone tz,
4
               absl::Time* time,
5
               std::string* err);

세 번째 인자가 TimeZone이다. 포맷에 시간대 specifier(%z, %Ez)가 없을 때 이 시간대로 해석한다. 있으면 입력이 우선한다.

1
// 입력에 시간대 없음 → utc로 해석
2
absl::ParseTime("%Y-%m-%d %H:%M:%S", "2026-05-24 16:00:00", utc, &t, &err);
3

4
// 입력에 +09:00 있음 → KST로 해석 (utc 인자는 무시)
5
absl::ParseTime("%Y-%m-%dT%H:%M:%S%Ez", "2026-05-24T16:00:00+09:00", utc, &t, &err);

#흔한 파싱 함정

#1. ISO8601 ‘Z’ 표기

1
// 회피 — Z를 직접 매칭 시도
2
absl::ParseTime("%Y-%m-%dT%H:%M:%SZ", "2026-05-24T16:00:00Z", utc, &t, &err);
3
// ❌ false — Z는 specifier로 인식 안 됨
4

5
// Good — %Ez가 Z를 함께 처리
6
absl::ParseTime("%Y-%m-%dT%H:%M:%S%Ez", "2026-05-24T16:00:00Z", utc, &t, &err);

#2. 가변 정밀도 초

1
// 회피 — 고정 자릿수 specifier로 가변 입력 파싱
2
absl::ParseTime("%H:%M:%E6S", "16:00:00.123", utc, &t, &err);
3
// ❌ 실패 — 입력은 3자리, specifier는 6자리
4

5
// Good — %E*S로 가변 매칭
6
absl::ParseTime("%H:%M:%E*S", "16:00:00.123", utc, &t, &err);

#3. 빈 err 문자열

ParseTime은 실패 시에만 err에 쓴다. 호출 전 비워둘 필요는 없지만, 성공/실패 분기는 반드시 반환값으로 판단한다.

1
// 회피
2
absl::ParseTime(fmt, in, utc, &t, &err);
3
if (!err.empty()) { /* ... */ }   // ❌ 이전 호출의 잔재일 수 있음
4

5
// Good
6
if (!absl::ParseTime(fmt, in, utc, &t, &err)) { /* ... */ }

#로깅·직렬화 표준화

Abseil의 LOG(INFO) << absl::Now()는 자동으로 RFC3339_full을 사용한다. 직접 포맷팅이 필요한 곳에서도 RFC3339 상수를 쓰면 ELK·Splunk 같은 로그 수집기가 그대로 인식한다.

1
// 권장 — 로그/JSON/protobuf 직렬화
2
std::string ts = absl::FormatTime(absl::RFC3339_full, t, absl::UTCTimeZone());
3

4
// 회피 — locale 의존 strftime
5
char buf[64];
6
std::time_t tt = absl::ToTimeT(t);
7
std::strftime(buf, sizeof(buf), "%c", std::localtime(&tt));
8
// ❌ locale·timezone에 따라 결과가 흔들림

#작은 예시 — HTTP 요청 처리

1
absl::StatusOr<RequestStamp> ParseStamp(absl::string_view header) {
2
    absl::Time t;
3
    std::string err;
4
    if (!absl::ParseTime(absl::RFC1123_full, header,
5
                         absl::UTCTimeZone(), &t, &err)) {
6
        return absl::InvalidArgumentError(
7
            absl::StrCat("bad Date header: ", err));
8
    }
9

10
    if (t > absl::Now() + absl::Minutes(5)) {
11
        return absl::InvalidArgumentError("clock skew too large");
12
    }
13

14
    return RequestStamp{t};
15
}