항목값
이름POSIX-TIMESTAMP-SECONDS (규격 문서 BIND POSIX-TIMESTAMP-SECONDS)
TAG ID0x06CL
코덱 ID0x000006C0
규격 문서0x00000000/codecs/0x000006C0/ (DECLARE 대상 06C0)
섹션3 0011 (Value), 섹션 안 오프셋 C = 12
KindValue · 계열: TIME
TAG WORD0000 0110 1100 LLLL (000K KKKC CCCC LLLL)
색인 설명Unix/POSIX epoch부터의 signed 초 계수
Hugo 쪽value/time/posix-timestamp-seconds.md

필드 (규격 문서)

FIELD의 문서 안 순서가 Payload 필드 순서다(Codec 규격 문서).

순서필드(BIND)FIELD폭받는 형식(CODEC)ENUM
1seconds#2날값 4 WORD

POSIX-TIMESTAMP-SECONDS는 Unix epoch 1970-01-01T00:00:00Z부터의 signed 초 수다. POSIX의 seconds-since-the-Epoch처럼 모든 날을 정확히 86,400초로 보며 윤초를 세지 않는다.

레이아웃

  • 코드: Value 직접 코드 0x06CL. 계열 TIME.
  • 산업 데이터 교환을 위해 Arrow timestamp[s]와 같은 고정폭 signed int64 물리 타입을 쓴다.
TAG WORD          0x06C4 (0000 0110 1100 0100)  전체 5 WORD
Payload WORD 1st (bits 63..48)     Signed Seconds high 16bit
Payload WORD 2nd (bits 47..32)     Signed Seconds
Payload WORD 3rd (bits 31..16)     Signed Seconds
Payload WORD 4th (bits 15..0)      Signed Seconds low 16bit

해석과 유효성

  • Payload 4 WORD 전체를 big-endian WORD 순서의 64비트 2의 보수 signed count로 읽는다.
  • 유효 범위는 -2^63~2^63-1초다. 음수는 epoch 이전 instant다.
  • 작은 값도 항상 4 WORD를 쓴다. 최소 WORD 정수 표현으로 줄여서는 안 된다.
  • timezone, 원래의 UTC offset, 윤초 label, leap-second table은 담지 않는다.

길이

  • 전체는 TAG 1 WORD와 Payload 4 WORD를 합한 정확히 5 WORD이고 직접 길이 LLLL=0100을 쓴다. Length 확장 TAG, descriptor, padding은 없다.
  • Payload가 정확히 4 WORD가 아니면 거부한다.

예시

  • epoch는 Payload 0000 0000 0000 0000, 전체 5 WORD, LLLL=0100이다.
  • epoch 뒤 1초는 Payload 0000 0000 0000 0001이다.
  • epoch 1초 전은 Payload FFFF FFFF FFFF FFFF이다.

표준 근거

  • POSIX.1-2024 timespec은 time_t tv_sec와 long tv_nsec 멤버를 정의할 뿐, 누적 초를 signed int64로 직렬화하는 wire format은 정의하지 않는다. time_t의 구체 폭과 표현은 구현 환경에 따르며 GEUL Payload 표현과 같지 않다.
  • POSIX.1-2024 Seconds Since the Epoch는 epoch 이후 초의 달력 대응과 하루 86,400초 규칙을 정의한다.
  • Apache Arrow Columnar Format과 authoritative Schema.fbs는 timestamp를 고정 epoch부터의 64비트 signed integer로 정의하고, SECOND 단위와 윤초 비계수를 지원한다. GEUL은 이 물리 타입에 TAG와 big-endian 16비트 WORD framing만 더한다.

규격 문서 원문

규격 문서 0x00000000/codecs/0x000006C0/latest.geul을 geul show로 읽은 모습이다(16진은 대문자).

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006C000000000
BODY
#1 DECLARE 0x06C0
#2 FIELD #1 0x0004
#3 BIND #1 "POSIX-TIMESTAMP-SECONDS"
#4 BIND #2 "seconds"