本文详解如何在 android 应用中使用 java 或 kotlin 构造精确的 `timestamp` 对象，并通过 firestore 的范围查询（如 >= 和
在 Firestore 中，时间通常以 Timestamp 类型存储（底层为秒+纳秒），而直接按“某一天”查询需转化为左闭右开的时间区间（即当天 00:00:00.000 到次日 00:00:00.000），而非简单等于某个时间点——因为 Timestamp 具有毫秒级精度，且用户操作时间极少恰好落在整秒边界。
✅ 正确做法：构造当日起止 Timestamp（推荐 Kotlin）
import com.google.firebase.Timestamp
import java.util.*
fun getDayRange(year: Int, month: Int, day: Int): Pair<Timestamp, Timestamp> {
val startCal = Calendar.getInstance().apply {
clear()
set(year, month, day, 0, 0, 0) // 注意：Calendar.MONTH 是 0-based（JANUARY = 0）
timeInMillis // 确保时区已应用（默认系统时区）
}
val endCal = Calendar.getInstance().apply {
clear()
set(year, month, day + 1, 0, 0, 0) // 下一日 00:00:00
}
return Timestamp(startCal.timeInMillis / 1000,
((startCal.timeInMillis % 1000).toLong() * 1_000_000)) to
Timestamp(endCal.timeInMillis / 1000,
((endCal.timeInMillis % 1000).toLong() * 1_000_000))
}
// 使用示例：查询 2023 年 1 月 16 日全天的数据
val (startTs, endTs) = getDayRange(2023, Calendar.JANUARY, 16)
FirebaseFirestore.getInstance()
.collection("logs")
.whereGreaterThanOrEqualTo("createdAt", startTs)
.whereLessThan("createdAt", endTs)
.get()
.addOnSuccessListener { snapshot ->
for (doc in snapshot) {
Log.d("Firestore", "${doc.id} => ${doc.data}")
}
}⚠️ 关键注意：不要用 Calendar.AM_PM 手动设上午/下午：Calendar.HOUR 是 12 小时制，易出错；应统一用 HOUR_OF_DAY（0–23）并配合 set() 清除毫秒。务必清除毫秒：cal.clear() 后再 set(...)，否则残留毫秒值会导致起始时间不精准。时区敏感：Calendar.getInstance() 默认使用设备本地时区。若数据按 UTC 存储，需显式设置 cal.timeZone = TimeZone.getTimeZone("UTC")。Java 8+ 更优方案（推荐长期迁移）： LocalDateTime day = LocalDateTime.of(2023, 1, 16, 0, 0); ZoneId zone = ZoneId.systemDefault(); // 或 ZoneId.of("UTC") Instant start = day.atZone(zone).toInstant(); Instant end = day.plusDays(1).atZone(zone).toInstant(); Query query = collection.whereGreaterThanOrEqualTo("createdAt", new Timestamp(start));
✅ 补充：验证 Timestamp 格式（调试用）
Firestore 控制台显示的 Timestamp(seconds=..., nanoseconds=...) 是其内部表示。你构造的 Timestamp(startCal.timeInMillis / 1000, ...) 会自动对齐该格式。例如：
val ts = Timestamp(1673807400, 863000000) // 即 2023-01-16 00:00:00.863 UTC
可通过 ts.toDate() 转为 Date 进行日志校验，但生产环境请始终使用 Timestamp 原生比较，避免 Date 时区转换误差。
✅ 总结
- ✅ 按天查询 = 构造 [startOfDay, startOfNextDay) 区间
- ✅ 使用 Calendar.clear() + set() 或 LocalDateTime + Instant 精确控制起止
- ✅ 显式处理时区，确保与 Firestore 写入逻辑一致
- ❌ 避免 == 单一 Timestamp、避免 Calendar.HOUR（12小时制）、避免忽略毫秒
掌握这一模式后，你可轻松扩展为“本周”“本月”或任意时间范围查询，真正发挥 Firestore 时间索引的高性能优势。
