函數 · k8s原理與實踐

[TOC] # 函數 ## 日期時間函數日期時間函數主要用來顯示有關日期和時間的信息。 #### CURDATE **聲明** ~~~ CURDATE() ~~~ **說明** 返回當前日期，不含時間部分。 **例子** ~~~ obclient> SELECT CURDATE(); +------------+ | CURDATE() | +------------+ | 2018-05-05 | +------------+ 1 row in set (0.00 sec) ~~~ #### CURRENT\_DATE **聲明** ~~~ CURRENT_DATE() CURRENT_DATE ~~~ **說明** 同`CURDATE()`。 #### CURRENT\_TIME **聲明** ~~~ CURRENT_TIME([scale]) ~~~ **說明** 返回當前時間，不含日期部分。 `scale`有效值為 0 到 6，表示微秒部分精度，默認值為 0。 **例子** ~~~ obclient> SELECT CURRENT_TIME(6); +-----------------+ | CURRENT_TIME(6) | +-----------------+ | 11:11:45.215311 | +-----------------+ 1 row in set (0.01 sec) ~~~ #### CURRENT\_TIMESTAMP **聲明** ~~~ CURRENT_TIMESTAMP([scale]) ~~~ **說明** 返回當前日期時間，考慮時區設置。 `scale`有效值為 0 到 6，表示微秒部分精度，默認值為 0。 **例子** ~~~ obclient> SELECT CURRENT_TIMESTAMP(6); +----------------------------+ | CURRENT_TIMESTAMP(6) | +----------------------------+ | 2018-05-05 11:35:39.177764 | +----------------------------+ 1 row in set (0.01 sec) ~~~ #### CURTIME **聲明** ~~~ CURTIME() ~~~ **說明** 同`CURRENT_TIME()`。 #### DATE\_ADD **聲明** ~~~ DATE_ADD(date, INTERVAL expr unit) ~~~ **說明** 日期時間的算術計算。 * `date`表示日期時間基準，日期部分必選，時間部分可選。 * `expr`表示時間間隔，可以為負值。 * `unit`表示時間間隔單位。以下為所有時間間隔單位列表： <table data-tag="table" id="table-wfl-77i-lr2" class="table"><colgroup span="1" width="180" data-tag="col" id="col-u8o-x0m-bmd" colwidth="1*" colnum="1" colname="col1" style="width:25%" class="col"></colgroup><colgroup span="1" width="180" data-tag="col" id="col-u3b-kp9-lc7" colwidth="1*" colnum="2" colname="col2" style="width:25%" class="col"></colgroup><colgroup span="1" width="180" data-tag="col" id="col-pzo-0rt-fsg" colwidth="1*" colnum="3" colname="col3" style="width:25%" class="col"></colgroup><colgroup span="1" width="180" data-tag="col" id="col-nww-roz-hrt" colwidth="1*" colnum="4" colname="col4" style="width:25%" class="col"></colgroup><thead id="thead-bdd-1oy-lqj" class="thead"><tr id="tr-r6j-7rq-4w2"><th id="td-8pa-170-0lm">單位</th><th id="td-zut-twq-ltf">類型</th><th id="td-fr8-4w6-3fy">含義</th><th id="td-ek3-jyu-vn9">格式</th></tr></thead><tbody data-tag="tbody" id="tbody-uwu-faj-bh5" class="tbody"><tr data-tag="tr" id="tr-lp7-9q7-epv" class="tr"><td data-tag="td" id="td-43o-95p-psf" class="td"><code data-tag="code" class="code">MICROSECOND</code></td><td data-tag="td" id="td-7na-vwv-rv1" class="td">獨立</td><td data-tag="td" id="td-46j-07l-vdo" class="td">微秒</td><td data-tag="td" id="td-u0n-onl-5mp" class="td"><code data-tag="code" class="code">MICROSECONDS</code></td></tr><tr data-tag="tr" id="tr-71m-b6v-5dl" class="tr"><td data-tag="td" id="td-3d9-h6y-q4p" class="td"><code data-tag="code" class="code">SECOND</code></td><td data-tag="td" id="td-2c6-hy9-ey3" class="td">獨立</td><td data-tag="td" id="td-bq9-f0d-pa4" class="td">秒</td><td data-tag="td" id="td-jtw-j0i-hdf" class="td"><code data-tag="code" class="code">SECONDS</code></td></tr><tr data-tag="tr" id="tr-q4g-zn6-nkk" class="tr"><td data-tag="td" id="td-d83-suu-hq4" class="td"><code data-tag="code" class="code">MINUTE</code></td><td data-tag="td" id="td-7ab-64q-7iz" class="td">獨立</td><td data-tag="td" id="td-ek7-cqd-rf9" class="td">分鐘</td><td data-tag="td" id="td-w5c-5y1-6mf" class="td"><code data-tag="code" class="code">MINUTES</code></td></tr><tr data-tag="tr" id="tr-tpw-mve-hx4" class="tr"><td data-tag="td" id="td-4dk-i36-1p9" class="td"><code data-tag="code" class="code">HOUR</code></td><td data-tag="td" id="td-b4q-26j-wnj" class="td">獨立</td><td data-tag="td" id="td-ccv-vfl-y9t" class="td">小時</td><td data-tag="td" id="td-6br-spc-ir4" class="td"><code data-tag="code" class="code">HOURS</code></td></tr><tr data-tag="tr" id="tr-lem-6sc-ona" class="tr"><td data-tag="td" id="td-dmd-nig-sx6" class="td"><code data-tag="code" class="code">DAY</code></td><td data-tag="td" id="td-s6t-g0h-hnn" class="td">獨立</td><td data-tag="td" id="td-msr-63x-dm8" class="td">天</td><td data-tag="td" id="td-yyi-g76-mcn" class="td"><code data-tag="code" class="code">DAYS</code></td></tr><tr data-tag="tr" id="tr-dq8-vfr-dz1" class="tr"><td data-tag="td" id="td-dhm-kzb-dyz" class="td"><code data-tag="code" class="code">WEEK</code></td><td data-tag="td" id="td-c19-exo-py2" class="td">獨立</td><td data-tag="td" id="td-9ji-aw6-84f" class="td">周</td><td data-tag="td" id="td-l37-l0f-yk3" class="td"><code data-tag="code" class="code">WEEKS</code></td></tr><tr data-tag="tr" id="tr-6mf-cw8-pfw" class="tr"><td data-tag="td" id="td-fbi-zzu-9zb" class="td"><code data-tag="code" class="code">MONTH</code></td><td data-tag="td" id="td-fa4-tc2-1n6" class="td">獨立</td><td data-tag="td" id="td-yrn-2fa-mcm" class="td">月</td><td data-tag="td" id="td-0lu-8w4-ztc" class="td"><code data-tag="code" class="code">MONTHS</code></td></tr><tr data-tag="tr" id="tr-dbu-d4o-5sa" class="tr"><td data-tag="td" id="td-cxf-3nh-mbs" class="td"><code data-tag="code" class="code">QUARTER</code></td><td data-tag="td" id="td-2rh-2cn-1e8" class="td">獨立</td><td data-tag="td" id="td-tql-mg3-2el" class="td">季度</td><td data-tag="td" id="td-5vd-ief-3fi" class="td"><code data-tag="code" class="code">QUARTERS</code></td></tr><tr data-tag="tr" id="tr-1rs-xr5-z22" class="tr"><td data-tag="td" id="td-56h-m9u-01n" class="td"><code data-tag="code" class="code">YEAR</code></td><td data-tag="td" id="td-y6c-vp3-9eb" class="td">獨立</td><td data-tag="td" id="td-hfq-m6i-pnq" class="td">年</td><td data-tag="td" id="td-9xf-0yp-spd" class="td"><code data-tag="code" class="code">YEARS</code></td></tr><tr data-tag="tr" id="tr-621-wzs-42z" class="tr"><td data-tag="td" id="td-rly-q42-9c2" class="td"><code data-tag="code" class="code">SECOND_MICROSECOND</code></td><td data-tag="td" id="td-3gz-t2w-3m3" class="td">組合</td><td data-tag="td" id="td-3kf-23j-4fh" class="td">秒到微秒</td><td data-tag="td" id="td-ame-r0b-8uz" class="td"><code data-tag="code" class="code">'SECONDS.MICROSECONDS'</code></td></tr><tr data-tag="tr" id="tr-jco-bfo-mgt" class="tr"><td data-tag="td" id="td-x9t-156-dgn" class="td"><code data-tag="code" class="code">MINUTE_MICROSECOND</code></td><td data-tag="td" id="td-2r6-vmy-ftp" class="td">組合</td><td data-tag="td" id="td-vk6-3m9-e9h" class="td">分鐘到微秒</td><td data-tag="td" id="td-l9t-6g7-25s" class="td"><code data-tag="code" class="code">'MINUTES:SECONDS.MICROSECONDS'</code></td></tr><tr data-tag="tr" id="tr-fm0-q0e-tn8" class="tr"><td data-tag="td" id="td-gzr-9jn-zd2" class="td"><code data-tag="code" class="code">MINUTE_SECOND</code></td><td data-tag="td" id="td-wg5-kj1-zr4" class="td">組合</td><td data-tag="td" id="td-ukg-0p7-e3f" class="td">分鐘到秒</td><td data-tag="td" id="td-aq2-2ud-7kh" class="td"><code data-tag="code" class="code">'MINUTES:SECONDS'</code></td></tr><tr data-tag="tr" id="tr-1z9-1r5-zj6" class="tr"><td data-tag="td" id="td-ai5-tkj-qre" class="td"><code data-tag="code" class="code">HOUR_MICROSECOND</code></td><td data-tag="td" id="td-k2b-863-q0i" class="td">組合</td><td data-tag="td" id="td-gro-yto-rws" class="td">小時到微秒</td><td data-tag="td" id="td-fzr-ckc-9ak" class="td"><code data-tag="code" class="code">'HOURS:MINUTES:SECONDS.MICROSECONDS'</code></td></tr><tr data-tag="tr" id="tr-muw-90q-a6a" class="tr"><td data-tag="td" id="td-55i-6y2-i4s" class="td"><code data-tag="code" class="code">HOUR_SECOND</code></td><td data-tag="td" id="td-dat-cro-j3s" class="td">組合</td><td data-tag="td" id="td-6kj-v5d-ua1" class="td">小時到秒</td><td data-tag="td" id="td-fym-gj5-4m2" class="td"><code data-tag="code" class="code">'HOURS:MINUTES:SECONDS'</code></td></tr><tr data-tag="tr" id="tr-6fn-5wx-rez" class="tr"><td data-tag="td" id="td-mzx-232-mof" class="td"><code data-tag="code" class="code">HOUR_MINUTE</code></td><td data-tag="td" id="td-4fm-qyk-p7t" class="td">組合</td><td data-tag="td" id="td-nd4-d95-6qb" class="td">小時到分鐘</td><td data-tag="td" id="td-9xr-6qo-awn" class="td"><code data-tag="code" class="code">'HOURS:MINUTES'</code></td></tr><tr data-tag="tr" id="tr-8uu-2j6-54e" class="tr"><td data-tag="td" id="td-nuh-r04-2ju" class="td"><code data-tag="code" class="code">DAY_SECOND</code></td><td data-tag="td" id="td-3zl-71o-5jy" class="td">組合</td><td data-tag="td" id="td-1kl-j7t-4mf" class="td">天到秒</td><td data-tag="td" id="td-aji-mdp-66m" class="td"><code data-tag="code" class="code">'DAYS HOURS:MINUTES:SECONDS'</code></td></tr><tr data-tag="tr" id="tr-cuz-j6k-cih" class="tr"><td data-tag="td" id="td-e03-vet-hy0" class="td"><code data-tag="code" class="code">DAY_MINUTE</code></td><td data-tag="td" id="td-m8m-bou-xli" class="td">組合</td><td data-tag="td" id="td-y7v-blk-gcc" class="td">天到分鐘</td><td data-tag="td" id="td-16a-p8h-nha" class="td"><code data-tag="code" class="code">'DDAYSD HOURS:MINUTES'</code></td></tr><tr data-tag="tr" id="tr-aqi-n5o-byn" class="tr"><td data-tag="td" id="td-jhs-rbg-ayn" class="td"><code data-tag="code" class="code">DAY_HOUR</code></td><td data-tag="td" id="td-th1-tzv-dn5" class="td">組合</td><td data-tag="td" id="td-2rl-gk5-6jc" class="td">天到小時</td><td data-tag="td" id="td-zij-m52-swy" class="td"><code data-tag="code" class="code">'DAYS HOURS'</code></td></tr><tr data-tag="tr" id="tr-7u0-5gn-vtp" class="tr"><td data-tag="td" id="td-ln5-1qy-lf4" class="td"><code data-tag="code" class="code">YEAR_MONTH</code></td><td data-tag="td" id="td-9n5-wg3-al3" class="td">組合</td><td data-tag="td" id="td-1p3-d9g-s1b" class="td">年到月</td><td data-tag="td" id="td-4dm-ba1-8b1" class="td"><code data-tag="code" class="code">'YEARS-MONTHS'</code></td></tr></tbody></table> **例子** ~~~ obclient> SELECT -> DATE_ADD(NOW(), INTERVAL 5 DAY), -> DATE_ADD('2014-01-10', INTERVAL 5 MICROSECOND), -> DATE_ADD('2014-01-10', INTERVAL 5 SECOND), -> DATE_ADD('2014-01-10', INTERVAL 5 MINUTE), -> DATE_ADD('2014-01-10', INTERVAL 5 HOUR), -> DATE_ADD('2014-01-10', INTERVAL 5 DAY), -> DATE_ADD('2014-01-10', INTERVAL 5 WEEK), -> DATE_ADD('2014-01-10', INTERVAL 5 MONTH), -> DATE_ADD('2014-01-10', INTERVAL 5 QUARTER), -> DATE_ADD('2014-01-10', INTERVAL 5 YEAR), -> DATE_ADD('2014-01-10', INTERVAL '5.000005' SECOND_MICROSECOND), -> DATE_ADD('2014-01-10', INTERVAL '05:05.000005' MINUTE_MICROSECOND), -> DATE_ADD('2014-01-10', INTERVAL '05:05' MINUTE_SECOND), -> DATE_ADD('2014-01-10', INTERVAL '05:05:05.000005' HOUR_MICROSECOND), -> DATE_ADD('2014-01-10', INTERVAL '05:05:05' HOUR_SECOND), -> DATE_ADD('2014-01-10', INTERVAL '05:05' HOUR_MINUTE), -> DATE_ADD('2014-01-10', INTERVAL '01 05:05:05.000005' DAY_MICROSECOND), -> DATE_ADD('2014-01-10', INTERVAL '01 05:05:05' DAY_SECOND), -> DATE_ADD('2014-01-10', INTERVAL '01 05:05' DAY_MINUTE), -> DATE_ADD('2014-01-10', INTERVAL '01 05' DAY_HOUR), -> DATE_ADD('2014-01-10', INTERVAL '1-01' YEAR_MONTH) -> \G *************************** 1. row *************************** DATE_ADD(NOW(), INTERVAL 5 DAY): 2018-05-10 14:54:52 DATE_ADD('2014-01-10', INTERVAL 5 MICROSECOND): 2014-01-10 00:00:00.000005 DATE_ADD('2014-01-10', INTERVAL 5 SECOND): 2014-01-10 00:00:05 DATE_ADD('2014-01-10', INTERVAL 5 MINUTE): 2014-01-10 00:05:00 DATE_ADD('2014-01-10', INTERVAL 5 HOUR): 2014-01-10 05:00:00 DATE_ADD('2014-01-10', INTERVAL 5 DAY): 2014-01-15 DATE_ADD('2014-01-10', INTERVAL 5 WEEK): 2014-02-14 DATE_ADD('2014-01-10', INTERVAL 5 MONTH): 2014-06-10 DATE_ADD('2014-01-10', INTERVAL 5 QUARTER): 2015-04-10 DATE_ADD('2014-01-10', INTERVAL 5 YEAR): 2019-01-10 DATE_ADD('2014-01-10', INTERVAL '5.000005' SECOND_MICROSECOND): 2014-01-10 00:00:05.000005 DATE_ADD('2014-01-10', INTERVAL '05:05.000005' MINUTE_MICROSECOND): 2014-01-10 00:05:05.000005 DATE_ADD('2014-01-10', INTERVAL '05:05' MINUTE_SECOND): 2014-01-10 00:05:05 DATE_ADD('2014-01-10', INTERVAL '05:05:05.000005' HOUR_MICROSECOND): 2014-01-10 05:05:05.000005 DATE_ADD('2014-01-10', INTERVAL '05:05:05' HOUR_SECOND): 2014-01-10 05:05:05 DATE_ADD('2014-01-10', INTERVAL '05:05' HOUR_MINUTE): 2014-01-10 05:05:00 DATE_ADD('2014-01-10', INTERVAL '01 05:05:05.000005' DAY_MICROSECOND): 2014-01-11 05:05:05.000005 DATE_ADD('2014-01-10', INTERVAL '01 05:05:05' DAY_SECOND): 2014-01-11 05:05:05 DATE_ADD('2014-01-10', INTERVAL '01 05:05' DAY_MINUTE): 2014-01-11 05:05:00 DATE_ADD('2014-01-10', INTERVAL '01 05' DAY_HOUR): 2014-01-11 05:00:00 DATE_ADD('2014-01-10', INTERVAL '1-01' YEAR_MONTH): 2015-02-10 1 row in set (0.01 sec) ~~~ #### DATE\_FORMAT **聲明** ~~~ DATE_FORMAT(date, format) ~~~ **說明** 將日期時間以指定格式輸出。 * `date`表示日期時間。 * `format`表示輸出格式。以下為所有輸出格式列表： <table data-tag="table" id="table-9qi-eg9-itb" class="table"><colgroup span="1" width="240" data-tag="col" id="col-y7r-lza-rnc" colwidth="1*" colnum="1" colname="col1" style="width:33.33333333333333%" class="col"></colgroup><colgroup span="1" width="240" data-tag="col" id="col-r28-e9w-u9j" colwidth="1*" colnum="2" colname="col2" style="width:33.33333333333333%" class="col"></colgroup><colgroup span="1" width="240" data-tag="col" id="col-ltg-vfw-d3w" colwidth="1*" colnum="3" colname="col3" style="width:33.33333333333333%" class="col"></colgroup><thead id="thead-rrx-ci6-ymy" class="thead"><tr id="tr-ckh-s2t-yi0"><th id="td-g64-mkb-m5n">格式符</th><th id="td-mvj-ojk-1zi">含義</th><th id="td-4nq-seb-0ek">格式</th></tr></thead><tbody data-tag="tbody" id="tbody-y1l-723-ra5" class="tbody"><tr data-tag="tr" id="tr-9h9-hpc-f7d" class="tr"><td data-tag="td" id="td-shw-n5l-8u5" class="td"><code data-tag="code" class="code">%a</code></td><td data-tag="td" id="td-gc8-umf-uvm" class="td">星期的英文縮寫。</td><td data-tag="td" id="td-vfu-vcq-dva" class="td"><code data-tag="code" class="code">Sun..Sat</code></td></tr><tr data-tag="tr" id="tr-a0d-rtj-7i7" class="tr"><td data-tag="td" id="td-47i-dtl-ooz" class="td"><code data-tag="code" class="code">%b</code></td><td data-tag="td" id="td-3ma-tdl-ox6" class="td">月份的英文縮寫。</td><td data-tag="td" id="td-09b-9hw-u64" class="td"><code data-tag="code" class="code">Jan..Dec</code></td></tr><tr data-tag="tr" id="tr-1vm-uty-zb2" class="tr"><td data-tag="td" id="td-hc8-1kj-w0t" class="td"><code data-tag="code" class="code">%c</code></td><td data-tag="td" id="td-49e-w7r-q1l" class="td">月份的數字形式。</td><td data-tag="td" id="td-y05-nzv-wpt" class="td"><code data-tag="code" class="code">1..12</code></td></tr><tr data-tag="tr" id="tr-fy1-unw-e9d" class="tr"><td data-tag="td" id="td-sbz-09f-l7m" class="td"><code data-tag="code" class="code">%D</code></td><td data-tag="td" id="td-sxi-c3m-deo" class="td">日的英文縮寫。</td><td data-tag="td" id="td-cbw-q4q-fzl" class="td"><code data-tag="code" class="code">1st..31st</code></td></tr><tr data-tag="tr" id="tr-3bq-27k-ryi" class="tr"><td data-tag="td" id="td-0ll-50m-kuk" class="td"><code data-tag="code" class="code">%d</code></td><td data-tag="td" id="td-0hf-0h5-43z" class="td">日的數字形式。</td><td data-tag="td" id="td-219-iyt-gjs" class="td"><code data-tag="code" class="code">01..31</code></td></tr><tr data-tag="tr" id="tr-tas-mgp-tvc" class="tr"><td data-tag="td" id="td-wge-ks6-5g5" class="td"><code data-tag="code" class="code">%e</code></td><td data-tag="td" id="td-f6z-q9i-v8f" class="td">日的數字形式。</td><td data-tag="td" id="td-bzj-2mm-cf7" class="td"><code data-tag="code" class="code">1.. 31</code></td></tr><tr data-tag="tr" id="tr-5f4-o52-ak5" class="tr"><td data-tag="td" id="td-2fm-1wv-4mv" class="td"><code data-tag="code" class="code">%f</code></td><td data-tag="td" id="td-97z-egh-0qr" class="td">微秒。</td><td data-tag="td" id="td-nsa-2x4-abb" class="td"><code data-tag="code" class="code">000000..999999</code></td></tr><tr data-tag="tr" id="tr-qcr-val-yhr" class="tr"><td data-tag="td" id="td-6kk-jiz-xke" class="td"><code data-tag="code" class="code">%H</code></td><td data-tag="td" id="td-0ko-aql-tb6" class="td">小時。</td><td data-tag="td" id="td-bxt-h9b-nkf" class="td"><code data-tag="code" class="code">00..23</code></td></tr><tr data-tag="tr" id="tr-fmy-3fh-m8f" class="tr"><td data-tag="td" id="td-dgb-had-hqu" class="td"><code data-tag="code" class="code">%h</code></td><td data-tag="td" id="td-b9n-czz-895" class="td">小時。</td><td data-tag="td" id="td-5ir-8hj-1h3" class="td"><code data-tag="code" class="code">01..12</code></td></tr><tr data-tag="tr" id="tr-23t-gtu-a19" class="tr"><td data-tag="td" id="td-3m4-4i6-jnw" class="td"><code data-tag="code" class="code">%I</code></td><td data-tag="td" id="td-gb5-y8f-y74" class="td">小時。</td><td data-tag="td" id="td-yod-v2n-vm6" class="td"><code data-tag="code" class="code">01..12</code></td></tr><tr data-tag="tr" id="tr-v66-1wj-lin" class="tr"><td data-tag="td" id="td-uu2-3lm-zno" class="td"><code data-tag="code" class="code">%i</code></td><td data-tag="td" id="td-6x5-7i1-588" class="td">分鐘。</td><td data-tag="td" id="td-zqs-003-6x8" class="td"><code data-tag="code" class="code">00..59</code></td></tr><tr data-tag="tr" id="tr-4sx-5sr-i1c" class="tr"><td data-tag="td" id="td-bvx-7rm-bzm" class="td"><code data-tag="code" class="code">%j</code></td><td data-tag="td" id="td-kn1-op7-oab" class="td">一年中的第幾天。</td><td data-tag="td" id="td-17y-ikp-8qw" class="td"><code data-tag="code" class="code">001..366</code></td></tr><tr data-tag="tr" id="tr-ty8-fis-mhe" class="tr"><td data-tag="td" id="td-6dx-0jr-fve" class="td"><code data-tag="code" class="code">%k</code></td><td data-tag="td" id="td-q9u-67c-cb1" class="td">小時。</td><td data-tag="td" id="td-1zv-n5m-r28" class="td"><code data-tag="code" class="code">0..23</code></td></tr><tr data-tag="tr" id="tr-x0q-15i-ues" class="tr"><td data-tag="td" id="td-ea1-ccd-9qp" class="td"><code data-tag="code" class="code">%l</code></td><td data-tag="td" id="td-3rv-ubx-5bo" class="td">小時。</td><td data-tag="td" id="td-ooe-c2p-feg" class="td"><code data-tag="code" class="code">0..12</code></td></tr><tr data-tag="tr" id="tr-jsx-jhg-y80" class="tr"><td data-tag="td" id="td-fd9-v1f-xaq" class="td"><code data-tag="code" class="code">%M</code></td><td data-tag="td" id="td-6gd-n99-ild" class="td">月份的英文名稱。</td><td data-tag="td" id="td-c23-omh-79s" class="td"><code data-tag="code" class="code">January..December</code></td></tr><tr data-tag="tr" id="tr-3nc-7kn-bon" class="tr"><td data-tag="td" id="td-le6-lu9-y5w" class="td"><code data-tag="code" class="code">%m</code></td><td data-tag="td" id="td-rq4-1jk-jck" class="td">月份的數字形式。</td><td data-tag="td" id="td-nwm-owd-9at" class="td"><code data-tag="code" class="code">01..12</code></td></tr><tr data-tag="tr" id="tr-149-fdm-2d5" class="tr"><td data-tag="td" id="td-ncf-vkh-jnm" class="td"><code data-tag="code" class="code">%p</code></td><td data-tag="td" id="td-tmr-53g-f9z" class="td">上午或下午。</td><td data-tag="td" id="td-o1j-1bs-bz9" class="td"><code data-tag="code" class="code">AM/PM</code></td></tr><tr data-tag="tr" id="tr-lql-98v-u9k" class="tr"><td data-tag="td" id="td-y0c-rxd-aj4" class="td"><code data-tag="code" class="code">%r</code></td><td data-tag="td" id="td-xo7-nrq-wiq" class="td">12小時制時間。</td><td data-tag="td" id="td-94k-r17-huc" class="td"><code data-tag="code" class="code">hh:mm:ss AM/PM</code></td></tr><tr data-tag="tr" id="tr-8xv-yvl-qnu" class="tr"><td data-tag="td" id="td-0ps-lce-upz" class="td"><code data-tag="code" class="code">%S</code></td><td data-tag="td" id="td-nhr-hvu-8jl" class="td">秒。</td><td data-tag="td" id="td-p1o-69z-cmr" class="td"><code data-tag="code" class="code">00..59</code></td></tr><tr data-tag="tr" id="tr-qhz-ofo-9g1" class="tr"><td data-tag="td" id="td-3o7-prl-38f" class="td"><code data-tag="code" class="code">%s</code></td><td data-tag="td" id="td-mvz-2fi-9cx" class="td">秒。</td><td data-tag="td" id="td-7t1-v2u-t8s" class="td"><code data-tag="code" class="code">00..59</code></td></tr><tr data-tag="tr" id="tr-1pz-2xn-3k1" class="tr"><td data-tag="td" id="td-zjk-1p2-vnr" class="td"><code data-tag="code" class="code">%T</code></td><td data-tag="td" id="td-wvx-oha-fs9" class="td">24小時制時間。</td><td data-tag="td" id="td-bnw-cww-f9s" class="td"><code data-tag="code" class="code">hh:mm:ss</code></td></tr><tr data-tag="tr" id="tr-s7u-8fh-jca" class="tr"><td data-tag="td" id="td-qa8-k0w-cx9" class="td"><code data-tag="code" class="code">%U</code></td><td data-tag="td" id="td-s4s-ntd-ky8" class="td">一年中的第幾周，周日為每周第一天。</td><td data-tag="td" id="td-jnq-9jb-zur" class="td"><code data-tag="code" class="code">00..53</code></td></tr><tr data-tag="tr" id="tr-0yy-x1i-6i3" class="tr"><td data-tag="td" id="td-pjk-wwg-erg" class="td"><code data-tag="code" class="code">%u</code></td><td data-tag="td" id="td-6rb-9aj-qa8" class="td">一年中的第幾周，周一為每周第一天。</td><td data-tag="td" id="td-lj0-0a2-76c" class="td"><code data-tag="code" class="code">00..53</code></td></tr><tr data-tag="tr" id="tr-egv-67n-8j6" class="tr"><td data-tag="td" id="td-v6c-yew-pfe" class="td"><code data-tag="code" class="code">%V</code></td><td data-tag="td" id="td-7ti-emq-cvn" class="td">一年中的第幾周，周日為每周第一天(和<code data-tag="code" class="code">%X</code>同時使用)。</td><td data-tag="td" id="td-abn-e1e-6v2" class="td"><code data-tag="code" class="code">01..53</code></td></tr><tr data-tag="tr" id="tr-6ql-eyh-bzx" class="tr"><td data-tag="td" id="td-w4e-h1c-bdv" class="td"><code data-tag="code" class="code">%v</code></td><td data-tag="td" id="td-ngn-3wy-zsl" class="td">一年中的第幾周，周一為每周第一天(和<code data-tag="code" class="code">%x</code>同時使用)。</td><td data-tag="td" id="td-zvp-yvp-8ey" class="td"><code data-tag="code" class="code">01..53</code></td></tr><tr data-tag="tr" id="tr-w5c-9lo-f9k" class="tr"><td data-tag="td" id="td-qup-8kh-wpp" class="td"><code data-tag="code" class="code">%W</code></td><td data-tag="td" id="td-ain-b8j-6fi" class="td">星期的英文名稱。</td><td data-tag="td" id="td-n68-tl1-7va" class="td"><code data-tag="code" class="code">Sunday..Saturday</code></td></tr><tr data-tag="tr" id="tr-h7i-1ck-o85" class="tr"><td data-tag="td" id="td-pg8-bx4-wcl" class="td"><code data-tag="code" class="code">%w</code></td><td data-tag="td" id="td-oim-u1d-7td" class="td">一周中的第幾天。</td><td data-tag="td" id="td-jlr-7vi-cuy" class="td"><code data-tag="code" class="code">0=Sunday..6=Saturday</code></td></tr><tr data-tag="tr" id="tr-3gg-2uc-sm3" class="tr"><td data-tag="td" id="td-ah4-xwk-07y" class="td"><code data-tag="code" class="code">%X</code></td><td data-tag="td" id="td-stg-xq5-68b" class="td">一周所屬的年份，周日為每周第一天(和<code data-tag="code" class="code">%V</code>同時使用)。</td><td data-tag="td" id="td-nlf-npn-dum" class="td"></td></tr><tr data-tag="tr" id="tr-9rf-jij-pnl" class="tr"><td data-tag="td" id="td-906-yde-c69" class="td"><code data-tag="code" class="code">%x</code></td><td data-tag="td" id="td-5yl-r1n-q6q" class="td">一周所屬的年份，周一為每周第一天(和<code data-tag="code" class="code">%v</code>同時使用)。</td><td data-tag="td" id="td-s1i-dvs-0od" class="td"></td></tr><tr data-tag="tr" id="tr-23i-tta-5nv" class="tr"><td data-tag="td" id="td-g12-2dr-cin" class="td"><code data-tag="code" class="code">%Y</code></td><td data-tag="td" id="td-zrj-sf3-3je" class="td">四位年份。</td><td data-tag="td" id="td-def-cc5-okw" class="td"></td></tr><tr data-tag="tr" id="tr-8ll-5mq-fs4" class="tr"><td data-tag="td" id="td-kz2-bki-98y" class="td"><code data-tag="code" class="code">%y</code></td><td data-tag="td" id="td-g6k-8ve-g45" class="td">兩位年份。</td><td data-tag="td" id="td-xxg-lo6-dus" class="td"></td></tr><tr data-tag="tr" id="tr-t4h-kx0-fpu" class="tr"><td data-tag="td" id="td-bcz-mcv-hmk" class="td"><code data-tag="code" class="code">%%</code></td><td data-tag="td" id="td-hqg-gsv-83z" class="td">文字字符，輸出一個<code data-tag="code" class="code">%</code>。</td><td data-tag="td" id="td-2qj-8qa-rfn" class="td"></td></tr></tbody></table> **例子** ~~~ obclient> SELECT -> DATE_FORMAT('2014-01-01', '%Y-%M-%d'), -> DATE_FORMAT('2014-01-01', '%X-%V'), -> DATE_FORMAT('2014-01-01', '%U') -> \G *************************** 1. row *************************** DATE_FORMAT('2014-01-01', '%Y-%M-%d'): 2014-January-01 DATE_FORMAT('2014-01-01', '%X-%V'): 2013-52 DATE_FORMAT('2014-01-01', '%U'): 00 1 row in set (0.01 sec) ~~~ #### DATE\_SUB **聲明** ~~~ DATE_SUB(date, INTERVAL expr unit) ~~~ **說明** 日期時間的算術計算。請參考`DATE_ADD()`。 #### DATEDIFF **聲明** ~~~ DATEDIFF(date1, date2) ~~~ **說明** 返回`date1`和`date2`之間的天數。計算中只用到參數的日期部分，忽略時間部分。 **例子** ~~~ obclient> SELECT DATEDIFF('2015-06-19','1994-12-17'); +-------------------------------------+ | DATEDIFF('2015-06-19','1994-12-17') | +-------------------------------------+ | 7489 | +-------------------------------------+ 1 row in set (0.01 sec) ~~~ #### EXTRACT **聲明** ~~~ EXTRACT(unit FROM date) ~~~ **說明** 以整數類型返回`date`的指定部分值。如果指定多個部分，則將所有值按順序拼接。 `unit`請參考`DATE_ADD()`。當`unit`為`WEEK`時，請參考`DATE_FORMAT()`的`%U`說明。 **例子** ~~~ SELECT EXTRACT(WEEK FROM '2013-01-01'), EXTRACT(WEEK FROM '2013-01-06'), EXTRACT(YEAR_MONTH FROM '2012-03-09'), EXTRACT(DAY FROM NOW())\G; * 1. row * EXTRACT(WEEK FROM '2013-01-01'): 0 EXTRACT(WEEK FROM '2013-01-06'): 1 EXTRACT(YEAR_MONTH FROM '2012-03-09'): 201203 EXTRACT(DAY FROM NOW()): 18 1 row in set (0.00 sec) ~~~ #### FROM\_DAYS **聲明** ~~~ FROM_DAYS(N) ~~~ **說明** 返回指定天數`N`對應的`DATE`值。天數指距離`0000-01-01`的天數。 **例子** ~~~ obclient> SELECT FROM_DAYS(736271), FROM_DAYS(700000); +-------------------+-------------------+ | FROM_DAYS(736271) | FROM_DAYS(700000) | +-------------------+-------------------+ | 2015-11-04 | 1916-07-15 | +-------------------+-------------------+ 1 row in set (0.00 sec) ~~~ #### FROM\_UNIXTIME **聲明** ~~~ FROM_UNIXTIME(unix_timestamp) FROM_UNIXTIME(unix_timestamp, format) ~~~ **說明** * 不指定`format`參數時，返回`DATETIME`類型值，不考慮時區。 * 指定`format`參數時，返回指定格式的日期時間字符串。 `unix_timestamp`指 UNIX 時間戳，即距離`1970-01-01 00:00:00.000000`的微秒數。 `format`支持的格式已在`DATE_FORMAT()`**說****明**中列出。 **例子** ~~~ obclient> SELECT FROM_UNIXTIME(UNIX_TIMESTAMP(), '%Y %D %M %h:%i:%s %x'); +---------------------------------------------------------+ | FROM_UNIXTIME(UNIX_TIMESTAMP(), '%Y %D %M %h:%i:%s %x') | +---------------------------------------------------------+ | 2018 5th May 08:41:26 2018 | +---------------------------------------------------------+ 1 row in set (0.01 sec) ~~~ #### MONTH **聲明** ~~~ MONTH(date) ~~~ **說明** 返回`date`的月份信息。 **例子** ~~~ obclient> SELECT MONTH('2008-02-03'); +---------------------+ | MONTH('2008-02-03') | +---------------------+ | 2 | +---------------------+ 1 row in set (0.01 sec) ~~~ #### NOW **聲明** ~~~ NOW([scale]) ~~~ **說明** 同`CURRENT_TIMESTAMP()`。 #### PERIOD\_DIFF **聲明** ~~~ PERIOD_DIFF(p1, p2) ~~~ **說明** 以月份位單位返回兩個日期之間的間隔。日期只能包含年月信息，格式只能為`YYYYMM`或`YYMM`。 **例子** ~~~ obclient> SELECT PERIOD_DIFF(200802, 200703); +----------------------------+ | PERIOD_DIFF(200802,200703) | +----------------------------+ | 11 | +----------------------------+ 1 row in set (0.01 sec) ~~~ #### STR\_TO\_DATE **聲明** ~~~ STR_TO_DATE(str, format) ~~~ **說明** 使用`format`將`str`轉換為`DATETIME`值、`DATE`值、或`TIME`值。返回值類型取決于`format`包含日期時間的哪些部分。 `format`支持的格式已在`DATE_FORMAT()`**說****明**中列出。 **例子** ~~~ obclient> SELECT STR_TO_DATE('2014-Jan-1st 5:5:5 pm', '%Y-%b-%D %r'); +-----------------------------------------------------+ | STR_TO_DATE('2014-Jan-1st 5:5:5 pm', '%Y-%b-%D %r') | +-----------------------------------------------------+ | 2014-01-01 05:05:05 | +-----------------------------------------------------+ 1 row in set (0.01 sec) ~~~ #### TIME **聲明** ~~~ TIME(datetime ~~~ **說明** 以`TIME`類型返回`datetime`的時間信息。 **例子** ~~~ obclient> SELECT TIME('2003-12-31 01:02:03'); +-----------------------------+ | TIME('2003-12-31 01:02:03') | +-----------------------------+ | 01:02:03.000000 | +-----------------------------+ 1 row in set (0.01 sec) ~~~ #### TIME\_TO\_USEC **聲明** ~~~ TIME_TO_USEC(date) ~~~ **說明** 將`date`值轉換為距離`1970-01-01 00:00:00.000000`的微秒數，考慮時區信息。 `date`可以表示日期，也可以表示日期時間。 **例子** ~~~ obclient> SELECT TIME_TO_USEC('2014-03-25'), TIME_TO_USEC(NOW()); +----------------------------+---------------------+ | TIME_TO_USEC('2014-03-25') | TIME_TO_USEC(NOW()) | +----------------------------+---------------------+ | 1395676800000000 | 1525528100000000 | +----------------------------+---------------------+ 1 row in set (0.01 sec) ~~~ #### TIMEDIFF **聲明** ~~~ TIMEDIFF(date1, date2) ~~~ **說明** 以`TIME`類型返回兩個日期時間的時間間隔。 **例子** ~~~ obclient> SELECT -> TIMEDIFF('2015-06-06 12:12:12', '2014-06-05 11:11:11'), -> TIMEDIFF('2015-06-06 12:12:12', '2015-06-05 11:11:11') -> \G *************************** 1. row *************************** TIMEDIFF('2015-06-06 12:12:12', '2014-06-05 11:11:11'): 838:59:59 TIMEDIFF('2015-06-06 12:12:12', '2015-06-05 11:11:11'): 25:01:01 1 row in set (0.00 sec) ~~~ #### TIMESTAMPDIFF **聲明** ~~~ TIMESTAMPDIFF(unit, date1, date2) ~~~ **說明** 以`unit`為單位返回兩個日期時間的間隔。`unit`只能為`DATE_ADD()`中的獨立單位。 **例子** ~~~ obclient> SELECT -> TIMESTAMPDIFF(SECOND, NOW(), '2011-01-01 11:11:11'), -> TIMESTAMPDIFF(DAY, '2011-01-01 11:11:11', NOW()) -> \G *************************** 1. row *************************** TIMESTAMPDIFF(SECOND, NOW(), '2011-01-01 11:11:11'): -231677498 TIMESTAMPDIFF(DAY, '2011-01-01 11:11:11', NOW()): 2681 1 row in set (0.00 sec) ~~~ #### TIMESTAMPADD **聲明** ~~~ TIMESTAMPADD(unit, interval_expr, date) ~~~ **說明** 日期時間的算術計算。同`DATE_ADD()`，但`unit`只能為獨立單位。 **例子** ~~~ obclient> SELECT -> TIMESTAMPADD(DAY, -5, '2010-01-01 00:00:00'), -> DATE_ADD('2010-01-01 00:00:00', INTERVAL -5 DAY) -> \G *************************** 1. row *************************** TIMESTAMPADD(DAY, -5, '2010-01-01 00:00:00'): 2009-12-27 00:00:00 DATE_ADD('2010-01-01 00:00:00', INTERVAL -5 DAY): 2009-12-27 00:00:00 1 row in set (0.01 sec) ~~~ #### TO\_DAYS **聲明** ~~~ TO_DAYS(date) ~~~ **說明** 返回指定`date`值對應的天數。天數指距離`0000-01-01`的天數。 **例子** ~~~ obclient> SELECT TO_DAYS('2015-11-04'), TO_DAYS('20151104'); +-----------------------+---------------------+ | TO_DAYS('2015-11-04') | TO_DAYS('20151104') | +-----------------------+---------------------+ | 736271 | 736271 | +-----------------------+---------------------+ 1 row in set (0.01 sec) ~~~ #### USEC\_TO\_TIME **聲明** ~~~ USEC_TO_TIME(usec) ~~~ **說明** 將`usec`值轉換為`TIMESTAMP`類型值。 `usec`表示距離`1970-01-01 00:00:00.000000`的微秒數，考慮時區信息。 **例子** ~~~ obclient> SELECT USEC_TO_TIME(1); +----------------------------+ | USEC_TO_TIME(1) | +----------------------------+ | 1970-01-01 08:00:00.000001 | +----------------------------+ 1 row in set (0.00 sec) ~~~ #### UNIX\_TIMESTAMP **聲明** ~~~ UNIX_TIMESTAMP() UNIX_TIMESTAMP(date) ~~~ **說明** * 不指定`date`參數時，返回當前時間距離 '1970-01-01 00:00:00' 的秒數，考慮時區。 * 指定`date`參數時，返回指定時間距離 '1970-01-01 00:00:00' 的秒數，考慮時區。 **例子** ~~~ obclient> SELECT UNIX_TIMESTAMP(), TIME_TO_USEC(NOW()); +------------------+---------------------+ | UNIX_TIMESTAMP() | TIME_TO_USEC(NOW()) | +------------------+---------------------+ | 1525570561 | 1525570561000000 | +------------------+---------------------+ 1 row in set (0.01 sec) obclient> SELECT UNIX_TIMESTAMP('1997-10-04 22:23:00'); +---------------------------------------+ | UNIX_TIMESTAMP('1997-10-04 22:23:00') | +---------------------------------------+ | 875974980 | +---------------------------------------+ 1 row in set (0.01 sec) ~~~ #### UTC\_TIMESTAMP **聲明** ~~~ UTC_TIMESTAMP() ~~~ **說明** 返回當前 UTC 時間。 **例子** ~~~ obclient> SELECT UTC_TIMESTAMP(); +---------------------+ | UTC_TIMESTAMP() | +---------------------+ | 2018-05-06 01:38:32 | +---------------------+ 1 row in set (0.01 sec) ~~~ #### YEAR **聲明** ~~~ YEAR(date) ~~~ **說明** 返回`date`值的年份信息。 **例子** ~~~ obclient> SELECT YEAR('1987-01-01'); +--------------------+ | YEAR('1987-01-01') | +--------------------+ | 1987 | +--------------------+ 1 row in set (0.00 sec) ~~~ ## 字符串函數 #### CONCAT **聲明** ~~~ CONCAT(str1, .., strN) ~~~ **說明** 把多個字符串連接成一個字符串。參數中包含`NULL`時，返回`NULL`。 **例子** ~~~ obclient> SELECT -> CONCAT('test','obclient', '1.0'), -> CONCAT('test','obclient', NULL) -> \G *************************** 1. row *************************** CONCAT('test','obclient', '1.0'): testobclient1.0 CONCAT('test','obclient', NULL): NULL 1 row in set (0.01 sec) ~~~ #### CONCAT\_WS **聲明** ~~~ CONCAT_WS(separator, str1, .., strN) ~~~ **說明** 把多個字符串連接成一個字符串，相鄰字符串間使用`separator`分隔。參數中包含`NULL`時，將忽略`NULL`。 **例子** ~~~ obclient> SELECT -> CONCAT_WS('_', 'First', 'Second'), -> CONCAT_WS('_', 'First', NULL, 'Second') -> \G *************************** 1. row *************************** CONCAT_WS('_', 'First', 'Second'): First_Second CONCAT_WS('_', 'First', NULL, 'Second'): First_Second 1 row in set (0.00 sec) ~~~ FORMAT **聲明** ~~~ FORMAT(X,D) ~~~ **說明** 把數字 X 格式化為“#,###,###.##”格式，四舍五入到 D 位小數，并以字符串形式返回結果（如果整數部分超過三位，會用“,”作為千分位分隔符）。如果 D 為 0，則結果沒有小數點或小數部分。 **例子** ~~~ obclient>SELECT FORMAT(12332.123456, 4) from DUAL; +-------------------------+ | format(12332.123456, 4) | +-------------------------+ | 12,332.1235 | +-------------------------+ 1 row in set (0.00 sec) obclient>SELECT FORMAT(12332.1, 4) from DUAL; +--------------------+ | format(12332.1, 4) | +--------------------+ | 12,332.1000 | +--------------------+ 1 row in set (0.01 sec) obclient>SELECT FORMAT(12332.2, 0) from DUAL; +--------------------+ | format(12332.2, 0) | +--------------------+ | 12,332 | +--------------------+ 1 row in set (0.00 sec) ~~~ #### SUBSTR **聲明** ~~~ SUBSTR(str, pos) SUBSTR(str, pos, len) SUBSTR(str FROM pos) SUBSTR(str FROM pos FOR len) ~~~ **說明** 返回`str`的子字符串，起始位置為`pos`，長度為`len`。參數中包含`NULL`時，返回`NULL`。 * 不指定`len`時，返回的子字符串從`pos`位置開始到`str`結尾。 * `pos`值為負數時，從`str`尾部向頭部倒序確定起始位置。 * `len`小于等于 0，或`pos`指定的起始位置非法時，返回空字符串。 **例子** ~~~ obclient> SELECT -> SUBSTR('abcdefg', 3), -> SUBSTR('abcdefg', 3, 2), -> SUBSTR('abcdefg', -3), -> SUBSTR('abcdefg', 3, -2), -> SUBSTR('abcdefg' from -4 for 2) -> \G *************************** 1. row *************************** SUBSTR('abcdefg', 3): cdefg SUBSTR('abcdefg', 3, 2): cd SUBSTR('abcdefg', -3): efg SUBSTR('abcdefg', 3, -2): SUBSTR('abcdefg' from -4 for 2): de 1 row in set (0.01 sec) ~~~ #### SUBSTRING **聲明** ~~~ SUBSTRING(str, pos) SUBSTRING(str, pos, len) SUBSTRING(str FROM pos) SUBSTRING(str FROM pos FOR len) ~~~ **說明** 同`SUBSTR`。 #### TRIM **聲明** ~~~ TRIM([[{BOTH | LEADING | TRAILING}] [remstr] FROM] str) ~~~ **說明** 刪除字符串所有前綴和/或后綴，默認為`BOTH`。參數中包含`NULL`時，返回`NULL`。 **例子** ~~~ obclient> SELECT -> TRIM(' bar '), -> TRIM(LEADING 'x' FROM 'xxxbarxxx'), -> TRIM(BOTH 'x' FROM 'xxxbarxxx'), -> TRIM(TRAILING 'x' FROM 'xxxbarxxx') -> \G *************************** 1. row *************************** TRIM(' bar '): bar TRIM(LEADING 'x' FROM 'xxxbarxxx'): barxxx TRIM(BOTH 'x' FROM 'xxxbarxxx'): bar TRIM(TRAILING 'x' FROM 'xxxbarxxx'): xxxbar 1 row in set (0.01 sec) ~~~ #### LTRIM **聲明** ~~~ LTRIM(str) ~~~ **說明** 刪除字符串左側的空格。 #### RTRIM **聲明** ~~~ RTRIM(str) ~~~ **說明** 刪除字符串右側的空格。 #### ASCII **聲明** ~~~ ASCII(str) ~~~ **說明** 返回字符串最左側字符的 ASCII 碼。 #### ORD **聲明** ~~~ ORD(str) ~~~ **說明** 返回字符串最左側字符的字符碼。單字節編碼如果最左側字符是多字節編碼字符，返回值計算規則如下： ~~~ (1st byte code) + (2nd byte code * 256) + (3rd byte code * 256^2) ... ~~~ **例子** ~~~ obclient> SELECT ORD('中國'); +---------------+ | ORD('中國') | +---------------+ | 14989485 | +---------------+ 1 row in set (0.01 sec) ~~~ #### LENGTH **聲明** ~~~ LENGTH(str) ~~~ **說明** 返回`str`的字節長度。 **例子** ~~~ obclient> SELECT LENGTH('中國'), LENGTH('hello'); +------------------+-----------------+ | LENGTH('中國') | LENGTH('hello') | +------------------+-----------------+ | 6 | 5 | +------------------+-----------------+ 1 row in set (0.01 sec) ~~~ #### CHAR\_LENGTH **聲明** ~~~ CHAR_LENGTH(str) ~~~ **說明** 返回字符串包含的字符數。 **例子** ~~~ obclient> SELECT CHAR_LENGTH('中國'), CHAR_LENGTH('hello'); +-----------------------+----------------------+ | CHAR_LENGTH('中國') | CHAR_LENGTH('hello') | +-----------------------+----------------------+ | 2 | 5 | +-----------------------+----------------------+ 1 row in set (0.00 sec) ~~~ #### UPPER **聲明** ~~~ UPPER(str) ~~~ **說明** 將字符串中的小寫字母轉化為大寫字母。 **例子** ~~~ obclient> SELECT UPPER('obclient您好！'); +-----------------------------+ | UPPER('obclient您好！') | +-----------------------------+ | OCEANBASE您好！ | +-----------------------------+ 1 row in set (0.01 sec) ~~~ #### LOWER **聲明** ~~~ LOWER(str) ~~~ **說明** 將字符串中的大寫字母轉化為小寫字母。 **例子** ~~~ obclient> SELECT LOWER('obclient您好！'); +-----------------------------+ | LOWER('obclient您好！') | +-----------------------------+ | obclient您好！ | +-----------------------------+ 1 row in set (0.01 sec) ~~~ #### HEX **聲明** ~~~ HEX(str) ~~~ **說明** 將數字或字符串轉化為十六進制字符串。 **例子** ~~~ obclient> SELECT HEX(255), HEX('abc'); +----------+------------+ | HEX(255) | HEX('abc') | +----------+------------+ | FF | 616263 | +----------+------------+ 1 row in set (0.00 sec) ~~~ #### UNHEX **聲明** ~~~ UNHEX(str) ~~~ **說明** 將十六進制字符串轉化為正常字符串。 **例子** ~~~ obclient> SELECT UNHEX('4f6365616e42617365'); +-----------------------------+ | UNHEX('4f6365616e42617365') | +-----------------------------+ | obclient | +-----------------------------+ 1 row in set (0.00 sec) ~~~ #### MD5 **聲明** ~~~ MD5(str) ~~~ **說明** 返回字符串的 MD5 值。 **例子** ~~~ obclient> SELECT MD5(1); +----------------------------------+ | MD5(1) | +----------------------------------+ | c4ca4238a0b923820dcc509a6f75849b | +----------------------------------+ 1 row in set (0.00 sec) ~~~ #### INT2IP **聲明** ~~~ INT2IP(int_value) ~~~ **說明** 將整數內碼轉換成 IP 地址。 **例子** ~~~ obclient> SELECT -> INT2IP(16777216), -> HEX(16777216), -> INT2IP(1) -> \G *************************** 1. row *************************** INT2IP(16777216): 1.0.0.0 HEX(16777216): 1000000 INT2IP(1): 0.0.0.1 1 row in set (0.01 sec) ~~~ #### IP2INT **聲明** ~~~ IP2INT('ip_addr') ~~~ **說明** 將 IP 地址轉換成整數內碼。 **例子** ~~~ obclient> SELECT -> IP2INT('0.0.0.1'), -> HEX(IP2INT('0.0.0.1')), -> HEX(IP2INT('1.0.0.0')) -> \G *************************** 1. row *************************** IP2INT('0.0.0.1'): 1 HEX(IP2INT('0.0.0.1')): 1 HEX(IP2INT('1.0.0.0')): 1000000 1 row in set (0.01 sec) ~~~ #### LIKE **聲明** ~~~ str1 [NOT] LIKE str2 [ESCAPE str3] ~~~ **說明** 字符串通配符匹配。參數中包含`NULL`時，返回`NULL`。通配符包括： * `%`：匹配任意長度字符串。 * `_`：匹配單個字符。 ESCAPE 用于定義轉義符，如果 str2 中包含 str3，在匹配時 str3 后的字符將做為普通字符處理。 **例子** ~~~ obclient> SELECT 'ab%' LIKE 'abc%' ESCAPE 'c'; +------------------------------+ | 'ab%' LIKE 'abc%' ESCAPE 'c' | +------------------------------+ | 1 | +------------------------------+ 1 row in set (0.01 sec) ~~~ #### REGEXP **聲明** ~~~ str [NOT] REGEXP | RLIKE pat ~~~ **說明** 正則匹配。參數中包含`NULL`時，返回`NULL`。 **例子** ~~~ obclient> SELECT -> 1234 REGEXP 1, -> 'hello' RLIKE 'h%' -> \G *************************** 1. row *************************** 1234 REGEXP 1: 1 'hello' RLIKE 'h%': 0 1 row in set (0.01 sec) ~~~ #### REPEAT **聲明** ~~~ REPEAT(str, count) ~~~ **說明** 返回`str`重復`count`次組成的字符串。`count`小于等于 0 時，返回空字符串。參數中包含`NULL`時，返回`NULL`。 **例子** ~~~ obclient> SELECT -> REPEAT('1', -1), -> REPEAT(null, null), -> REPEAT('Abc', 4) -> \G *************************** 1. row *************************** REPEAT('1', -1): REPEAT(null, null): NULL REPEAT('Abc', 4): AbcAbcAbcAbc 1 row in set (0.01 sec) ~~~ #### SPACE **聲明** ~~~ SPACE(N) ~~~ **說明** 返回包含`N`個空格的字符串。 #### SUBSTRING\_INDEX **聲明** ~~~ SUBSTRING_INDEX(str, delim, count) ~~~ **說明** 在定界符 delim 以及 count 出現前，從字符串 str 返回字符串。若 count 為正值，則返回最終定界符（從左邊開始）左邊的一切內容。若 count 為負值，則返回定界符（從右邊開始）右邊的一切內容。任意一個參數為 NULL，返回 NULL；若 str 或 delim 為空字符串，則返回空串；若 count = 0, 返回空串。 *str, delim, count 參數支持數值與字符串的隱式轉換。* **例子** ~~~ obclient>select substring_index('abcdabc', 'abc', 0), substring_index('abcdabc', 'abc', 1), substring_index('abcdabc', 'abc', 2), substring_index('abcdabc', 'abc', 3), substring_index('abcdabc', 'abc', -1), substring_index('abcdabc', 'abc', -2), substring_index('abcdabc', 'abc', -3)\G; * 1. row * substring_index('abcdabc', 'abc', 0): substring_index('abcdabc', 'abc', 1): substring_index('abcdabc', 'abc', 2): abcd substring_index('abcdabc', 'abc', 3): abcdabc substring_index('abcdabc', 'abc', -1): substring_index('abcdabc', 'abc', -2): dabc substring_index('abcdabc', 'abc', -3): abcdabc 1 row in set (0.00 sec) ~~~ #### LOCATE **聲明** `LOCATE(substr,str) , LOCATE(substr,str,pos)` **說明** 第一個語法返回字符串 str 中子字符串 substr 的第一個出現位置。第二個語法返回字符串 str 中子字符串 substr 的第一個出現位置, 起始位置在 pos。如若 substr 不在 str 中，則返回值為 0。 **例子** ~~~ obclient>SELECT LOCATE('bar', 'foobarbar'); -> 4 obclient>SELECT LOCATE('xbar', 'foobar'); -> 0 obclient>SELECT LOCATE('bar', 'foobarbar',5); -> 7 ~~~ #### POSITION **聲明** `POSITION(substr IN str)` **說明** 與 LOCATE 同義。 #### INSTR **聲明** `INSTR(str,substr)` **說明** 返回字符串 str 中子字符串的第一個出現位置。這和 LOCATE() 的雙參數形式相同，除非參數的順序被顛倒。 **例子** ~~~ obclient>SELECT INSTR('foobarbar', 'bar'); -> 4 obclient>SELECT INSTR('xbar', 'foobar'); -> 0 ~~~ #### REPLACE **聲明** `REPLACE(str, from_str, to_str)` **說明** 返回字符串 str 以及所有被字符 to\_str 替代的字符串 from\_str。 **例子** ~~~ obclient>SELECT REPLACE('abc.efg.gpg.nowdew.abc.dabc.e', 'abc.', 'www'); +---------------------------------------------------------+ | REPLACE('abc.efg.gpg.nowdew.abc.dabc.e', 'abc.', 'www') | +---------------------------------------------------------+ | wwwefg.gpg.nowdew.wwwdwwwe | +---------------------------------------------------------+ 1 row in set (0.00 sec) ~~~ #### FIELD **聲明** `FIELD(str,str1,str2,str3,…)` **說明** 返回參數 str 在 str1, str2, str3,… 列表中的索引位置（從 1 開始的位置）。在找不到 str 的情況下，返回值為 0。如果所有的對于 FIELD() 的參數均為字符串，則所有參數均按照字符串進行比較。如果所有的參數均為數字，則按照數字進行比較。否則，參數均按照 double 類型進行比較。如果 str 為 NULL，則返回值為 0，原因是 NULL 不能同任何值進行同等比較。FILED() 是 ELT() 的補數。 **例子** ~~~ obclient>select field('abc','abc1','abc2','abc','abc4','abc'), field(NULL, 'null1', NULL); +-----------------------------------------------+----------------------------+ | field('abc','abc1','abc2','abc','abc4','abc') | field(NULL, 'null1', NULL) | +-----------------------------------------------+----------------------------+ | 3 | 0 | +-----------------------------------------------+----------------------------+ 1 row in set (0.00 sec) ~~~ #### ELT **聲明** `ELT(N, str1, str2, str3,…)` **說明** 若 N=1，則返回值為 str1, 若 N=2，則返回值為 str2，以此類推。若 N 小于 1 或大于參數的數目，則返回值為NULL。ELT() 是 FIELD() 的補數。 **例子** ~~~ obclient>select elt(3, 'abc1', 'abc2', 'abc', 'abc4', 'abc'), elt(0, 'null1', NULL); +----------------------------------------------+-----------------------+ | elt(3, 'abc1', 'abc2', 'abc', 'abc4', 'abc') | elt(0, 'null1', NULL) | +----------------------------------------------+-----------------------+ | abc | NULL | +----------------------------------------------+-----------------------+ 1 row in set (0.00 sec) ~~~ #### INSERT **聲明** `INSERT (str1,pos,len,str2)` **說明** 返回字符串 str1, 字符串中起始于 pos 位置，長度為 len 的子字符串將被 str2 取代。如果 pos 超過字符串長度，則返回值為原始字符串。假如 len 的長度大于其它字符串的長度，則從位置 pos 開始替換。若任何一個參數為 null，則返回值為 NULL。這個函數支持多字節字元。 * *str1 和 str2 必須是字符串，pos 和 len 必須是整數。任意參數為 NULL，結果總為 NULL；* * *str1 和 str2 中的文字符被當做字節流看待；* * *pos 值為負數或者大于 str1 長度時，返回 str1；* * 當 len 小于 0，或大于 str 的長度時，返回結果為 str1 從開頭到 pos 位置的串，和 str2 的組合串。 **例子** ~~~ obclient>select insert('Quadratic',-2,100,'What'), insert('Quadratic',7,3,'What'), -> insert('Quadratic',-1,3,'What'), insert('Quadratic',10,3,'What'), insert('Quadratic',5,-1,''), -> insert('Quadratic',7,-1,'What')\G; * 1. row * insert('Quadratic',-2,100,'What'): Quadratic insert('Quadratic',7,3,'What'): QuadraWhat insert('Quadratic',-1,3,'What'): Quadratic insert('Quadratic',10,3,'What'): Quadratic insert('Quadratic',5,-1,''): Quad insert('Quadratic',7,-1,'What'): QuadraWhat 1 row in set (0.01 sec) ~~~ #### LPAD **聲明** `LPAD(str, len, padstr)` **說明** 用指定字符串 padstr，在左側填充字符串 str 到指定長度 len。如果 str 長度大于 len，則 str 被截斷。 **例子** ~~~ obclient > SELECT LPAD('hi',4,'??'); +-------------------+ | LPAD('hi',4,'??') | +-------------------+ | ??hi | +-------------------+ 1 row in set (0.01 sec) obclient > SELECT LPAD('hi',1,'??'); +-------------------+ | LPAD('hi',1,'??') | +-------------------+ | h | +-------------------+ 1 row in set (0.00 sec) ~~~ #### RPAD **聲明** `RPAD(str, len, padstr)` **說明** 用指定字符串 padstr，在右側填充字符串 str 到指定長度 len。如果 str 長度大于 len，則 str 被截斷。 **例子** ~~~ obclient> SELECT RPAD('hi',4,'??'); +-------------------+ | RPAD('hi',4,'??') | +-------------------+ | hi?? | +-------------------+ 1 row in set (0.00 sec) obclient> SELECT RPAD('hi',1,'??'); +-------------------+ | RPAD('hi',1,'??') | +-------------------+ | h | +-------------------+ 1 row in set (0.00 sec) ~~~ #### UUID **聲明** `uuid()` **說明** 生成一個全局唯一 ID。 **例子** ~~~ obclient> select uuid(); +--------------------------------------+ | uuid() | +--------------------------------------+ | f756a1f6-4de6-11e8-90af-90b11c53e421 | +--------------------------------------+ 1 row in set (0.00 sec) ~~~ #### BIN **聲明** `bin(N)` **說明** 返回數字 N 的二進制形式。 **例子** ~~~ obclient > SELECT BIN(12); +---------+ | BIN(12) | +---------+ | 1100 | +---------+ 1 row in set (0.00 sec) ~~~ #### QUOTE **聲明** `quote(str)` **說明** 引用一個字符串以產生一個結果可以作為 SQL 語句中正確地轉義數據值。返回的字符串由單引號和單引號的各個實例封閉('')，反斜線('')，ASCII NUL 和 Control-Z 前面加一個反斜杠。如果參數為 NULL，則返回值是詞 'NULL' 不包圍單引號。 **例子** ~~~ obclient > SELECT QUOTE('Don\'t!'); +------------------+ | QUOTE('Don\'t!') | +------------------+ | 'Don\'t!' | +------------------+ 1 row in set (0.00 sec) obclient > SELECT QUOTE(NULL); +-------------+ | QUOTE(NULL) | +-------------+ | NULL | +-------------+ 1 row in set (0.00 sec) ~~~ #### REGEXP\_SUBSTR **聲明** `regexp_substr(str,pattern,[position[,occurrence[,match_param[,subexpr]]]])` **說明** 在 str 中搜索匹配正則表達式 pattern 的子串，子串不存在返回 NULL。這個函數支持多字節字元。除 match\_param 外，其他任意參數為 NULL，結果為 NULL。 * str 待搜索的字符串，支持多字節字元。 * pattern 正則表達式，正則表達式規則兼容 mysql。 * position \[可選\] 搜索的開始位置。必須是大于 0 的正整數，小于等于 0 報錯，輸入為 NULL 返回 NULL，默認值為 1，表示從第一個字符開始搜索。 * occurrence \[可選\] 返回第幾次匹配的值。必須是大于等于 0 的正整數，小于等于 0 報錯，輸入為 NULL 返回 NULL，默認值是 1，表示返回第一次匹配的結果。 * match\_param \[可選\] 搜索參數，字符串類型，目前僅支持兩個字符 ‘i’,‘c’，i: 代表忽略大小寫 c: 代表不忽略，其他字符報錯。默認值根據 str 字符集的 collection 決定。為 NULL 時使用默認值。 * subexpr \[可選\] 返回正則表達式中第幾個組的值。大于等于 0 的整數，小于 0 則報錯。默認值是 0，表示返回滿足整個 pattern 的子串。 **例子** ~~~ obclient> select regexp_substr('I have 2 apples and 100 bucks!', '[[:blank:]][[:alnum:]]*', 1, 1) from dual; +----------------------------------------------------------------------------------+ | regexp_substr('I have 2 apples and 100 bucks!', '[[:blank:]][[:alnum:]]*', 1, 1) | +----------------------------------------------------------------------------------+ | have | +----------------------------------------------------------------------------------+ 1 row in set (0.00 sec) obclient> select regexp_substr('foothebar', 'foo(.*)(bar)', 1, 1, 'c', 1) from dual; +----------------------------------------------------------+ | regexp_substr('foothebar', 'foo(.*)(bar)', 1, 1, 'c', 1) | +----------------------------------------------------------+ | the | +----------------------------------------------------------+ 1 row in set (0.01 sec) ~~~ ## 轉換函數 #### CAST **聲明** `CAST(expr AS type)` **說明** 將某種數據類型的表達式顯式轉換為另一種數據類型。將 expr 字段值轉換為 type 數據類型。 **參數說明**： * expr：表示任何有效的 SQL 表達式。 * AS：用于分隔兩個參數，在 AS 之前的是要處理的數據，在 AS 之后是要轉換的數據類型。 * type：表示目標系統所提供的數據類型。可以是以下值其中的一個： * DATE * DATETIME * DECIMAL * SIGNED \[INTEGER\] * TIME * UNSIGNED \[INTEGER\] 在使用 CAST 函數進行數據類型轉換時，在下列情況下能夠被接受： * 兩個表達式的數據類型完全相同； * 兩個表達式可隱式轉換； * 必須顯式轉換數據類型。如果試圖進行不可能的轉換，OceanBase數據庫將顯示一條錯誤信息。如果轉換時沒有指定數據類型的長度，則使用 OceanBase 數據庫系統內部最大長度。如 varchar 是262,143字節，number 是 65 個 bit 位的浮動精度。支持帶符號和無符號的 64 比特值的運算。若你正在使用數字操作符 (如 +) 而其中一個操作數為無符號整數，則結果為無符號。可使用 SIGNED 和 UNSIGNED cast 操作符來覆蓋它。將運算分別派給帶符號或無符號 64 比特整數。假如任意一個操作數為一個浮點值，則結果為一個浮點值。 **例子** ~~~ obclient>SELECT CAST(123 AS BOOL); +-------------------+ | CAST(123 AS bool) | +-------------------+ | 1 | +-------------------+ 1 row in set (0.00 sec) obclient>select cast(1-2 as unsigned), cast(cast(1-2 as unsigned) as signed); +-----------------------+---------------------------------------+ | cast(1-2 as unsigned) | cast(cast(1-2 as unsigned) as signed) | +-----------------------+---------------------------------------+ | 18446744073709551615 | -1 | +-----------------------+---------------------------------------+ 1 row in set (0.00 sec) obclient>SELECT CAST(1 AS UNSIGNED) - 2.0; +---------------------------+ | CAST(1 AS UNSIGNED) - 2.0 | +---------------------------+ | -1.0 | +---------------------------+ 1 row in set (0.00 sec) obclient>select cast(0 as date); +-----------------+ | cast(0 as date) | +-----------------+ | 0000-00-00 | +-----------------+ 1 row in set (0.00 sec) ~~~ ## 數學函數 #### ROUND **聲明** `ROUND(X), ROUND(X,D)` **說明** 返回一個數值，四舍五入到指定的長度或精度。返回參數 X, 其值接近于最近似的整數。在有兩個參數的情況下，返回 X，其值保留到小數點后 D 位，而第 D 位的保留方式為四舍五入。若要接保留 X 值小數點左邊的 D 位，可將 D 設為負值。返回值的類型同第一個自變量相同（假設它是一個整數、雙精度數或小數）。這意味著對于一個整數參數，結果也是一個整數（無小數部分）。 * 對于準確值數字，ROUND() 使用“四舍五入” 或“舍入成最接近的數” 的規則：對于一個分數部分為 .5 或大于 .5 的值，正數則上舍入到鄰近的整數值，負數則下舍入臨近的整數值。（換言之, 其舍入的方向是數軸上遠離零的方向）。對于一個分數部分小于 .5 的值，正數則下舍入下一個整數值，負數則下舍入鄰近的整數值，而正數則上舍入鄰近的整數值。 * 對于近似值數字， ROUND() 遵循銀行家規則“四舍--大于五入--五取最接近的偶數”的規則：一個帶有任何小數部分的值會被舍入成最接近的偶數整數。 **例子** ~~~ obclient>select round(2.15,2); +---------------+ | round(2.15,2) | +---------------+ | 2.15 | +---------------+ 1 row in set (0.00 sec) obclient>select round(2555e-2,1); +------------------+ | round(2555e-2,1) | +------------------+ | 25.6 | +------------------+ 1 row in set (0.01 sec) obclient>select round(25e-1), round(25.3e-1),round(35e-1); +--------------+----------------+--------------+ | round(25e-1) | round(25.3e-1) | round(35e-1) | +--------------+----------------+--------------+ | 3 | 3 | 4 | +--------------+----------------+--------------+ 1 row in set (0.00 sec) ~~~ #### CEIL **聲明** `CEIL(expr)` **說明** 返回大于或者等于指定表達式的最小整數。還支持比較運算，結果為 BOOL 值，被轉化為數字類型處理，產生的結果為 1(TRUE)、0 (FALSE)；如果輸入 NULL，返回值為 NULL。如果輸入純數字的字符串，支持自動轉換成數字類型。返回值會被轉化為一個 BIGINT。 **例子** ~~~ obclient>select ceil(1.2), ceil(-1.2), ceil(1+1.5), ceil(1=1),ceil(1<1),ceil(null); +-----------+------------+-------------+-----------+-----------+------------+ | ceil(1.2) | ceil(-1.2) | ceil(1+1.5) | ceil(1=1) | ceil(1<1) | ceil(null) | +-----------+------------+-------------+-----------+-----------+------------+ | 2 | -1 | 3 | 1 | 0 | NULL | +-----------+------------+-------------+-----------+-----------+------------+ 1 row in set (0.00 sec) obclient>select ceil(name); ERROR 1166 (42703): Unkown column name 'name' obclient>select ceil('2'); +-----------+ | ceil('2') | +-----------+ | 2 | +-----------+ 1 row in set (0.00 sec) ~~~ #### FLOOR **聲明** `FLOOR(expr)` **說明** 和 CEIL(expr) 函數功能類似，返回小于或者等于指定表達式的最大整數。還支持比較運算，結果為 BOOL 值，被轉化為數字類型處理，產生的結果為 1(TRUE)、0 (FALSE)；如果輸入 NULL，返回值為 NULL。如果輸入純數字的字符串，支持自動轉換成數字類型。返回值會被轉化為一個 BIGINT。 **例子** ~~~ obclient>select floor(1.2), floor(-1.2), floor(1+1.5), floor(1=1),floor(1<1),floor(null); +------------+-------------+--------------+------------+------------+-------------+ | floor(1.2) | floor(-1.2) | floor(1+1.5) | floor(1=1) | floor(1<1) | floor(null) | +------------+-------------+--------------+------------+------------+-------------+ | 1 | -2 | 2 | 1 | 0 | NULL | +------------+-------------+--------------+------------+------------+-------------+ 1 row in set (0.00 sec) obclient>select floor(name); ERROR 1166 (42703): Unkown column name 'name' obclient>select floor('2'); +------------+ | floor('2') | +------------+ | 2 | +------------+ 1 row in set (0.00 sec) ~~~ #### ABS **聲明** `ABS(expr)` **說明** 絕對值函數，求表達式絕對值，函數返回值類型與數值表達式的數據類型相同。還支持比較運算，結果為 BOOL 值，被轉化為數字類型處理，產生的結果為 1(TRUE)、0 (FALSE)；如果輸入 NULL，返回值為 NULL。如果輸入純數字的字符串，支持自動轉換成數字類型。返回值會被轉化為一個 BIGINT。 **例子** ~~~ obclient>select abs(5), abs(-5.777), abs(0), abs(1/2), abs(1-5); +--------+-------------+--------+----------+----------+ | abs(5) | abs(-5.777) | abs(0) | abs(1/2) | abs(1-5) | +--------+-------------+--------+----------+----------+ | 5 | 5.777 | 0 | 0.5000 | 4 | +--------+-------------+--------+----------+----------+ 1 row in set (0.00 sec) ~~~ #### NEG **聲明** `NEG(expr)` **說明** 求補函數，對操作數執行求補運算：用零減去操作數，然后結果返回操作數。支持比較運算，結果為 BOOL 值，被轉化為數字類型處理，產生的結果為 1(TRUE)、0 (FALSE)，再對結果求補。 **例子** ~~~ obclient>select neg(1), neg(1+1), neg(2*3), neg(1=1), neg(5<1); +--------+----------+----------+----------+----------+ | neg(1) | neg(1+1) | neg(2*3) | neg(1=1) | neg(5<1) | +--------+----------+----------+----------+----------+ | -1 | -2 | -6 | -1 | 0 | +--------+----------+----------+----------+----------+ 1 row in set (0.01 sec) ~~~ #### SIGN **聲明** `SIGN(X)` **說明** SIGN(X) 返回參數作為 -1、 0 或 1 的符號，該符號取決于 X 的值為負、零或正。支持比較運算，結果為 BOOL 值，被轉化為數字類型處理，產生的結果為 1(TRUE)、0 (FALSE)；如果輸入 NULL，返回值為 NULL。支持浮點數、十六進制數。 **例子** ~~~ obclient>SELECT SIGN(-32), SIGN(0), SIGN(234); +-----------+---------+-----------+ | SIGN(-32) | SIGN(0) | SIGN(234) | +-----------+---------+-----------+ | -1 | 0 | 1 | +-----------+---------+-----------+ 1 row in set (0.01 sec) obclient>select sign(null),sign(false),sign(0x01); +------------+-------------+------------+ | sign(null) | sign(false) | sign(0x01) | +------------+-------------+------------+ | NULL | 0 | 1 | +------------+-------------+------------+ 1 row in set (0.00 sec) ~~~ #### CONV **聲明** `CONV(N, from_base, to_base)` **說明** 不同數基間轉換數字。返回值為一個字符串，由 from\_base 基轉化為 to\_base 基。輸入參數 N 可以是一個整數或字符串。最小基數為 2，而最大基數則為 36。如果 to\_base 是一個負數，則 N 被看作一個帶符號數。否則，N 被看作無符號數。from\_base 如果是負數，則被當作整數處理，符號被忽略。N 參數僅支持 int 類型和字符串類型輸入；from\_base 和 to\_base 參數僅支持十進制 int 類型輸入，且取值范圍為 \[-36, -2\] U \[2, 36\]。非法輸入將導致報錯，其中非法輸入包括以下情況： * *from\_base 或者 to\_base 不是一個合法的十進制int類型輸入；* * *from\_base 或者 to\_base 超出 \[-36,-2\] U \[2,36\] 的取值范圍；* * N 不是一個合法的數字表示，例如取值超出 0～9，a～z，A～Z 的字符范圍； * N 超出了 from\_base 基的取值范圍，例如 from\_base 為 2，而 N 取值為 3； * N 的取值超出了 int64 的最大表示范圍，即 \[-9223372036854775807, 9223372036854775807\]。 **例子** ~~~ obclient>select conv(9223372036854775807,10,2); +-----------------------------------------------------------------+ | conv(9223372036854775807,10,2) | +-----------------------------------------------------------------+ | 111111111111111111111111111111111111111111111111111111111111111 | +-----------------------------------------------------------------+ 1 row in set (0.00 sec) obclient>select conv('-acc',21,-7); +--------------------+ | conv('-acc',21,-7) | +--------------------+ | -16425 | +--------------------+ 1 row in set (0.00 sec) ~~~ #### MOD **聲明** `MOD(N,M)` **說明** 取余函數。MOD(N，M)， N % M， N MOD M 三種形式是等效的。 MOD() 對于帶有小數部分的數值也起作用，它返回除法運算后的精確余數。 N,M 中任何一個參數為 NULL，返回值都為 NULL。M 為 0 時，也返回 NULL。 **例子** ~~~ obclient>select mod(29,19), 29 mod 19, 29 % 19; +------------+-----------+---------+ | mod(29,19) | 29 mod 19 | 29 % 19 | +------------+-----------+---------+ | 10 | 10 | 10 | +------------+-----------+---------+ 1 row in set (0.00 sec) ~~~ #### POW **聲明** `POW(X,Y)` **說明** 返回 X 的 Y 次方。 X 與 Y 中任何一個參數為 NULL，返回值都為 NULL。 **例子** ~~~ obclient>select pow(4,2), pow(4,-2), pow(1,null); +----------+-----------+-------------+ | pow(4,2) | pow(4,-2) | pow(1,null) | +----------+-----------+-------------+ | 16 | 0.0625 | NULL | +----------+-----------+-------------+ 1 row in set (0.00 sec) ~~~ #### POWER **聲明** `POWER(X,Y)` **說明** POWER(X,Y) 和 POW(X,Y) 是同義函數。 #### RAND **聲明** `rand([N])` **說明** RAND(\[N\]) 函數接受 0 個或者 1 個參數（N 被稱為隨機數種子），返回一個范圍是 \[0,1.0) 的隨機浮點數。如果想獲得一個范圍在 \[i, j) 的隨機整數，可以使用表達式 FLOOR(I + RAND() \* (j - i))。如果參數 N 不指定，那么在執行之前會使用隨機種子初始化，之后 RAND() 會根據這個初始化值來生成隨機數，所以 RAND() 每次會生成不同的隨機數序列。如果參數 N 指定，那么 N 會作為隨機數種子來生成隨機數。根據 N 是否是常量，分成以下兩種情況： * 如果 N 是常量，那么 N 在執行之前會被當成隨機種子初始化，之后 RAND(N) 會根據這個初始化值來生成隨機數。相同的 N 值會生成相同的隨機數序列。 * 如果 N 是變量(比如 N 是一個列值)，那么 N 會在每次執行的時候作為隨機數種子來生成隨機數。相同的 N 值會生成相同的隨機數。除了出現在 Select 語句中，RAND(\[N\]) 也可以出現在 where，order by 和 group by 語句中，它的執行方式還是按照上述規則執行。比如，如果想隨機的對一個表進行排序，可以使用如下 SQL：select from t1 order by rand()。如果想隨機取樣一個表的 100 行，可以使用如下 SQL：select from t1 order by rand() limit 100。 **例子** ~~~ obclient> select a, b, rand() from t3; +------+------+---------------------+ | a | b | rand() | +------+------+---------------------+ | 1 | 1 | 0.641815407799385 | | 2 | 2 | 0.16825051248841966 | | 3 | 3 | 0.9158063697775886 | +------+------+---------------------+ 3 rows in set (0.00 sec) obclient> select a, b, rand() from t3; +------+------+---------------------+ | a | b | rand() | +------+------+---------------------+ | 1 | 1 | 0.07428034215632857 | | 2 | 2 | 0.6239826321825224 | | 3 | 3 | 0.897072165177271 | +------+------+---------------------+ 3 rows in set (0.00 sec) obclient> select a, b, rand(3) from t3; +------+------+---------------------+ | a | b | rand(3) | +------+------+---------------------+ | 1 | 1 | 0.9057697559760601 | | 2 | 2 | 0.37307905813034536 | | 3 | 3 | 0.14808605345719125 | +------+------+---------------------+ 3 rows in set (0.00 sec) obclient> select a, b, rand(3) from t3; +------+------+---------------------+ | a | b | rand(3) | +------+------+---------------------+ | 1 | 1 | 0.9057697559760601 | | 2 | 2 | 0.37307905813034536 | | 3 | 3 | 0.14808605345719125 | +------+------+---------------------+ 3 rows in set (0.00 sec) obclient> select a, b, rand(a), rand(b) from t3; +------+------+---------------------+---------------------+ | a | b | rand(a) | rand(b) | +------+------+---------------------+---------------------+ | 1 | 1 | 0.40540353712197724 | 0.40540353712197724 | | 2 | 2 | 0.6555866465490187 | 0.6555866465490187 | | 3 | 3 | 0.9057697559760601 | 0.9057697559760601 | +------+------+---------------------+---------------------+ 3 rows in set (0.00 sec) ~~~ ## 比較函數 #### GREATEST **聲明** `GREATEST(value1, ...)` **說明** 返回參數的最大值，和函數 LEAST() 相對。參數至少為兩個（一個參數將會報錯）；如果參數中有 NULL, 返回值為 NULL。當參數中同時存在數值和字符時，把字符隱式轉換為數值類型處理，不能轉換的報錯。 **例子** ~~~ obclient>select greatest(2,1), greatest('2',1,0), greatest('a','b','c'), greatest('a', NULL, 'c'), greatest('2014-05-15','2014-06-01')\G * 1. row * greatest(2,1): 2 greatest('2',1,0): 2 greatest('a','b','c'): c greatest('a', NULL, 'c'): NULL greatest('2014-05-15','2014-06-01'): 2014-06-01 1 row in set (0.01 sec) obclient>select greatest(2); ERROR 1582 (42000): Incorrect parameter count in the call to native function 'greatest' ~~~ #### LEAST **聲明** `LEAST(value1, ...)` **說明** 返回參數的最小值，和函數 GREATEST() 相對。參數至少為兩個；如果參數中有 NULL，返回值為 NULL。當參數中同時存在數值和字符時，把字符隱式轉換為數值類型處理，不能轉換的報錯。 **例子** ~~~ obclient>select least(2, null), least('2',4,9), least('a','b','c'), least('a',NULL,'c'), least('2014-05-15','2014-06-01')\G; * 1. row * least(2, null): NULL least('2',4,9): 2 least('a','b','c'): a least('a',NULL,'c'): NULL least('2014-05-15','2014-06-01'): 2014-05-15 1 row in set (0.01 sec) obclient>select least(2); ERROR 1582 (42000): Incorrect parameter count in the call to native function 'least' ~~~ #### ISNULL **聲明** `ISNULL(expr)` **說明** 如果參數 expr 為 NULL，那么 ISNULL() 的返回值為 1，否則范圍值為 0。 ISNULL() 函數可以用來替代針對 NULL 的等值（=）比較。（使用 = 的 NULL 值比較通常都是錯誤的。）ISNULL() 函數同 IS NULL 比較操作符具有一些相同的特性。 **例子** ~~~ obclient>SELECT ISNULL(null), ISNULL('test'), ISNULL(123.456), ISNULL('10:00'); +--------------+----------------+-----------------+-----------------+ | ISNULL(null) | ISNULL('test') | ISNULL(123.456) | ISNULL('10:00') | +--------------+----------------+-----------------+-----------------+ | 1 | 0 | 0 | 0 | +--------------+----------------+-----------------+-----------------+ 1 row in set (0.01 sec) obclient>SELECT ISNULL(null+1); +----------------+ | ISNULL(null+1) | +----------------+ | 1 | +----------------+ 1 row in set (0.00 sec) ~~~ ## 流程控制函數 #### CASE **聲明** ~~~ CASE value WHEN [compare-value] THEN result [WHEN [compare-value] THEN result ...] [ELSE result] END OR CASE WHEN [condition] THEN result [WHEN [condition] THEN result ...] [ELSE result] END ~~~ **說明** 在第一個方案的返回結果中，value = compare-value。而第二個方案的返回結果是第一種條件為真。如果沒有匹配的結果值，則返回結果為 ELSE 后的結果，如果沒有 ELSE 部分，則返回值為 NULL。 **例子** ~~~ obclient>select CASE 'b' when 'a' then 1 when 'b' then 2 END; +----------------------------------------------+ | CASE 'b' when 'a' then 1 when 'b' then 2 END | +----------------------------------------------+ | 2 | +----------------------------------------------+ 1 row in set (0.01 sec) obclient>select CASE concat('a','b') when concat('ab','') then 'a' when 'b' then 'b' end; +--------------------------------------------------------------------------+ | CASE concat('a','b') when concat('ab','') then 'a' when 'b' then 'b' end | +--------------------------------------------------------------------------+ | a | +--------------------------------------------------------------------------+ 1 row in set (0.01 sec) obclient>select case when 1>0 then 'true' else 'false' end; +--------------------------------------------+ | case when 1>0 then 'true' else 'false' end | +--------------------------------------------+ | true | +--------------------------------------------+ 1 row in set (0.00 sec) ~~~ #### IF **聲明** `IF(expr1,expr2,expr3)` **說明** 如果 expr1 的值為 TRUE（即：expr1NULL），返回結果為 expr2; 否則返回結果為 expr3。 IF() 返回結果可以是數值或字符串類型，它取決于使用的內容。如果 expr2, expr3 中只有一個明確是 NULL，則 IF() 函數的結果類型為非 NULL 表達式的結果類型。 **例子** ~~~ obclient>select if(5>6, 'T','F'), if (5>6, 1, 0), if(null, 'True', 'False'), if(0, 'True', 'False')\G * 1. row * if(5>6, 'T','F'): F if (5>6, 1, 0): 0 if(null, 'True', 'False'): False if(0, 'True', 'False'): False 1 row in set (0.01 sec) ~~~ #### IFNULL **聲明** `IFNULL(expr1, expr2)` **說明** 假設 expr1 不為 NULL，則 IFNULL() 的返回值為 expr1; 否則其返回值為 expr2。IFNULL() 的返回值是數值或字符串，具體情況取決于其所使用的語境。 IF() 的默認返回值類型按照以下方式計算： <table data-tag="table" id="table-tn4-2t9-vxa" class="table"><colgroup span="1" width="360" data-tag="col" id="col-0mp-e6m-5yw" colwidth="1*" colnum="1" colname="col1" style="width:50%" class="col"></colgroup><colgroup span="1" width="360" data-tag="col" id="col-3gl-yqx-e5z" colwidth="1*" colnum="2" colname="col2" style="width:50%" class="col"></colgroup><thead id="thead-chx-3d7-y7f" class="thead"><tr id="tr-f3v-4c5-hjn"><th id="td-qiy-5or-jcg">表達式</th><th id="td-zan-hna-z9c">返回值</th></tr></thead><tbody data-tag="tbody" id="tbody-246-6dj-nny" class="tbody"><tr data-tag="tr" id="tr-4pg-e09-f2a" class="tr"><td data-tag="td" id="td-8i9-a0l-q46" class="td">expr1 或 expr2 返回值為一個字符串。</td><td data-tag="td" id="td-0a3-jfc-shg" class="td">字符串</td></tr><tr data-tag="tr" id="tr-3la-lya-nbh" class="tr"><td data-tag="td" id="td-9sf-grq-xcc" class="td">expr1 或 expr2 返回值為一個浮點值。</td><td data-tag="td" id="td-s1y-c9x-k0k" class="td">浮點</td></tr><tr data-tag="tr" id="tr-env-jj1-le7" class="tr"><td data-tag="td" id="td-spx-7e3-zeo" class="td">expr1 或 expr2 返回值為一個整數。</td><td data-tag="td" id="td-nfd-6n6-2dg" class="td">整數</td></tr></tbody></table> 假如 expr1 和 expr2 都是字符串，且其中任何一個字符串區分大小寫，則返回結果是區分大小寫。 **例子** ~~~ obclient>SELECT IFNULL('abc', null), IFNULL(NULL+1, NULL+2), IFNULL(1/0, 0/1); +---------------------+------------------------+------------------+ | IFNULL('abc', null) | IFNULL(NULL+1, NULL+2) | IFNULL(1/0, 0/1) | +---------------------+------------------------+------------------+ | abc | NULL | 0.0000 | +---------------------+------------------------+------------------+ 1 row in set (0.01 sec) ~~~ #### NULLIF **聲明** `NULLIF(expr1, expr2)` **說明** 如果 expr1 = expr2 成立，那么返回值為 NULL，否則返回值為 expr1。這和 CASE WHEN *expr1 = expr2 THEN NULL ELSE expr1 END 相同。注意，如果參數不相等，則兩次求得的值為 expr1。* **例子** ~~~ obclient>SELECT NULLIF('ABC', 123), NULLIF('123',123), NULLIF(NULL, 'abc'); +--------------------+-------------------+---------------------+ | NULLIF('ABC', 123) | NULLIF('123',123) | NULLIF(NULL, 'abc') | +--------------------+-------------------+---------------------+ | ABC | NULL | NULL | +--------------------+-------------------+---------------------+ 1 row in set, 1 warning (0.01 sec) ~~~ #### ORA\_DECODE **聲明** `ora_decode(條件, 值1, 返回值1, 值2, 返回值2, ... 值n, 返回值n, 缺省值)` **說明** ORA\_DECODE() 函數功能等同于 Oracle 的 DECODE() 函數功能。該函數的含義如下: ~~~ IF 條件=值1 THEN RETURN(返回值1) ELSIF 條件=值2 THEN RETURN(返回值2) ...... ELSIF 條件=值n THEN RETURN(返回值n) ELSE RETURN(缺省值) END IF ~~~