zh-Hans v
en zh tw

KSUID 生成与解析

生成随机 KSUID,解析内嵌时间和随机载荷,或以指定的 20 字节内容组装 Base62 ID。

时间与随机载荷

KSUID 由 4 字节大端时间和 16 字节随机载荷组成。起始时间为 Unix 秒 1400000000,即 2014-05-13T16:53:20Z。固定 27 字符文本使用 0–9、A–Z、a–z 的 Base62 字母表;大小写敏感,超出 160 位的文本会被拒绝。

生成或复现测试数据

生成使用 crypto.getRandomValues 创建 1–1,000 个新随机载荷及选定的 UTC 秒。组装接受 16 字节十六进制载荷,便于复现测试数据。解析支持 Base62 或 40 位十六进制,输出两种表示并保留前导零字节。

排序与边界

按指定大小写敏感字母表比较时,KSUID 大致按时间排序。同一秒内按随机载荷排序,不代表生成先后。时间偏移限定为无符号 32 位。ID 不应充当认证秘密、身份凭证,也不能代替数据库唯一约束。

参考

常见问题

解析出的时间能证明记录的创建时间吗?

不能。ID 可以被组装或从其他系统分配。解析结果只代表该格式内存储的时间。

输入会上传或保存吗?

不会。工具在本地 Web Worker 中运行,不向 API 发送 ID,也不写入本地存储。复制和下载使用当前结果;编辑或取消会清除旧结果。

其他语言