FormatSQL

核心提示：在一些论坛，常看到有人拼接SQL的时候，喜欢直接硬拼，结果就是出现一大堆加号和单引号，不仅写起来麻烦（你得小心该连续写多少个单引号），SQL的可读性也相当差。...稍微好一点的方法是，使用QuotedStr函数，这个函数用于输出一个单引号括着的字符串。我相信写“'Insert into table(a,b,c) values(' + QuotedStr('ET') + ',' + QuotedStr('OTL') + ',' + QuotedStr('ORZ') + ')'”，总比你写“'Insert into table(a,b) values(' + ''''ET'''' + ',' + ''''OTL'''' + ',' + ''''ORZ'''' + ')'”可读性要强些吧，这么多引号看着都烦，别说写了。
更好的方法是使用Format函数。此函数一定要多多善用，通过格式化字符串的办法，可大大提高语句的可读性；而且格式化控制符有数字型也有字符串型，免除了你一会IntToStr，一会又StrToInt的痛苦。
以上SQL的等效写法是“Format('Insert into table(a,b,c) values(%s,%s,%s)', [QuoteStr('ET'), QuotedStr('OTL'), QuotedStr('ORZ')])”。
 本文到此还没结束，大家是否觉得尽管Format能大大提高了语句的可读性，但是写带单引号的字符串时，仍然比较麻烦呢？
no problem，其实我们稍稍"扩充"下Format语句就行了： function FormatSQL(const AFormat: string; const Args: array of const): string; 
begin result := Format(StringReplace(AFormat, '%q', QuotedStr('%s'), [rfReplaceAll, rfIgnoreCase]), Args); end;
 以上SQL的等效写法为“FormatSQL('Insert into table(a,b,c) values(%q,%q,%q)', ['ET', 'OTL', 'ORZ'])”。应该算是比较方便了，我觉得。顶一下

一、Format函数的用法
Format是一个很常用，却又似乎很烦的方法，本人试图对这个方法的帮助进行一些翻译，让它有一个完整的概貌，以供大家查询之用：

首先看它的声明：
function Format(const Format: string; const Args: array of const): string; overload;
事实上Format方法有两个种形式，另外一种是三个参数的，主要区别在于它是线程安全的，但并不多用，所以这里只对第一个介绍：

function Format(const Format: string; const Args: array of const): string; overload;
Format参数是一个格式字符串，用于格式化Args里面的值的。Args又是什么呢，它是一个变体数组，即它里面可以有多个参数，而且每个参数可以不同。
如以下例子：
Format('my name is %6s',['wind']);
返回后就是
my name is wind

现在来看Format参数的详细情况：
Format里面可以写普通的字符串，比如'my name is' 但有些格式指令字符具有特殊意义，比如"%6s"

格式指令具有以下的形式：
"%" [index ":"] ["-"] [width] ["." prec] type
它是以"%"开始,而以type结束，type表示一个具体的类型。中间是用来格式化type类型的指令字符，是可选的。

先来看看type,type可以是以下字符：
d 十制数，表示一个整型值
u 和d一样是整型值，但它是无符号的，而如果它对应的值是负的，则返回时是一个2的32次方减去这个绝对值的数
如：Format('this is %u',[－2]);
返回的是：this is 4294967294
f 对应浮点数
e 科学表示法，对应整型数和浮点数，
比如Format('this is %e',[-2.22]);
返回的是：this is -2.22000000000000E+000
等一下再说明如果将数的精度缩小
g 这个只能对应浮点型，且它会将值中多余的数去掉
比如Format('this is %g',[02.200]);
返回的是：this is 2.2
n 只能对应浮点型，将值转化为号码的形式。看一个例子就明白了
Format('this is %n',[4552.2176]);
返回的是this is 4,552.22
注意有两点，一是只表示到小数后两位，等一下说怎么消除这种情况
二是，即使小数没有被截断，它也不会也像整数部分一样有逗号来分开的
m 钱币类型，但关于货币类型有更好的格式化方法，这里只是简单的格式化
另外它只对应于浮点值
Format('this is %m',[9552.21]);
返回：this is ￥9,552.21
p 对应于指针类型，返回的值是指针的地址，以十六进制的形式来表示
例如：
var X:integer;
p:^integer;
begin
X:=99;
p:=@X;
Edit1.Text:=Format('this is %p',[p]);
end;
Edit1的内容是：this is 0012F548
s 对应字符串类型，不用多说了吧
x 必须是一个整形值，以十六进制的形式返回
Edit1.Text:=Format('this is %X',[15]);
返回是：this is F

类型讲述完毕，下面介绍格式化Type的指令：
[index ":"] 这个要怎么表达呢，看一个例子
Format('this is %d %d',[12,13]);
其中第一个%d的索引是0，第二个%d是1，所以字符显示的时候
是这样 this is 12 13

而如果你这样定义：
Format('this is %1:d %0:d',[12,13]);
那么返回的字符串就变成了
this is 13 12
现在明白了吗，[index ":"] 中的index指示Args中参数显示的
顺序

