DateTime转Unix时间戳传入FFmpeg DrawText后时间显示不准

问题背景 #

• 正在开发视频编辑应用，已创建存储每帧信息的ObservableCollection，目标视频帧率标称30帧/秒。
• 前期通过公式 VideoCreationDate + FrameNumber / 29.97 计算每帧对应的DateTime时间，使用TextBlock在预览层每帧叠加显示日期时间时，精度完全符合预期。
• 问题表现：将对应DateTime转换为Unix时间戳作为参数传入FFmpeg的DrawText滤镜后，渲染输出的视频时间出现偏差：开头几帧时间准确，随着帧序号增大，时间偏差逐步线性增大。已逐帧校验C#侧计算的Unix时间戳，确认计算结果完全正确，但FFmpeg渲染输出的时间转换结果存在累计误差。

现有实现代码 #

DateTime转Unix时间戳逻辑 #

public long ToUnixTimestamp(DateTime value)
{
    var dateTimeOffset = new DateTimeOffset(value);
    var unixDateTime = dateTimeOffset.ToUnixTimeSeconds();
    Debug.WriteLine(unixDateTime);
    return unixDateTime;
}

FFmpeg DrawText滤镜参数 #

drawtext=text=\'%{pts\:localtime\:" + ToUnixTimestamp(CurrentFrame.FrameTime) + @"\:'%#I\:%M%p'}\'

根因排查方向 #

问题属于典型的逻辑误解+参数不匹配导致的累计误差，和FFmpeg本身缺陷无关，核心排查点如下：

1. DrawText滤镜函数逻辑误解

   %{pts:localtime:<base_timestamp>}的内置计算逻辑为：最终显示时间 = 传入的基准Unix时间戳 + 当前帧在视频时间轴上的PTS偏移（单位为秒）。
   如果你是逐帧传入当前帧的Unix时间戳作为基准值，同时渲染时没有重置单帧的PTS为0，相当于每帧的计算结果都额外叠加了该帧距离视频开头的时间偏移，帧序号越靠后PTS值越大，偏差就会线性累计，完全符合你观察到的故障表现。

2. 帧率时基不匹配
   你计算帧时间时使用的是NTSC标准帧率的近似值29.97，精确值为30000/1001 ≈ 29.97002997，如果FFmpeg渲染时没有明确指定该时基，默认会按30fps整值计算每帧PTS增量（每帧间隔1/30≈0.033333秒），和你计算时用的1/29.97≈0.0333667秒存在单帧约33微秒的误差，累计到长视频上偏差会非常明显。
3. 时间戳精度丢失+时区隐患
   现有转换逻辑用ToUnixTimeSeconds()返回整秒级时间戳，直接丢失了亚秒级精度；同时没有判断DateTime的Kind属性，如果传入的是本地时间，默认转换时可能引入时区固定偏移。

可行解决方案 #

方案1（零误差优先推荐） #

完全跳过FFmpeg侧的时间计算逻辑，直接在C#侧把每帧要显示的时间字符串按要求格式化完成，作为固定文本传入drawtext参数直接输出，复用你之前在TextBlock上已经验证准确的时间计算结果，从根源上避免PTS计算、时基不匹配导致的所有偏差。
示例参数：

// formattedTimeString是C#侧提前格式化好的时间字符串，比如"02:35PM"
$"drawtext=text='{formattedTimeString}'"

方案2（保留FFmpeg侧时间计算） #

如果需要使用FFmpeg的localtime能力做动态时间渲染，按以下步骤修正逻辑：

1. 修正基准时间传值逻辑：整段视频渲染时，仅传入视频第一帧对应的Unix时间戳作为全局基准值，不要逐帧传入当前帧时间戳；如果是单帧渲染，渲染前将单帧的PTS重置为0，避免重复叠加偏移。
2. 统一时基帧率：渲染参数中明确指定帧率为30000/1001（29.97fps的精确分数表示），避免FFmpeg使用整30fps计算PTS增量。
3. 修正时间戳转换逻辑，保留亚秒精度、处理时区问题：

public double ToUnixTimestamp(DateTime value)
{
    // 统一转换为UTC时间，避免时区偏移
    if (value.Kind != DateTimeKind.Utc)
        value = value.ToUniversalTime();
    DateTimeOffset dateTimeOffset = new DateTimeOffset(value);
    // 返回带毫秒精度的Unix时间戳，单位为秒
    return dateTimeOffset.ToUnixTimeMilliseconds() / 1000.0;
}

内容的提问来源于stack exchange，提问作者Jacob