如何在Kotlin中基于UTC时间戳正确获取非洲/阿尔及尔时区的昨日订单？

问题背景 #

用户位于非洲/阿尔及尔时区，所有订单日期（含下单时间）均以UTC格式存储在数据库中。现有获取用户最近两日订单（昨日、今日）的方法存在逻辑缺陷：当用户在UTC时间23:00-23:59下单时，因非洲/阿尔及尔时区比UTC快1小时，转换为用户时区后已是次日，但该订单对用户而言属于昨日订单，却被方法判定为今日订单。

原问题代码 #

存在问题的主方法 #

fun getRecentOrdersByUser(user: User): Pair<Order?, Order?> {
    val zoneId = getZoneIdFromCountry(user.address.country)

    val today = LocalDate.now(zoneId)
    val yesterday = today.minusDays(1)

    val todayOrder = getUserOrderByStatusAndDate(user, zoneId, date = today)
    val yesterdayOrder = getUserOrderByStatusAndDate(user, zoneId, date = yesterday)

    return yesterdayOrder to todayOrder
}

关联辅助方法 #

fun getUserOrderByStatusAndDate(
    user: User,
    zoneId: ZoneId,
    status: OrderStatus = OrderStatus.CONFIRMED,
    date: LocalDate = LocalDate.now(zoneId),
): Order? {
    val (startDateTime, endDateTime) = getDateTimeRangeLocal(date, zoneId)
    return orderRepository.findOrderByUserAndStatusAndOrderPlacedDate(
        user = user,
        status = status,
        startDate = startDateTime,
        endDate = endDateTime,
    )
}

fun getDateTimeRangeLocal(date: LocalDate, zoneId: ZoneId): Pair<OffsetDateTime, OffsetDateTime> {
    val startDateTime = date
        .atStartOfDay(zoneId)
        .withZoneSameInstant(ZoneOffset.UTC)
        .toOffsetDateTime()

    val endDateTime = date
        .atTime(23, 59, 59, 999_999_999)
        .atZone(zoneId)
        .withZoneSameInstant(ZoneOffset.UTC)
        .toOffsetDateTime()

    return startDateTime to endDateTime
}

仓库查询语句 #

@Query("SELECT o FROM Order o WHERE o.user = :user AND o.status = :status AND o.orderPlacedDate >= :startDate AND o.orderPlacedDate <= :endDate ORDER BY o.orderPlacedDate DESC")
fun findOrderByUserAndStatusAndOrderPlacedDate(
    @Param("user") user: User,
    @Param("status") OrderStatus,
    @Param("startDate") startDate: OffsetDateTime,
    @Param("endDate") endDate: OffsetDateTime
): Order?

问题根源 #

原逻辑直接用用户时区的LocalDate.now(zoneId)定义今日和昨日，但未考虑：计算时间范围时，应以用户时区的当前时刻为基准倒推"昨日"和"今日"的区间，而非直接取用户时区的自然日。

比如UTC时间23:30对应非洲/阿尔及尔时区次日00:30，此时用户时区的"今日"是次日，但用户在UTC23:30下的单对用户来说是"昨日"订单，却被原逻辑归到"今日"区间。

修复方案 #

核心思路：以用户时区的当前时间为锚点，计算用户视角下"今日00:00到当前时刻"为今日订单范围，"昨日00:00到今日00:00"为昨日订单范围。

修复后的主方法 #

fun getRecentOrdersByUser(user: User): Pair<Order?, Order?> {
    val zoneId = getZoneIdFromCountry(user.address.country)
    val nowInUserZone = ZonedDateTime.now(zoneId)
    
    // 用户时区的今日起始时间
    val todayStart = nowInUserZone.toLocalDate().atStartOfDay(zoneId)
    // 用户时区的昨日起始时间
    val yesterdayStart = todayStart.minusDays(1)
    
    // 昨日订单范围：yesterdayStart 到 todayStart（不包含todayStart）
    val yesterdayOrder = orderRepository.findOrderByUserAndStatusAndOrderPlacedDate(
        user = user,
        status = OrderStatus.CONFIRMED,
        startDate = yesterdayStart.withZoneSameInstant(ZoneOffset.UTC).toOffsetDateTime(),
        endDate = todayStart.minusNanos(1).withZoneSameInstant(ZoneOffset.UTC).toOffsetDateTime()
    )
    
    // 今日订单范围：todayStart 到 当前时刻（用户时区转UTC）
    val todayOrder = orderRepository.findOrderByUserAndStatusAndOrderPlacedDate(
        user = user,
        status = OrderStatus.CONFIRMED,
        startDate = todayStart.withZoneSameInstant(ZoneOffset.UTC).toOffsetDateTime(),
        endDate = nowInUserZone.withZoneSameInstant(ZoneOffset.UTC).toOffsetDateTime()
    )
    
    return yesterdayOrder to todayOrder
}

优化辅助方法（可选） #

如果保留getUserOrderByStatusAndDate方法，可修改时间范围计算逻辑以支持"当日截至当前"的区间：

fun getUserOrderByStatusAndDate(
    user: User,
    zoneId: ZoneId,
    status: OrderStatus = OrderStatus.CONFIRMED,
    date: LocalDate? = null,
    includeUpToNow: Boolean = false
): Order? {
    val targetDate = date ?: LocalDate.now(zoneId)
    val startDateTime = targetDate.atStartOfDay(zoneId)
        .withZoneSameInstant(ZoneOffset.UTC)
        .toOffsetDateTime()
    
    val endDateTime = if (includeUpToNow) {
        ZonedDateTime.now(zoneId)
            .withZoneSameInstant(ZoneOffset.UTC)
            .toOffsetDateTime()
    } else {
        targetDate.atTime(23,59,59,999_999_999)
            .atZone(zoneId)
            .withZoneSameInstant(ZoneOffset.UTC)
            .toOffsetDateTime()
    }
    
    return orderRepository.findOrderByUserAndStatusAndOrderPlacedDate(
        user = user,
        status = status,
        startDate = startDateTime,
        endDate = endDateTime,
    )
}

// 修改后的调用方式：
fun getRecentOrdersByUser(user: User): Pair<Order?, Order?> {
    val zoneId = getZoneIdFromCountry(user.address.country)
    val today = LocalDate.now(zoneId)
    val yesterday = today.minusDays(1)
    
    val todayOrder = getUserOrderByStatusAndDate(user, zoneId, date = today, includeUpToNow = true)
    val yesterdayOrder = getUserOrderByStatusAndDate(user, zoneId, date = yesterday)
    
    return yesterdayOrder to todayOrder
}

关键说明 #

1. 所有时间范围计算必须以用户时区的时刻为基准，再转换为UTC进行数据库查询，确保和用户的实际时间感知一致。
2. 避免直接使用LocalDate的自然日区间，而是基于用户当前时间动态计算昨日和今日的边界，尤其要处理跨UTC日期的时区场景。
3. 使用minusNanos(1)获取昨日区间的结束时刻，确保不会漏掉接近今日00:00的订单，同时避免包含今日订单。

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