在Java/Kotlin/Android中基于Timestamp从Firestore取数及时间戳对比方案

一、Firestore查询特定日期的数据 #

Firestore中的Timestamp类型存储的是UTC时间（精确到微秒），要查询某一天的所有数据，需要构造该日期的起始时间戳和结束时间戳，通过范围查询过滤数据。

以查询2024年5月20日当天的数据为例，步骤如下：

1. 生成当天00:00:00 UTC的Timestamp（查询起始点）
2. 生成次日00:00:00 UTC的Timestamp（查询结束点，不包含该时间）
3. 组合whereGreaterThanOrEqualTo和whereLessThan条件执行查询

示例代码（Java） #

import com.google.firebase.firestore.FirebaseFirestore;
import com.google.firebase.firestore.Query;
import com.google.firebase.firestore.Timestamp;
import java.time.LocalDate;
import java.time.ZoneOffset;
import java.util.Date;

public class FirestoreDateQuery {
    public static void queryDataForSpecificDate(LocalDate targetDate) {
        FirebaseFirestore db = FirebaseFirestore.getInstance();
        
        // 转换为UTC时区的起始、结束Date对象
        Date startDate = Date.from(targetDate.atStartOfDay(ZoneOffset.UTC).toInstant());
        Date endDate = Date.from(targetDate.plusDays(1).atStartOfDay(ZoneOffset.UTC).toInstant());
        
        // 转为Firebase Timestamp
        Timestamp startTimestamp = Timestamp.fromDate(startDate);
        Timestamp endTimestamp = Timestamp.fromDate(endDate);
        
        // 构建并执行查询
        Query query = db.collection("your_collection")
                .whereGreaterThanOrEqualTo("timestamp_field", startTimestamp)
                .whereLessThan("timestamp_field", endTimestamp);
                
        query.get().addOnCompleteListener(task -> {
            if (task.isSuccessful()) {
                task.getResult().forEach(document -> {
                    System.out.println(document.getId() + " => " + document.getData());
                });
            } else {
                System.err.println("查询失败: " + task.getException());
            }
        });
    }
}

二、Java生成可与Firebase Timestamp对比的时间戳 #

Firebase的Timestamp类可直接与Java时间类互转，核心是保证时间的时区、精度一致性，以下是几种常用生成方式：

1. 从LocalDateTime生成UTC Timestamp #

import com.google.firebase.firestore.Timestamp;
import java.time.LocalDateTime;
import java.time.ZoneOffset;

public Timestamp generateUtcTimestamp(LocalDateTime localDateTime) {
    return Timestamp.from(localDateTime.toInstant(ZoneOffset.UTC));
}

2. 从Date对象直接转换 #

如果已有java.util.Date对象，可直接转为Firebase Timestamp：

import com.google.firebase.firestore.Timestamp;
import java.util.Date;

public Timestamp convertDateToFirebaseTimestamp(Date date) {
    return Timestamp.fromDate(date);
}

3. 用秒数+纳秒数构造 #

Firebase Timestamp支持秒数加纳秒数的构造方式（纳秒范围0-999999999）：

import com.google.firebase.firestore.Timestamp;

public Timestamp getCurrentTimestamp() {
    long seconds = System.currentTimeMillis() / 1000;
    long nanoseconds = (System.currentTimeMillis() % 1000) * 1000000;
    return new Timestamp(seconds, (int) nanoseconds);
}

关键注意事项 #

• 时区统一：Firestore存储的Timestamp为UTC时间，生成查询条件时必须使用UTC时区，避免本地时区导致的查询偏差。
• 精度兼容：Firebase Timestamp支持微秒精度，Java的Date是毫秒精度，转换时会自动补全纳秒部分，不影响对比逻辑。
• 范围边界：使用whereLessThan次日起始时间而非whereLessThanOrEqualTo当天结束时间，可避免遗漏微秒级的尾端数据。

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