如何将JavaScript Date对象转换为Protobuf Timestamp类型

Protobuf 标准的Timestamp类型结构非常明确，只包含两个固定字段：

• seconds：int64类型，存储UTC时区下从Unix纪元（1970-01-01T00:00:00Z）起算的整秒数
• nanos：int32类型，存储整秒之后不足1秒部分的纳秒偏移，合法取值范围为0~999999999

原生JavaScript的Date对象对外输出的是毫秒级Unix时间戳，只需要按精度拆分计算即可完成转换，不需要额外依赖第三方库。

无依赖原生实现 #

直接针对你已经创建的today实例，转换逻辑如下：

let today = new Date();

function convertDateToProtoTimestamp(date) {
  const timestampMs = date.getTime();
  // 按毫秒拆分秒和剩余毫秒，负数时间戳（早于1970年的日期）用Math.floor保证取整逻辑正确
  const seconds = Math.floor(timestampMs / 1000);
  // 剩余毫秒转纳秒：1毫秒 = 10^6 纳秒
  const nanos = (timestampMs % 1000) * 1000000;
  return { seconds, nanos };
}

const protoTs = convertDateToProtoTimestamp(today);

使用官方protobuf库的简化写法 #

如果你项目中已经引入了Google官方的google-protobufJS运行时，不需要自己写转换逻辑，直接调用内置的实例方法即可：

const protoTs = new proto.google.protobuf.Timestamp();
protoTs.fromDate(today);

常见踩坑点 #

• 禁止使用位运算、parseInt或者Math.round处理秒数取整：遇到早于1970年的负时间戳时，这类写法会出现秒数计算偏移，必须用Math.floor保证正负值取整逻辑一致。
• 不要省略nanos字段：只传seconds会丢失毫秒级精度，所有时间会被强制截断到整秒。
• 不要直接把毫秒值赋值给nanos：纳秒和毫秒差6个数量级，直接传毫秒会导致时间出现上千倍的偏移。

如果需要反向把Protobuf Timestamp转回JS Date，拼接时间戳即可：

const dateFromProto = new Date(protoTs.seconds * 1000 + protoTs.nanos / 1000000);

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