一、聚合函數(shù):
SQLite中支持的聚合函數(shù)在很多其他的關(guān)系型數(shù)據(jù)庫中也同樣支持,因此我們這里將只是給出每個(gè)聚集函數(shù)的簡要說明,而不在給出更多的示例了。這里還需要進(jìn)一步說明的是,對(duì)于所有聚合函數(shù)而言,distinct關(guān)鍵字可以作為函數(shù)參數(shù)字段的前置屬性,以便在進(jìn)行計(jì)算時(shí)忽略到所有重復(fù)的字段值,如count(distinct x)。
函數(shù) | 說明 |
avg(x) | 該函數(shù)返回在同一組內(nèi)參數(shù)字段的平均值。對(duì)于不能轉(zhuǎn)換為數(shù)字值的String和BLOB類型的字段值,如'HELLO',SQLite會(huì)將其視為0。avg函數(shù)的結(jié)果總是浮點(diǎn)型,唯一的例外是所有的字段值均為NULL,那樣該函數(shù)的結(jié)果也為NULL。 |
count(x|*) | count(x)函數(shù)返回在同一組內(nèi),x字段中值不等于NULL的行數(shù)。count(*)函數(shù)返回在同一組內(nèi)的數(shù)據(jù)行數(shù)。 |
group_concat(x[,y]) | 該函數(shù)返回一個(gè)字符串,該字符串將會(huì)連接所有非NULL的x值。該函數(shù)的y參數(shù)將作為每個(gè)x值之間的分隔符,如果在調(diào)用時(shí)忽略該參數(shù),在連接時(shí)將使用缺省分隔符","。再有就是各個(gè)字符串之間的連接順序是不確定的! |
max(x) | 該函數(shù)返回同一組內(nèi)的x字段的最大值,如果該字段的所有值均為NULL,該函數(shù)也返回NULL。 |
min(x) | 該函數(shù)返回同一組內(nèi)的x字段的最小值,如果該字段的所有值均為NULL,該函數(shù)也返回NULL。 |
sum(x) | 該函數(shù)返回同一組內(nèi)的x字段值的總和,如果字段值均為NULL,該函數(shù)也返回NULL。如果所有的x字段值均為整型或者NULL,該函數(shù)返回整型值,否則就返回浮點(diǎn)型數(shù)值。最后需要指出的是,如果所有的數(shù)據(jù)值均為整型,一旦結(jié)果超過上限時(shí)將會(huì)拋出"integer overflow"的異常。 |
total(x) | 該函數(shù)不屬于標(biāo)準(zhǔn)SQL,其功能和sum基本相同,只是計(jì)算結(jié)果比sum更為合理。比如當(dāng)所有字段值均為NULL時(shí),和sum不同的是,該函數(shù)返回0.0。再有就是該函數(shù)始終返回浮點(diǎn)型數(shù)值。該函數(shù)始終都不會(huì)拋出異常。 |
二、核心函數(shù):
以下函數(shù)均為SQLite缺省提供的內(nèi)置函數(shù),其聲明和描述見如下列表:
函數(shù) | 說明 |
abs(X) | 該函數(shù)返回?cái)?shù)值參數(shù)X的絕對(duì)值,如果X為NULL,則返回NULL,如果X為不能轉(zhuǎn)換成數(shù)值的字符串,則返回0,如果X值超出Integer的上限,則拋出"Integer Overflow"的異常。 |
changes() | 該函數(shù)返回最近執(zhí)行的INSERT、UPDATE和DELETE語句所影響的數(shù)據(jù)行數(shù)。我們也可以通過執(zhí)行C/C++函數(shù)sqlite3_changes()得到相同的結(jié)果。 |
coalesce(X,Y,...) | 返回函數(shù)參數(shù)中第一個(gè)非NULL的參數(shù),如果參數(shù)都是NULL,則返回NULL。該函數(shù)至少2個(gè)參數(shù)。 |
ifnull(X,Y) | 該函數(shù)等同于兩個(gè)參數(shù)的coalesce()函數(shù),即返回第一個(gè)不為NULL的函數(shù)參數(shù),如果兩個(gè)均為NULL,則返回NULL。 |
length(X) | 如果參數(shù)X為字符串,則返回字符的數(shù)量,如果為數(shù)值,則返回該參數(shù)的字符串表示形式的長度,如果為NULL,則返回NULL。 |
lower(X) | 返回函數(shù)參數(shù)X的小寫形式,缺省情況下,該函數(shù)只能應(yīng)用于ASCII字符。 |
ltrim(X[,Y]) | 如果沒有可選參數(shù)Y,該函數(shù)將移除參數(shù)X左側(cè)的所有空格符。如果有參數(shù)Y,則移除X左側(cè)的任意在Y中出現(xiàn)的字符。最后返回移除后的字符串。 |
max(X,Y,...) | 返回函數(shù)參數(shù)中的最大值,如果有任何一個(gè)參數(shù)為NULL,則返回NULL。 |
min(X,Y,...) | 返回函數(shù)參數(shù)中的最小值,如果有任何一個(gè)參數(shù)為NULL,則返回NULL。 |
nullif(X,Y) | 如果函數(shù)參數(shù)相同,返回NULL,否則返回第一個(gè)參數(shù)。 |
random() | 返回整型的偽隨機(jī)數(shù)。 |
replace(X,Y,Z) | 將字符串類型的函數(shù)參數(shù)X中所有子字符串Y替換為字符串Z,最后返回替換后的字符串,源字符串X保持不變。 |
round(X[,Y]) | 返回?cái)?shù)值參數(shù)X被四舍五入到Y(jié)刻度的值,如果參數(shù)Y不存在,缺省參數(shù)值為0! |
rtrim(X[,Y]) | 如果沒有可選參數(shù)Y,該函數(shù)將移除參數(shù)X右側(cè)的所有空格符。如果有參數(shù)Y,則移除X右側(cè)的任意在Y中出現(xiàn)的字符。最后返回移除后的字符串。 |
substr(X,Y[,Z]) | 返回函數(shù)參數(shù)X的子字符串,從第Y位開始(X中的第一個(gè)字符位置為1)截取Z長度的字符,如果忽略Z參數(shù),則取第Y個(gè)字符后面的所有字符。如果Z的值為負(fù)數(shù),則從第Y位開始,向左截取abs(Z)個(gè)字符。如果Y值為負(fù)數(shù),則從X字符串的尾部開始計(jì)數(shù)到第abs(Y)的位置開始! |
total_changes() | 該函數(shù)返回自從該連接被打開時(shí)起,INSERT、UPDATE和DELETE語句總共影響的行數(shù)。我們也可以通過C/C++接口函數(shù)sqlite3_total_changes()得到相同的結(jié)果。 |
trim(x[,y]) | 如果沒有可選參數(shù)Y,該函數(shù)將移除參數(shù)X兩側(cè)的所有空格符。如果有參數(shù)Y,則移除X兩側(cè)的任意在Y中出現(xiàn)的字符。最后返回移除后的字符串。 |
upper(X) | 返回函數(shù)參數(shù)X的大寫形式,缺省情況下,該函數(shù)只能應(yīng)用于ASCII字符。 |
typeof(X) | 返回函數(shù)參數(shù)數(shù)據(jù)類型的字符串表示形式,如"Integer、text、real、null"等。 |
三、日期和時(shí)間函數(shù):
SQLite主要支持以下四種與日期和時(shí)間相關(guān)的函數(shù),如:
1). date(timestring, modifier, modifier, ...)
2). time(timestring, modifier, modifier, ...)
3). datetime(timestring, modifier, modifier, ...)
4). strftime(format, timestring, modifier, modifier, ...)
以上所有四個(gè)函數(shù)都接受一個(gè)時(shí)間字符串作為參數(shù),其后再跟有0個(gè)或多個(gè)修改符。其中strftime()函數(shù)還接受一個(gè)格式字符串作為其第一個(gè)參數(shù)。strftime()和C運(yùn)行時(shí)庫中的同名函數(shù)完全相同。至于其他三個(gè)函數(shù),date函數(shù)的缺省格式為:"YYYY-MM-DD",time函數(shù)的缺省格式為:"HH:MM:SS",datetime函數(shù)的缺省格式為:"YYYY-MM-DD HH:MM:SS"。
1. strftime函數(shù)的格式信息:
格式 | 說明 |
%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 |
%% | % |
需要額外指出的是,其余三個(gè)時(shí)間函數(shù)均可用strftime來表示,如:
date(...) strftime('%Y-%m-%d', ...)
time(...) strftime('%H:%M:%S', ...)
datetime(...) strftime('%Y-%m-%d %H:%M:%S', ...)
2. 時(shí)間字符串的格式:
見如下列表:
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)中只是包含了時(shí)間部分,SQLite將假設(shè)日期為2000-01-01。8)表示當(dāng)前時(shí)間。
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)將只是簡單的加減指定數(shù)量的日期或時(shí)間值,如果NNN的值為負(fù)數(shù),則減,否則加。7)到9)則將時(shí)間串中的指定日期部分設(shè)置到當(dāng)前月、年或日的開始。10)則將日期前進(jìn)到下一個(gè)星期N,其中星期日為0。注:修改符的順序極為重要,SQLite將會(huì)按照從左到右的順序依次執(zhí)行修改符。
4. 示例:
--返回當(dāng)前日期。
sqlite> SELECT date('now');
2012-01-15
--返回當(dāng)前月的最后一天。
sqlite> SELECT date('now','start of month','1 month','-1 day');
2012-01-31
--返回從1970-01-01 00:00:00到當(dāng)前時(shí)間所流經(jīng)的秒數(shù)。
sqlite> SELECT strftime('%s','now');
1326641166
--返回當(dāng)前年中10月份的第一個(gè)星期二是日期。
sqlite> SELECT date('now','start of year','+9 months','weekday 2');
2012-10-02