SQLite教程(四):内置函数
一、聚合函数:
sqlite中支持的聚合函数在很多其他的关系型数据库中也同样支持,因此我们这里将只是给出每个聚集函数的简要说明,而不在给出更多的示例了。这里还需要进一步说明的是,对于所有聚合函数而言,distinct关键字可以作为函数参数字段的前置属性,以便在进行计算时忽略到所有重复的字段值,如count(distinct x)。
函数 | 说明 |
avg(x) | 该函数返回在同一组内参数字段的平均值。对于不能转换为数字值的string和blob类型的字段值,如'hello',sqlite会将其视为0。avg函数的结果总是浮点型,唯一的例外是所有的字段值均为null,那样该函数的结果也为null。 |
count(x|*) | count(x)函数返回在同一组内,x字段中值不等于null的行数。count(*)函数返回在同一组内的数据行数。 |
group_concat(x[,y]) | 该函数返回一个字符串,该字符串将会连接所有非null的x值。该函数的y参数将作为每个x值之间的分隔符,如果在调用时忽略该参数,在连接时将使用缺省分隔符","。再有就是各个字符串之间的连接顺序是不确定的。 |
max(x) | 该函数返回同一组内的x字段的最大值,如果该字段的所有值均为null,该函数也返回null。 |
min(x) | 该函数返回同一组内的x字段的最小值,如果该字段的所有值均为null,该函数也返回null。 |
sum(x) | 该 函数返回同一组内的x字段值的总和,如果字段值均为null,该函数也返回null。如果所有的x字段值均为整型或者null,该函数返回整型值,否则就 返回浮点型数值。最后需要指出的是,如果所有的数据值均为整型,一旦结果超过上限时将会抛出"integer overflow"的异常。 |
total(x) | 该函数不属于标准sql,其功能和sum基本相同,只是计算结果比sum更为合理。比如当所有字段值均为null时,和sum不同的是,该函数返回0.0。再有就是该函数始终返回浮点型数值。该函数始终都不会抛出异常。 |
二、核心函数:
以下函数均为sqlite缺省提供的内置函数,其声明和描述见如下列表:
函数 | 说明 |
abs(x) | 该函数返回数值参数x的绝对值,如果x为null,则返回null,如果x为不能转换成数值的字符串,则返回0,如果x值超出integer的上限,则抛出"integer overflow"的异常。 |
changes() | 该函数返回最近执行的insert、update和delete语句所影响的数据行数。我们也可以通过执行c/c++函数sqlite3_changes()得到相同的结果。 |
coalesce(x,y,...) | 返回函数参数中第一个非null的参数,如果参数都是null,则返回null。该函数至少2个参数。 |
ifnull(x,y) | 该函数等同于两个参数的coalesce()函数,即返回第一个不为null的函数参数,如果两个均为null,则返回null。 |
length(x) | 如果参数x为字符串,则返回字符的数量,如果为数值,则返回该参数的字符串表示形式的长度,如果为null,则返回null。 |
lower(x) | 返回函数参数x的小写形式,缺省情况下,该函数只能应用于ascii字符。 |
ltrim(x[,y]) | 如果没有可选参数y,该函数将移除参数x左侧的所有空格符。如果有参数y,则移除x左侧的任意在y中出现的字符。最后返回移除后的字符串。 |
max(x,y,...) | 返回函数参数中的最大值,如果有任何一个参数为null,则返回null。 |
min(x,y,...) | 返回函数参数中的最小值,如果有任何一个参数为null,则返回null。 |
nullif(x,y) | 如果函数参数相同,返回null,否则返回第一个参数。 |
random() | 返回整型的伪随机数。 |
replace(x,y,z) | 将字符串类型的函数参数x中所有子字符串y替换为字符串z,最后返回替换后的字符串,源字符串x保持不变。 |
round(x[,y]) | 返回数值参数x被四舍五入到y刻度的值,如果参数y不存在,缺省参数值为0。 |
rtrim(x[,y]) | 如果没有可选参数y,该函数将移除参数x右侧的所有空格符。如果有参数y,则移除x右侧的任意在y中出现的字符。最后返回移除后的字符串。 |
substr(x,y[,z]) | 返回函数参数x的子字符串,从第y位开始(x中的第一个字符位置为1)截取z长度的字符,如果忽略z参数,则取第y个字符后面的所有字符。如果z的值为负数,则从第y位开始,向左截取abs(z)个字符。如果y值为负数,则从x字符串的尾部开始计数到第abs(y)的位置开始。 |
total_changes() | 该函数返回自从该连接被打开时起,insert、update和delete语句总共影响的行数。我们也可以通过c/c++接口函数sqlite3_total_changes()得到相同的结果。 |
trim(x[,y]) | 如果没有可选参数y,该函数将移除参数x两侧的所有空格符。如果有参数y,则移除x两侧的任意在y中出现的字符。最后返回移除后的字符串。 |
upper(x) | 返回函数参数x的大写形式,缺省情况下,该函数只能应用于ascii字符。 |
typeof(x) | 返回函数参数数据类型的字符串表示形式,如"integer、text、real、null"等。 |
三、日期和时间函数:
sqlite主要支持以下四种与日期和时间相关的函数,如:
1). date(timestring, modifier, modifier, ...)
2). time(timestring, modifier, modifier, ...)
3). datetime(timestring, modifier, modifier, ...)
4). strftime(format, timestring, modifier, modifier, ...)
以上所有四个函数都接受一个时间字符串作为参数,其后再跟有0个或多个修改符。其中strftime()函数还接受一个格式字符串作为其第一个参数。strftime()和c运行时库中的同名函数完全相同。至于其他三个函数,date函数的缺省格式为:"yyyy-mm-dd",time函数的缺省格式为:"hh:mm:ss",datetime函数的缺省格式为:"yyyy-mm-dd hh:mm:ss"。
1. strftime函数的格式信息:
格式 | 说明 |
%d | day of month: 00 |
%f | fractional seconds: ss.sss |
%h | hour: 00-24 |
%j | day of year: 001-366 |
%j | julian day number |
%m | month: 01-12 |
%m | minute: 00-59 |
%s | seconds since 1970-01-01 |
%s | seconds: 00-59 |
%w | day of week 0-6 with sunday==0 |
%w | week of year: 00-53 |
%y | year: 0000-9999 |
%% | % |
需要额外指出的是,其余三个时间函数均可用strftime来表示,如:
date(...) strftime('%y-%m-%d', ...)
time(...) strftime('%h:%m:%s', ...)
datetime(...) strftime('%y-%m-%d %h:%m:%s', ...)
2. 时间字符串的格式:
见如下列表:
1). yyyy-mm-dd
2). yyyy-mm-dd hh:mm
3). yyyy-mm-dd hh:mm:ss
4). yyyy-mm-dd hh:mm:ss.sss
5). hh:mm
6). hh:mm:ss
7). hh:mm:ss.sss
8). now
5)到7)中只是包含了时间部分,sqlite将假设日期为2000-01-01。8)表示当前时间。
3. 修改符:
见如下列表:
1). nnn days
2). nnn hours
3). nnn minutes
4). nnn.nnnn seconds
5). nnn months
6). nnn years
7). start of month
8). start of year
9). start of day
10).weekday n
1)到6)将只是简单的加减指定数量的日期或时间值,如果nnn的值为负数,则减,否则加。7)到9)则将时间串中的指定日期部分设置到当前月、年或日的开始。10)则将日期前进到下一个星期n,其中星期日为0。注:修改符的顺序极为重要,sqlite将会按照从左到右的顺序依次执行修改符。
4. 示例:
--返回当前日期。
sqlite> select date('now');
2012-01-15
--返回当前月的最后一天。
sqlite> select date('now','start of month','1 month','-1 day');
2012-01-31
--返回从1970-01-01 00:00:00到当前时间所流经的秒数。
sqlite> select strftime('%s','now');
1326641166
--返回当前年中10月份的第一个星期二是日期。
sqlite> select date('now','start of year','+9 months','weekday 2');
2012-10-02
推荐阅读
-
smarty内置函数foreach用法实例,smartyforeach_PHP教程
-
php基础教程 php内置函数实例教程_PHP
-
smarty内置函数{loteral}、{ldelim}和{rdelim}用法实例,smartyloteral_PHP教程
-
第四节--构造函数和析构函数 -- Classes and Objects in PHP5 [4]_PHP教程
-
smarty内置函数section的用法,smarty内置section_PHP教程
-
PHP配置文件中最常用四个ini函数_PHP教程
-
Python学习教程之常用的内置函数大全
-
Python学习教程之常用的内置函数大全
-
第四节--构造函数和析构函数 -- Classes and Objects in PHP5 [4]_PHP教程
-
PHP内置函数32位和64位平台兼容性问题_PHP教程