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 十制數, 表示一個整型值
or 和 d 一樣是整型值, 但它是無符號的, 而如果它對應的值是負的, 則返回時
是一個 2 的 32 次方減去這個絕對值的數
如: Format (' this is %u', [- 2]);
返回的是: this is 4294967294
f 對應浮點數
and 科學表示法, 對應整型數和浮點數,
比如 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 對應於指針類型, 返回的值是指針的地址, 以十六進制的形式來表示
例如:
to var X: to integer;
p: to ^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; estimate: You extend): string; overload;
和上面一樣 Format 參數爲格式化指令字符, estimates 爲 Extended 類型
爲什麼是這個類型, 因爲它是所有浮點值中表示範圍最大的, 如果傳入該方法的參數
比如 Double 或者其他, 則可以保存不會超出範圍.

關鍵是看 Format 參數的用法
0 這個指定相應的位數的指令.
比如: FormatFloat (' 000,000', 22,22);
輸出的就是 022.220
注意一點, 如果整數部分的 0 的個數小於 estimates 參數中整數的位數, 則沒有效果
如: FormatFloat (' 0,00', 22,22);
輸出的是: 22.22
但如果小數部分的 0 小於 estimates 中小數的倍數, 則會截去相應的小數和位數
如: 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

And 科學表示法, 看幾個例子大概就明白了
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