You need to enable JavaScript to run this app. 如何将epoch Unix time转换为8字节TOD clock(STCK)?
优惠活动
大模型
产品
解决方案
定价
更多

如何将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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 05:36:04