TTime::FormatL 详解

示例：

　　TTime time;

　　Time.HomeTime();

　　TBuf<32> timeBuf;

　　time.FormatL(timeBuf,_L(“%F%Y/%M/%D,%H:%T:%S”)); // 2008/08/16,21:22:22

　　详解：

　　格式串分为本地相关和本地无关格式串，也就是说和系统的时间日期中设置的格式是否相关。

　　以下所有格式字符都要加%

　　本地无关：

　　%：因为%是参数字符，所以需要输出%的时候，要用两个连续的%%进行转义

　　*：加在%后，表示需要缩写，比如%*T表示对分钟进行缩写，如果不是两位数，则去掉前导0

　　C：6位的微秒，%C默认是6位的，%*C2表示只取前两位，%*C4则取前4位

　　S：2位的秒，加*去掉前导0

　　T：2位的分，加*去掉前导0

　　H：24小时制的时，加*去掉前导0

　　I：12小时制的时，加不加*都会去掉前导0

　　F：%F参数表示D/M/Y三个参数都是本地无关的，按照格式串原样输出，%F需要用在%D、%M、%Y之前

　　D：2位的日，加*去掉前导0

　　M：2位的月，加*去掉前导0

　　Y：4位的年，加*去掉前两个数字，比如2008只显示08

　　E：星期，英文环境下，Sunday~Saturday，加*显示缩写，Sun~Sat;中文环境下，星期一~星期日，加*显示缩写，一~日

　　N：月的名称，英文环境下，January~December，加*显示缩写，Jan~Dec;中文环境下，1月~12月，加*显示缩写，阿拉伯数字 1~12。注意1月~12月数字都是阿拉伯数字，而不是汉字一~十二

　　W：2位数字，当前日期处于一年中的第几周，加*去掉前导0

　　X：日期后缀。例如%*D%X显示形如3rd(三号)，%D%X显示形如02nd(二号)

　　Z：3位数字，当前日期处于一年中的第几天，加*去掉前导0

　　本地相关：

　　.：(点号)%.默认是小数点，表示分隔秒与毫秒之间的字符。可以通过TLocale::SetDecimalSeparator()设定。

　　:：(冒号)%:表示获取本地设置中的时间分隔符，紧跟一个0~3范围的数字来指定哪一个日期分隔符。

　　格式如下：S0 XX S1 YY S2 ZZ S3，其中XX、YY、ZZ代表时分秒，S0~S3代表4个分隔符。%:0表示第一个分隔符，依此类推。需要注意的是，本地设置中的时间分隔符只提供冒号和点号两种字符。当然，可以通过TLocale:: SetTimeSeparator()对4个分隔符进行设置，模拟器和真机都未试验成功，待机状态的时间分隔符未更改。

         /：(斜杠)%/表示获取本地设置中的日期分隔符，和上面一条类似。XX、YY、ZZ代表年月日，其顺序可以通过TLocale:: SetDateFormat()设置。对于分隔符，本地设置中提供4种字符以供选择，不过只对S1和S2有效，S0和S3总是空字符。通过 SetDateSeparator()可以对4个分隔符S0~S3进行分别设定，且可以是不同的，在模拟器和真机上都试验成功，待机状态的日期分隔符被成功修改，但是进入系统的时间日期设定时，模拟器和真机均崩溃。

　　1：%1，本地设置中“年月日”顺序中的第一个。年月日顺序可以通过TLocale::SetDateFormat()进行设定，格式如下：

　　EDateAmerican US format (mm/dd/yyyy) 此时%1是月

　　EDateEuropean European format (dd/mm/yyyy) 此时%1是日

　　EDateJapanese Japanese format (yyyy/mm/dd) 此时%1是年

　　中国习惯上采用小日本格式

　　2：%2，本地设置中“年月日”顺序中的第二个。

　　3：%3，本地设置中“年月日”顺序中的第三个。

　　4：%4，和%2冗余，本地设置中是EDateAmerican的话，%4是日;EDateEuropean、EDateJapanese的%4是月

　　5：%5，和%3冗余，本地设置中是EDateAmerican、EDateEuropean的话，%4是年;EDateJapanese的%4是日

　　所以，在本地相关的格式串中(没有%F参数)，调用年月日可以直接使用%1%2%3即可，无需加上%M%D%Y(一般在需要去掉前导0的时候才需要加上 %*M%*D%*Y)，分隔符全部使用%/1即可(因为本地的设置中只有S1和S2有效，并且是相同的)，当然年月日顺序是个问题，如果需要指定顺序，那肯定用%F的本地无关格式串了，那样简单直观地多，格式串也不容易写错。

　　A：不管本地设置中是12小时制还是24小时制，%A表示am/pm总是显示。TLocale:: SetAmPmSpaceBetween()这个方法用来设置是否在时间和am/pm中间留有空格，显然这个设置会影响到最终格式化后的字符串。%*A会强制压缩这个空格，不管本地是否设置了空格(需要注意的是，这里提到的本地设置，不一定在系统的时间日期中有设置选项，因为对于用户而言，只需要设定常用的几个设置即可，比如这个AmPmSpaceBetween空格，在时间日期中就没有设置选项，系统默认是有空格的)。至于格式化后的字符串中am/pm 出现在时间的前面还是后面，就要看格式串怎么写了：%I:%T:%S%A，显示10:21:36 pm，%A%I:%T:%S，显示pm 10:21:36

　　A的扩展选项：

        在A前面可以加上+或者-，

　　%+A表示只有TLocale:: AmPmSymbolPosition()被设置为ELocaleAfter时，才往格式化后的字符串中插入am/pm;

　　%-A表示只有TLocale:: AmPmSymbolPosition()被设置为ELocaleBefore时，才往格式化后的字符串中插入am/pm。

　　很显然TLocale:: AmPmSymbolPosition()这个设置在时间日期设置中也是没有的。

　　eg：%-A%I:%T:%S%+A这个串格式化之后的字符串中am/pm出现的位置和设定中的一致。

　　%-A%I:%T:%S%则表示只有设定了am/pm标志在前的情况下，am/pm才被插入到格式化后的字符串的开头。

　　B：和A唯一的区别就是只有在12小时制情况下才显示am/pm。同样也有%-B、%+B两种扩展选项。

　　J：判断本地设置是12小时制还是24小时制。%J表示本地设置是12小时制的情况下，在%J之后出现的前导0都被强制去除，所以有了%J参数，没有必要再加*号。

　　注意点：

　　使用%F表示本地无关时，不能使用%1~%5参数

　　不使用%F参数时，%M、%D、%Y参数不起任何作用，但是%*M、%*D、%*Y起到去除前导0(%*Y是取2位数年份)的作用

　　SDK中指出：当使用%/0、%/1、%/2、%/3分隔%1~%5代表的日期的时候(或者使用%:0、%:1、%:2、%:3分隔%H、%I、%T、 %S代表的时间的时候)，4个分隔符都要被指定，尽管系统默认S0和S3都是’’(空字符)。个人理解这么做是为了让格式串尽量规范，容易被读懂，事实上这4个分隔符想怎么用就怎么用，不用都行，唯一的限制在于：当使用%.分隔秒和微秒的时候，%.应当被放在S2和S3的中间。(其实说到底%.系统默认就是点号，一般程序员也不会无聊到调用TLocale::SetDecimalSeparator()方法来更改这个分隔符的)