POSIX-TIMESTAMP-NANOSECONDS — число signed nanosecond, отсчитанное от эпохи Unix 1970-01-01T00:00:00Z. Как и в seconds-since-the-Epoch в POSIX, каждый день считается ровно 86 400 секунд, а високосные секунды не учитываются.
Раскладка
- Код: Value
VALUE-ISSUER-2WORD(0x09DL), Issuer0x0000000DIEEE, номер Codec0x00004000. Семейство TIME. - Для обмена промышленными данными используется тот же физический тип signed int64 фиксированной ширины, что и в Parquet
TIMESTAMP(isAdjustedToUTC=true, unit=NANOS).
TAG WORD 0x09D8 (0000 1001 1101 1000) всего 9 WORD
Issuer 2 WORD 0x0000000D (IEEE)
Номер Codec 2 WORD 0x00004000
Payload WORD 1st (bits 63..48) Signed Nanoseconds high 16bit
Payload WORD 2nd (bits 47..32) Signed Nanoseconds
Payload WORD 3rd (bits 31..16) Signed Nanoseconds
Payload WORD 4th (bits 15..0) Signed Nanoseconds low 16bit
Интерпретация и действительность
- Все 4 WORD Payload читаются как 64-битный signed count в дополнительном коде в порядке big-endian WORD.
- Допустимый диапазон — от
-2^63до2^63-1ns, а диапазон instant — от1677-09-21 00:12:43.145224192Zдо2262-04-11 23:47:16.854775807Z. - Даже малые значения всегда занимают 4 WORD. Сокращать до минимального целочисленного представления WORD нельзя.
- Часовой пояс, исходное смещение UTC, метка високосной секунды и таблица leap-second не включаются.
Длина
- Общая длина — ровно 9 WORD: TAG 1 WORD, Issuer 2 WORD, номер Codec 2 WORD и Payload 4 WORD; используется прямая длина
LLLL=1000. Расширяющего TAG Length, descriptor и заполнения нет. - Если Payload не равен ровно 4 WORD, значение отклоняется.
Пример
- Epoch — Payload
0000 0000 0000 0000, всего 9 WORD,LLLL=1000. - 1 ns после epoch — Payload
0000 0000 0000 0001. - 1 ns до epoch — Payload
FFFF FFFF FFFF FFFF.
Стандартные основания
- POSIX.1-2024
timespecопределяет членыtime_t tv_secиlong tv_nsec, а также0 <= tv_nsec < 10^9. Конкретная ширина и представлениеtime_tзависят от среды реализации, а wire format накопленных nanosecond в виде signed int64, объединяющего оба члена, не определяется. - POSIX.1-2024 Seconds Since the Epoch считает день ровно 86 400 секунд.
TIMESTAMP(isAdjustedToUTC=true, unit=NANOS)в Apache Parquet Logical Types хранит nanosecond от эпохи Unix в одномint64. GEUL добавляет к этому физическому типу только TAG и framing в 16-битные big-endian WORD.