SQLite-Net 中处理日期时间查询的最佳实践

在使用 SQLite-Net 进行数据库操作时，日期时间处理是一个常见但容易出错的场景。本文将通过一个实际案例，分析如何在 SQLite-Net 中正确处理日期时间查询，并比较不同实现方式的优缺点。

问题背景

开发者在尝试查询 Tokens 表时遇到了"Cannot get SQL for: Subtract"错误。表结构包含一个存储日期时间的字符串字段Time（格式为yyyyMMddHHmmss）和一个标记是否已使用的Used字段。查询目标是找出过去2小时内生成且未被使用的token。

错误分析

原始代码使用了LINQ表达式，其中包含DateTime.ParseExact和DateTime.UtcNow - TimeSpan.FromHours(2)操作。SQLite-Net无法将这些C#方法转换为SQL语句，导致"Cannot get SQL for: Subtract"错误。

解决方案比较

方案一：直接SQL查询（推荐）

string query = @"
    SELECT * 
    FROM Tokens 
    WHERE datetime(
            substr(Time, 1, 4) || '-' || 
            substr(Time, 5, 2) || '-' || 
            substr(Time, 7, 2) || ' ' || 
            substr(Time, 9, 2) || ':' || 
            substr(Time, 11, 2) || ':' || 
            substr(Time, 13, 2), 'utc'
        ) > datetime('now', 'utc', ?) 
    AND Used = 0";

List<Tokens> tokens = await db.QueryAsync<Tokens>(query, "-2 hours");

优点：

1. 完全在SQLite引擎内部执行，效率高
2. 利用了SQLite内置的日期时间函数
3. 参数化查询，防止SQL注入
4. 时区处理明确（使用UTC）

缺点：

1. SQL语句较复杂，可读性稍差
2. 需要手动处理字符串到日期时间的转换

方案二：客户端过滤（不推荐）

var allTokens = await db.Table<Tokens>().Where(x => x.Used == 0).ToListAsync();
var filteredTokens = allTokens.Where(x => 
    DateTime.ParseExact(x.Time, "yyyyMMddHHmmss", CultureInfo.InvariantCulture) >= 
    (DateTime.UtcNow - TimeSpan.FromHours(2)))
    .OrderBy(y => y.Time)
    .ToList();

缺点：

1. 需要将所有未使用的token加载到内存
2. 在客户端进行过滤，性能较差
3. 大数据量时可能导致内存问题

最佳实践建议

1. 存储格式优化：考虑将Time字段改为标准的ISO8601格式（如yyyy-MM-dd HH:mm:ss），这样可以直接使用SQLite的日期时间函数处理，无需复杂的字符串操作。

2. 使用SQLite原生函数：尽可能利用SQLite内置的日期时间函数（如datetime()、strftime()等）来处理时间比较和计算。

3. 参数化查询：始终使用参数化查询来防止SQL注入和提高性能。

4. 时区一致性：确保所有时间操作在同一时区（通常是UTC）下进行，避免时区转换带来的混乱。

5. 索引优化：如果经常需要按时间查询，考虑在Time字段上创建索引以提高查询性能。

总结

在SQLite-Net中处理日期时间查询时，理解SQLite的功能限制和特性至关重要。通过直接使用SQL查询和SQLite内置函数，可以避免LINQ转换问题并获得最佳性能。对于复杂的日期时间操作，预先设计好数据存储格式和查询策略能够显著提高开发效率和系统性能。