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()方法来更改这个分隔符的)