realtime 与 $time:SystemVerilog 时间类型精度差异、$timeformat 输出与时间比较写法速查
更新时间:2026-10-06。凡是在 testbench 里量脉宽、测周期、算延迟,就绕不开「现在是什么时间」这个问题。SystemVerilog 给了两套答案:
time/$time走整数,realtime/$realtime走实数。混用的经典翻车是:时钟周期 2.5ns,用$time - last_edge算出来永远是 2 或 3,断言一会儿红一会儿绿。这一篇是 L 层速查,把四个概念、精度规则、$timeformat和比较写法一次收齐。时间单位本身的坑见 timescale 与 timeunit 陷阱,时钟生成写法见 时钟复位生成。
本文要回答的问题
time、realtime、$time、$realtime四者到底差在哪?timeunit/timeprecision如何决定$time的舍入结果?$timeformat的四个参数各控制什么?- 脉宽、周期检查里时间比较应该怎么写才不误报?
一、四个概念一张表
time 是 64 位无符号整数类型,单位是当前作用域的 timeunit;realtime 是双精度浮点,存的也是 timeunit 为单位的值但保留小数。$time 返回当前仿真时间,类型是 time,返回前会按作用域的 timeprecision 舍入;$realtime 返回同样物理时刻但不舍入,类型是 realtime。一句话:$time 是「取整后的时间」,$realtime 是「带小数的时间」。
| 概念 | 类型 | 是否舍入 | 典型用途 |
|---|---|---|---|
time 变量 | 64 位整数 | 赋值时按 precision 舍入 | 粗粒度时间戳、超时计数 |
realtime 变量 | 双精度浮点 | 不舍入 | 周期/抖动/占空比测量 |
$time | 返回 time | 按 timeprecision 舍入 | 日志打印、整数比较 |
$realtime | 返回 realtime | 不舍入 | 脉宽断言、频率计算 |
关键在「舍入」这一步:作用域声明 timeunit 1ns; timeprecision 10ps; 时,仿真器内部以 10ps 为最小刻度,$time 返回值先乘成 precision 刻度再四舍五入回 timeunit。2.45ns 时刻调 $time 得到 2,调 $realtime 得到 2.45。若模块只写 timeunit 1ns 没写 timeprecision,precision 默认跟随 timeunit,一切小数都被抹掉——这是周期测不准的头号原因。