还有一种情况，如果这样Format('%d %d %d %0:d %d', [1, 2, 3, 4])
将返回1 2 3 1 2。
如果你想返回的是1 2 3 1 4，必须这样定：
Format('%d %d %d %0:d %3:d', [1, 2, 3, 4])
但用的时候要注意，索引不能超出Args中的个数，不然会引起异常
如Format('this is %2:d %0:d',[12,13]);
由于Args中只有12 13 两个数，所以Index只能是0或1，这里为2就错了
[width] 指定将被格式化的值占的宽度，看一个例子就明白了
Format('this is %4d',[12]);
输出是：this is 12
这个是比较容易，不过如果Width的值小于参数的长度，则没有效果。
如：Format('this is %1d',[12]);
输出是：this is 12
["-"] 这个指定参数向左齐，和[width]合在一起最可以看到效果：
Format('this is %-4d,yes',[12]);
输出是：this is 12 ,yes

["." prec] 指定精度，对于浮点数效果最佳：
Format('this is %.2f',['1.1234]);
输出 this is 1.12
Format('this is %.7f',['1.1234]);
输了 this is 1.1234000

而对于整型数，如果prec比如整型的位数小，则没有效果反之比整形值的位数大，则会在整型值的前面以0补之
Format('this is %.7d',[1234]);
输出是：this is 0001234]

对于字符型，刚好和整型值相反，如果prec比字符串型的长度大则没有效果，反之比字符串型的长度小，则会截断尾部的字符
Format('this is %.2s',['1234']);
输出是 this is 12

而上面说的这个例子：
Format('this is %e',[-2.22]);
返回的是：this is -2.22000000000000E+000
怎么去掉多余的0呢，这个就行啦
Format('this is %.2e',[-2.22]);

二 FormatDateTime的用法
他的声明为：
function FormatDateTime(const Format: string; DateTime: TDateTime): string; overload;
当然和Format一样还有一种，但这里只介绍常用的第一种
Format参数是一个格式化字符串。DateTime是时间类型。返回值是一种格式化后的字符串

重点来看Format参数中的指令字符
c 以短时间格式显示时间，即全部是数字的表示
FormatdateTime('c',now);
输出为：2004-8-7 9:55:40
d 对应于时间中的日期，日期是一位则显示一位，两位则显示两位
FormatdateTime('d',now);
输出可能为1～31
dd 和d的意义一样，但它始终是以两位来显示的
FormatdateTime('dd',now);
输出可能为01～31
ddd 显示的是星期几
FormatdateTime('ddd',now);
输出为: 星期六
dddd 和ddd显示的是一样的。
但上面两个如果在其他国家可能不一样。
ddddd 以短时间格式显示年月日
FormatdateTime('ddddd',now);
输出为：2004-8-7
dddddd 以长时间格式显示年月日
FormatdateTime('dddddd',now);
输出为：2004年8月7日
e/ee/eee/eeee 以相应的位数显示年
FormatdateTime('ee',now);
输出为：04 （表示04年）
m/mm/mmm/mmmm 表示月
FormatdateTime('m',now);
输出为：8
FormatdateTime('mm',now);
输出为 08
FormatdateTime('mmm',now);
输出为 八月
FormatdateTime('mmmm',now);
输出为 八月
和ddd/dddd 一样，在其他国家可能不同
yy/yyyy 表示年
FormatdateTime('yy',now);
输出为 04
FormatdateTime('yyyy',now);
输出为 2004
h/hh,n/nn,s/ss,z/zzz 分别表示小时，分，秒,毫秒
t 以短时间格式显示时间
FormatdateTime('t',now);
输出为 10:17
tt 以长时间格式显示时间
FormatdateTime('tt',now);
输出为10:18:46
ampm 以长时间格式显示上午还是下午
FormatdateTime('ttampm',now);
输出为：10:22:57上午

大概如此，如果要在Format中加普通的字符串，可以用双引号隔开那些特定义的字符，这样普通字符串中如果含特殊的字符就不会被显示为时间格式啦：
FormatdateTime('"today is" c',now);
输出为：today is 2004-8-7 10:26:58
时间中也可以加"-"或"/"来分开日期：
FormatdateTime('"today is" yy-mm-dd',now);
FormatdateTime('"today is" yy/mm/dd',now);
输出为： today is 04-08-07
也可以用":"来分开时间
FormatdateTime('"today is" hh:nn:ss',now);
输出为：today is 10:32:23

三.FormatFloat的用法

常用的声明：
function FormatFloat(const Format: string; Value: Extended): string; overload;
和上面一样Format参数为格式化指令字符，Value为Extended类型为什么是这个类型，因为它是所有浮点值中表示范围最大的，如果传入该方法的参数比如Double或者其他，则可以保存不会超出范围。

关键是看Format参数的用法
这个指定相应的位数的指令。
比如：FormatFloat('000.000',22.22);
输出的就是022.220
注意一点，如果整数部分的0的个数小于Value参数中整数的位数，则没有效果
如：FormatFloat('0.00',22.22);
输出的是：22.22
但如果小数部分的0小于Value中小数的倍数，则会截去相应的小数和位数
如：FormatFloat('0.0',22.22);
输出的是：22.2

也可以在整数0中指定逗号，这个整数位数必须大于3个，才会有逗号出现
FormatFloat('0,000.0',2222.22);
输出是：2,222.2
如果这样FormatFloat('000,0.0',2222.22);
它的输出还是：2,222.2
注意它的规律

# 和0的用法一样，目前我还没有测出有什么不同。
FormatFloat('##.##',22.22);
输出是：22.00

E 科学表示法，看几个例子大概就明白了
FormatFloat('0.00E+00',2222.22);
输出是 2.22E+03
FormatFloat('0000.00E+00',2222.22);
输出是 2222.22E+00
FormatFloat('00.0E+0',2222.22);
22.2E+2
明白了吗，全靠E右边的0来支配的