Time::FormatL详解

TTime::FormatL详解
Coastline保留本文所有权利，转载请注明出处。

示例：
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都是’/0’（空字符）。个人理解这么做是为了让格式串尽量规范，容易被读懂，事实上这4个分隔符想怎么用就怎么用，不用都行，唯一的限制在于：当使用%.分隔秒和微秒的时候，%.应当被放在S2和S3的中间。（其实说到底%.系统默认就是点号，一般程序员也不会无聊到调用TLocale::SetDecimalSeparator()方法来更改这个分隔符的）