上图说明小数在哪一环丢失:内核时间本身够精细,但 $time 与 time 变量在「舍入回 timeunit」这一步把小数抹掉了;要保住小数,全链路都得走 $realtime / realtime。
二、timeunit 与 timeprecision 的作用边界
timeunit 决定 #1 延迟多长、time 变量的刻度;timeprecision 决定仿真器的时间分辨率和 $time 的舍入粒度。规则三条:
- 编译单元里
timeunit/timeprecision声明优先于`timescale,而`timescale又优先于仿真器命令行默认值;同一编译单元混用`timescale和显式声明时容易出半精度模块,细节见 timescale 与 timeunit 陷阱。 $time的舍入公式是:先按 precision 缩放取整,再换算回 timeunit——$time在 2.45ns、precision 10ps 下得到 2,而不是 2.45。- 把
realtime赋给time变量时同样发生舍入,且是四舍五入不是截断——2.5 会变 3,别指望 C 语言那种向零取整。
跨模块传时间戳时还有个暗坑:A 模块 timeunit 1ns、B 模块 timeunit 1ps,各自打印 $time 数值差 1000 倍。团队约定一般是「日志一律带单位后缀」或「统一用 $realtime 乘 timeunit 打印物理秒」,后者配合 $timeformat 最省心。
三、$timeformat 输出格式速查
$timeformat(units, precision, suffix, min_width) 控制 %t 格式符和 $time 相关打印的外观,四个参数:
units:显示单位,0=秒、-3=毫秒、-6=微秒、-9=纳秒、-12=皮秒,取 10 的负幂指数;precision:小数点后保留几位;suffix:单位后缀字符串,习惯写" ns"(前带空格);min_width:整个时间字段最小宽度,不足补空格,对齐日志列用。
initial begin
$timeformat(-9, 2, " ns", 10);
#2.45;
$display("[%t] t0", $realtime); // 输出 " 2.45 ns t0"
$display("%.2f", $realtime); // 不受 timeformat 影响,输出 2.45
end注意 $timeformat 只影响 %t,不影响 %f/%g——用 $realtime 配 %t 才吃这套格式;直接 %f 打印得到的是 timeunit 为单位的裸数字。另一个实用搭档是 $printtimescale:调试多 IP 环境时先打印各模块实际生效的 timeunit/precision,再回头查哪个模块没声明。
四、时间比较与断言写法
量脉宽、测周期的正确姿势是全程 realtime,并带容差比较——浮点比较的纪律与 实数容差比对 完全同源:
realtime t_rise, t_fall, t_prev_rise;
realtime high_w, period;
always @(posedge clk) begin
t_prev_rise = t_rise;
t_rise = $realtime;
if (t_prev_rise > 0) begin
period = t_rise - t_prev_rise;
a_period: assert (period > 2.49 && period < 2.51)
else $error("period=%0.3f ns out of range", period);
end
end
always @(negedge clk) begin
t_fall = $realtime;
high_w = t_fall - t_rise;
a_duty: assert (high_w > 1.24 && high_w < 1.26)
else $error("high width=%0.3f ns", high_w);
end三条速查纪律:测量量一律 realtime 声明、采样一律 $realtime;比较带双边容差,容差按时钟抖动预算定,别用 ==;只在日志展示层用 $time/%t,计算层绝不让整数时间参与运算。超时看门狗这类「整数够用」的场景(比如 #(100*PERIOD) 内必须见到响应)可以用 time 计数,但一旦涉及「测出来和一个实数期望值比」,就别让 $time 碰数据。
五、常见翻车案例与排障口诀
把调试现场最常见的三种翻车归纳成口诀,便于对照自查。第一种「周期测不准」:testbench 打印的时钟周期在 2 和 3 之间跳变,期望值 2.5——病根是测量变量声明成了 time 或采样用了 $time,小数被 precision 抹掉;改 realtime 加 $realtime 即愈。第二种「两个模块时间对不上」:env 打印时间戳是 monitor 的一千倍——病根是两边 timeunit 不同(一个 1ns 一个 1ps),$time 数值各自以本地单位计;统一用 $timeformat(-9, ...) 配 %t 打印物理时间,或各自乘上 timeunit 换算。第三种「断言窗口偶发误报」:期望延迟写死 #10ns 风格的整数边界,实际路径有 ±0.2ns 的相位漂移,边界值恰好在舍入点上——按第二节的纪律把窗口改成实数双边容差。
排障顺序也有讲究:先 $printtimescale 确认相关模块的单位声明与预期一致(多 IP 集成时这一步能省半天);再确认测量链路全程没有 time 类型截断;最后才怀疑 DUT 本身的时序。反向操作——先翻波形找设计问题——十有八九会浪费一下午,因为问题根本不在波形上,在 testbench 的时间语义上。团队层面的根治办法是编码规范里写死两条:任何时间测量一律 realtime;任何时间打印一律 %t 配统一 $timeformat。规范落地后,这类问题在新代码里基本绝迹,剩下的只有存量模块的历史债,按本篇的清单逐模块清即可。
六、与仿真器选项的交互
还有一类隐蔽的精度来源是仿真器命令行。多数仿真器提供全局 -timescale 或 override 选项,强制给「没声明单位的模块」一个默认单位;一旦模块自身有声明,override 的优先级规则各家不同——有的以模块声明为准,有的命令行强制全场。多 IP 环境里只要有一个 IP 裸奔(无 timeunit 也无 `timescale),它的时间语义就由命令行决定,换仿真器或改启动脚本后行为悄悄变化。防御动作两条:回归脚本里固定 timescale 选项、变更走评审;编译期打开「裸奔模块告警」,把无单位声明的模块列成清单逐个补齐。另一个交互点是 $realtime 的返回值本身受 timeunit 影响——同样的物理时刻,timeunit 1ns 下返回 2.5、timeunit 1ps 下返回 2500.0,跨模块比较 realtime 变量前必须确认两边单位一致,否则容差比较会变成数量级误判。把「单位一致」和「带容差」并列为时间比较的两条前置检查,本篇的纪律就完整了。落地时建议把这些检查做成 testbench 基类里的公共方法——measure_period()、measure_pulse_width() 统一用 $realtime 实现并内置容差参数,业务断言只调方法不碰原始时间接口;方法集中了,单位陷阱和舍入陷阱也就只在一处需要防守。新成员上手时评审这一个文件即可,比逐条宣讲规范有效得多。
这一篇在知识体系里的位置
本篇是 chip-design/verification 目录的一篇 L 层速查,主关键词 realtime 与 $time。它向上承接 timescale 与 timeunit 陷阱(单位声明优先级)与 时钟复位生成(被测对象的产生),横向与 实数容差比对(浮点比较纪律)、clocking block 竞争(采样时刻语义)同属「时间轴上的 testbench 基本功」;下游的脉宽/抖动断言写法汇入 SVA 断言实践。
总结
realtime 与 $time 的分工就一句:测量计算走 $realtime/realtime 保住小数,日志展示才用 $time/%t 配 $timeformat;$time 按 timeprecision 四舍五入回 timeunit,没写 precision 时小数全灭;时间比较永远带双边容差、不用 ==;跨模块调试先 $printtimescale 确认各作用域单位——把整数时间挡在计算层之外,脉宽周期断言就不会无缘无故红。