SQLite 函数

SQLite TIME() 函数以"HH:MM:SS"格式返回时间文本。

语法

TIME(time-value, modifier, modifier, ...)

参数

time-value

必填。 指定时间值。它可以是以下之一:

时间值描述
YYYY-MM-DD日期值格式为"YYYY-MM-DD"
YYYY-MM-DD HH:MM日期值格式为"YYYY-MM-DD HH:MM"
YYYY-MM-DD HH:MM:SS日期值格式为"YYYY-MM-DD HH:MM:SS"
YYYY-MM-DD HH:MM:SS.SSS日期值格式为"YYYY-MM-DD HH:MM:SS.SSS"
YYYY-MM-DDTHH:MM日期值格式为"YYYY-MM-DDTHH:MM"，其中 T 是分隔日期和时间的文字字符
YYYY-MM-DDTHH:MM:SS日期值格式为"YYYY-MM-DDTHH:MM:SS"，其中 T 是分隔日期和时间的文字字符
YYYY-MM- DDTHH:MM:SS.SSS日期值格式为"YYYY-MM-DDTHH:MM:SS.SSS"，其中 T 是分隔日期和时间的文字字符
HH:MM格式为"HH:MM"的日期值
HH:MM:SS格式为"HH:MM:SS"的日期值
HH:MM:SS.SSS格式为"HH:MM:SS.SSS"的日期值
nownow 是用于返回当前日期。
DDDDDDDDDD儒略日期数字
modifier，modifier，...

可选。 指定修饰符。每个修饰符都是一个应用于其左侧时间值的转换。修饰符从左到右应用并且是累积的。可用的修饰符如下:

修饰符描述
[+-]NNN days日期添加/减去的天数
[+- ]NNN 小时日期添加/减去的小时数
[+-]NNN minutes添加的分钟数/减去日期
[+-]NNN.NNNN seconds添加/减去日期的秒数（和小数秒）
[+-]NNN months添加/减去日期的月数
[+-][+-]NNN years日期添加/减去的年数
start of month将日期移回到月初
start of year将日期移回年初
start of day将日期移回到一天的开始
weekday N将日期向前移动到工作日编号为 N 的下一个日期
(0=星期日、1=星期一、2=星期二、3=星期三、4=星期四、5=星期五、6=星期六)
unixepoch与 DDDDDDDDDD 格式一起使用，将日期解释为 UNIX 时间（即:自 1970-01-01 以来的秒数）
julianday与 DDDDDDDDDD 格式一起使用，强制将时间值数字解释为儒略日数字
auto与 DDDDDDDDDD 格式一起使用，将时间值解释为儒略日数字或 unix 时间戳，具体取决于其大小。
localtime将日期调整为本地时间，假设时间值以 UTC 表示
utc将日期调整为 utc，假设时间值以当地时间表示

返回值

以"HH:MM:SS"格式的文本形式返回时间值。

示例:当前time

SQLite 'now' 时间值可用于获取当前时间。

SELECT TIME('now');
Result: '17:04:32'

示例:添加/减去小时

要从时间值中添加/减去小时，可以使用 [+-]NNN hours修饰符。在下面的示例中，给定时间值添加和减去 5 小时。

SELECT TIME('08:23:19', '+5 hours');
Result: '13:23:19'

SELECT TIME('08:23:19', '-5 hours');
Result: '03:23:19'

示例:添加/减去分钟

从时间中添加/减去分钟-value，可以使用[+-]NNN minutes修饰符。在下面的示例中，从给定时间值中添加和减去 30 分钟。

SELECT TIME('08:23:19', '+30 minutes');
Result: '08:53:19'

SELECT TIME('08:23:19', '-30 minutes');
Result: '07:53:19'

示例:添加/减去秒

从时间中添加/减去秒-value，可以使用[+-]NNN seconds修饰符。在下面的示例中，给定时间值添加和减去 30 秒。

SELECT TIME('08:23:19', '+30 seconds');
Result: '08:23:49'

SELECT TIME('08:23:19', '-30 seconds');
Result: '08:22:49'