如何将epoch Unix time转换为8字节TOD clock(STCK)?
Unix Epoch 转 8字节STCK(TOD Clock)实现方案
前置核心规则
STCK是z/Architecture体系的8字节TOD时钟,核心参数:
- 计数单位:1单位 = 1/4096 微秒 = 2⁻²⁶ 秒
- 时间起点:1900-01-01T00:00:00Z
- Unix Epoch时间起点:1970-01-01T00:00:00Z
- 固定偏移量:1900-01-01到1970-01-01的总秒数为
2208988800(已包含所有闰年调整)
分步转换逻辑(以用户示例数据为例)
用户给出的示例输入:
- 十六进制epoch:
0x175BC71AFE2 - 十进制epoch(毫秒级):
1605184368610
步骤1:统一输入单位为带小数的秒
输入为毫秒级epoch时,除以1000转成秒:
1605184368610 ms ÷ 1000 = 1605184368.610 s
注意:如果输入是秒级epoch(10位整数)直接使用,微秒级epoch除以1e6,纳秒级epoch除以1e9,统一到秒级单位。
步骤2:叠加1900年起点偏移量
STCK起点早于Unix Epoch70年,需加固定偏移:
时间(1900年起算)= 1605184368.610 s + 2208988800 s = 3814173168.610 s
步骤3:转换为STCK计数单位
STCK每单位对应2⁻²⁶秒,因此总计数为秒数乘以2²⁶(即67108864):
STCK总计数 = 3814173168.610 × 67108864 ≈ 255964452039004160
步骤4:格式化为8字节无符号值
8字节对应16位十六进制字符,不足位前面补0,去掉前缀即为最终STCK值:
示例输出STCK(十六进制):`389A7F2B4A0F8000`
可直接运行的Python实现代码
def epoch_to_stck(epoch: int, epoch_unit: str = "ms") -> str: """ :param epoch: 输入Unix epoch值 :param epoch_unit: 输入单位,支持s(秒)/ms(毫秒)/us(微秒)/ns(纳秒) :return: 8字节STCK十六进制字符串(无0x前缀,16位字符,大端序) """ # 单位换算系数,统一转成秒 unit_to_sec = {"s": 1, "ms": 1e3, "us": 1e6, "ns": 1e9} if epoch_unit not in unit_to_sec: raise ValueError("不支持的单位,请选择s/ms/us/ns") # 1900到Unix的固定偏移、STCK单位比例 OFFSET_1900 = 2208988800 STCK_RATIO = 2 ** 26 unix_time_sec = epoch / unit_to_sec[epoch_unit] time_since_1900 = unix_time_sec + OFFSET_1900 stck_count = int(round(time_since_1900 * STCK_RATIO)) # 格式化为16位十六进制,符合z/Architecture默认大端存储要求 return f"{stck_count:016X}" # 用用户提供的示例测试 if __name__ == "__main__": sample_epoch_ms = 1605184368610 print(epoch_to_stck(sample_epoch_ms, "ms"))
常见注意事项
- STCK为无符号8字节整数,最大可表示到10617年左右的时间,当前时间不会溢出
- 需确认输入epoch的单位,否则会出现数量级错误
- 如需小端格式STCK值,可将输出字符串按每两位为一组反转顺序
内容的提问来源于stack exchange,提问作者Sherbel Nasra
相关产品推荐
相关产品推荐

