在SQLite这类嵌入式数据库中,日期和时间的处理并不依赖独立的日期类型,而是以文本、实数或整数形式存储,再通过一组内置函数进行解析与格式化。DATE、TIME、DATETIME和STRFTIME就是其中最核心的四个函数,它们看似功能重叠,实则分工明确。理解它们的返回值差异与参数规则,是写出正确时间查询语句的前提。

四个函数的基础行为与格式差异
DATE函数的作用非常单一:它接收一个时间描述符,返回格式为“YYYY-MM-DD”的字符串。比如传入“now”,就会得到当前的日期部分。它不会携带任何时刻信息,因此在只需要按天聚合的场景里最为合适。与之相对,TIME函数只关心“HH:MM:SS”这部分,丢弃日期,适合计算两个时间点之间的间隔或者仅展示时刻。
DATETIME则是DATE与TIME的结合体,输出“YYYY-MM-DD HH:MM:SS”。当业务逻辑既要知道哪一天又要知道具体时间,且不需要自定义格式时,DATETIME是最直接的选项。STRFTIME则最为灵活,它的第一个参数是格式模板,例如'%Y-%m-%d %H:%M:%S',后面再跟时间描述符,能输出几乎任意排列组合的字符串,甚至能提取星期、年内第几天等扩展字段。
从底层看,这四个函数共享同一套时间解析引擎。它们都会先把输入转成儒略日再格式化输出。如果输入带有时区修饰符,引擎会先做偏移换算。由于SQLite没有独立的TIMESTAMP类型,这些函数本质上都是字符串处理函数,只是约定了输出模板。下面的代码展示了基础调用方式:
SELECT
DATE('now') AS only_date,
TIME('now') AS only_time,
DATETIME('now') AS full_datetime,
STRFTIME('%Y/%m/%d %H:%M', 'now') AS custom_fmt;
时间修饰符与时区处理机制
单纯传入“now”或时间字符串往往不够,实际数据常涉及时区。SQLite通过追加修饰符来解决,例如“localtime”会把UTC时间转为本地时间,“utc”则反向转换,“unixepoch”告诉函数前面的数字是UNIX时间戳而非普通字符串。这些修饰符可以串联使用,按顺序生效。忽视修饰符是时间错乱最常见的根源。
以UNIX时间戳为例,数据库里常存整数秒数。直接用DATE(字段)会得到NULL,因为函数误以为那是普通文本。必须写成DATE(字段, 'unixepoch'),若还想转本地时区,则追加'localtime'。这种链式写法体现了SQLite函数设计的简洁:所有修饰符都是字符串参数,按顺序叠加。下面的示例演示了三种转换:
-- 假设表events有ts字段存UNIX秒
SELECT
DATETIME(ts, 'unixepoch') AS utc_time,
DATETIME(ts, 'unixepoch', 'localtime') AS local_time,
STRFTIME('%Y-%m-%d', ts, 'unixepoch', 'localtime') AS local_day
FROM events
LIMIT 5;
另一个易错点在于字符串格式。SQLite默认认“YYYY-MM-DD HH:MM:SS”为合法输入,若数据写成“2024/01/02”就可能解析失败。此时可用STRFTIME先做格式对齐,或入库前统一格式。在跨时区系统中,建议统一以UTC存“now”再按展示需要转本地,避免服务器迁移引发偏差。
业务场景中的选型与性能考量
在报表统计中,按日分组是最典型需求。使用DATE(order_time)作为分组键,能自然把跨零点订单归到正确日期。若误用DATETIME,则每小时都会成为独立分组,导致聚合粒度错误。对于时长计算,TIME(diff)虽能显示,但更推荐用STRFTIME('%s', end) - STRFTIME('%s', start)得到秒差,再自行格式化,这样避免文本相减的陷阱。
日志类应用常需输出“周一至周日”标签,STRFTIME('%w')返回0至6的数字,配合CASE语句即可映射。相比在应用层用代码处理,数据库层直接算减少了数据传输量。但需注意,若在WHERE里对字段包函数,索引通常失效;此时可改为范围查询,如WHERE order_time >= DATE('now', '-1 day')来利用索引。
从执行效率看,四个函数本身开销极低,瓶颈多在字符串解析。批量处理千万级记录时,尽量在写入端固化UTC标准格式,查询端只做轻量转换。下面的例子给出每日订单数的标准写法,兼顾可读与索引友好:
SELECT
DATE(create_at, 'localtime') AS day,
COUNT(*) AS cnt
FROM orders
WHERE create_at >= DATETIME('now', '-30 days')
GROUP BY DATE(create_at, 'localtime')
ORDER BY day;
综合来看,选函数不是看哪个强,而是看输出契约。DATE管天、TIME管刻、DATETIME管完整瞬间、STRFTIME管变形。理清输入修饰符,就能在嵌入式环境里写出既准又快的查询。