如何在Spring Boot应用中实现Firestore Timestamp字段的写入？

方案1：使用java.util.Date类型（最简适配） #

Firestore官方SDK原生支持java.util.Date类型自动映射为Timestamp字段，你只需修改Patient实体类的dob字段类型为Date即可：

import java.util.Date;
import lombok.Data;

@Data
public class Patient {
    private String userId;
    // 其余原有字段保持不变
    private Date dob;
}

如果传入的是字符串格式的日期（如yyyy-MM-dd），可以手动转换为Date类型后赋值：

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
sdf.setTimeZone(TimeZone.getTimeZone("UTC")); // 统一使用UTC时区避免日期偏移
Date dobDate = sdf.parse(前端传入的日期字符串);
patients.setDob(dobDate);

你原有业务层的写入代码无需修改，直接写入即可生效。

方案2：使用Firestore原生Timestamp类型 #

如果需要更高的时间精度控制，可以直接使用谷歌Firestore SDK自带的com.google.cloud.Timestamp类型：

import com.google.cloud.Timestamp;
import lombok.Data;

@Data
public class Patient {
    private String userId;
    // 其余原有字段保持不变
    private Timestamp dob;
}

转换示例：

// Date转Timestamp
Timestamp dobTimestamp = Timestamp.of(转换好的Date对象);
// 毫秒时间戳转Timestamp
Timestamp dobTimestamp = Timestamp.ofTimeMicroseconds(毫秒时间戳 * 1000);
patients.setDob(dobTimestamp);

方案3：使用Java 8+ LocalDateTime类型（需自定义转换器） #

Firestore SDK默认不支持LocalDateTime/LocalDate等Java 8时间类的自动序列化，需要手动实现转换器：

1. 实现读写转换器

import com.google.cloud.Timestamp;
import org.springframework.data.convert.ReadingConverter;
import org.springframework.data.convert.WritingConverter;
import java.time.LocalDateTime;
import java.time.ZoneOffset;

// 写转换器：LocalDateTime转Firestore Timestamp
@WritingConverter
public class LocalDateTimeToTimestampConverter implements Converter<LocalDateTime, Timestamp> {
    @Override
    public Timestamp convert(LocalDateTime source) {
        return Timestamp.ofTimeSecondsAndNanos(source.toEpochSecond(ZoneOffset.UTC), source.getNano());
    }
}

// 读转换器：Firestore Timestamp转LocalDateTime
@ReadingConverter
public class TimestampToLocalDateTimeConverter implements Converter<Timestamp, LocalDateTime> {
    @Override
    public LocalDateTime convert(Timestamp source) {
        return LocalDateTime.ofEpochSecond(source.getSeconds(), source.getNanos(), ZoneOffset.UTC);
    }
}

2. 实体类字段添加转换注解

import com.google.cloud.firestore.annotation.Convert;
import java.time.LocalDateTime;
import lombok.Data;

@Data
public class Patient {
    private String userId;
    // 其余原有字段保持不变
    @Convert(converter = LocalDateTimeToTimestampConverter.class)
    private LocalDateTime dob;
}

内容的提问来源于stack exchange，提问作者vaibhav singh baghel