格式化
Format
| Function | Parameters | Return value |
|---|---|---|
| Format | string format, params object[] args | string |
例如，下面的函數調用
Format("Name = {0}, hours = {1:hh}", myName, DateTime.Now)
包含以下格式項："{0}"和"{1:hh}"。它們將被替換為 myName 和 DateTime.Now 的值。結果如下：Name = Alex, hours = 12每個格式項目的格式如下：
{index[,alignment][:formatString]}
- index - 基于零的整數，表示要格式化對象列表中的哪個元素；
- alignment - 可選整數，表示包含格式化值的區域的最小寬度。如果格式化值的長度小于 alignment，則該區域將填充空格。如果對齊方式為負數，格式化值將在區域內左對齊；如果對齊方式為正數，格式化值將右對齊；
- formatString - 格式指定符的可選字符串。
如果對浮點數值進行格式化，可以在格式化字符串后標明小數點位數：
Format Specifier
Name
Description
C or c
Currency
將數字轉換為表示貨幣金額的字符串。Format("{0:C}", 10) ="$10.00"。
D or d
Decimal
該格式僅支持整數類型。數字會轉換成一個十進制數字（0-9）字符串。Format("{0:D}",10)="10
E or e
Scientific
數字轉換為"-d.ddd...E+ddd "或"-d.ddd...e+ddd "形式的字符串，其中每個 "d "表示一位數字（0-9）。
F or f
Fixed-point
將數字轉換為形式為"-ddd.ddd... "的字符串，其中每個 "d "表示一位數字（0-9）.Format("{0:F}", 10) = "10.00"
G or g
General
數字轉換為最簡潔的符號.Format("{0:G}", 10) = "10"
N or n
Number
將數字轉換為形式為"-d,ddd,ddd.ddd... "的字符串，其中每個 "d "表示一位數字（0-9）.Format("{0:N}", 1234.56) = "1,234.56"
P or p
Percent
將數字轉換為表示百分數的字符串。轉換后的數字乘以 100 才能顯示為百分比。
X or x
Hexadecimal
數字轉換為十六進制數字字符串。格式指定符號的大小寫表示對大于 9 的十六進制數字使用大寫還是小寫字符。例如，使用 "X "產生 "ABCDEF"，使用 "x "產生 "abcdef"。
Format("{0:C1}", 12.23) = "$12.2"
如果標準數字格式指定符無法提供所需的格式化類型，可以使用自定義格式字符串：
使用實例：
Format character
Description
0
零占位符。如果被格式化的數值在格式字符串中 "0 "所在的位置有一位數字，那么該數字將被復制到結果字符串中。小數點前最左邊的 "0 "和小數點后最右邊的 "0 "的位置決定了結果字符串中始終存在的數字范圍。
#
位數占位符。如果被格式化的數值在格式化字符串中出現 "#"的位置有數字，那么該數字將被復制到結果字符串中。否則，結果字符串中的該位置不會存儲任何內容。
.
小數點。格式字符串中的第一個". "字符決定小數分隔符在格式化值中的位置。
,
千位分隔符。如果格式字符串包含", "字符，則輸出結果將在小數分隔符左側的每組三位數之間插入千位分隔符。
%
百分比占位符。如果格式字符串中出現"%"字符，則會在格式化前將數字乘以 100。
；
分隔符。; "字符用于分隔格式字符串中的正數、負數和零。
Format("{0:$#,##0.00}", 1024.25) = "$1,024.25"
Format("{0:00%}", 0.25) = "25%"
Format("{0:$#,##0.00;($#,##0.00);Zero}", 1024.25) = "$1,024.25"
Format("{0:$#,##0.00;($#,##0.00);Zero}", -1024.25) = "($1,024.25)"
Format("{0:$#,##0.00;($#,##0.00);Zero}", 0) = "Zero"
下表描述了格式化 DateTime 值的標準格式指定符：
下表描述了自定義日期/時間格式指定符及其產生的結果。
Format Specifier
Name
Example
d
Short date pattern
"8/9/2009"
D
Long date pattern
"Sunday, August 09, 2009"
f
Full date/time pattern (short time)
"Sunday, August 09, 2009 2:44 PM"
F
Full date/time pattern (long time)
"Sunday, August 09, 2009 2:44:01 PM"
g
General date/time pattern (short time)
"8/9/2009 2:44 PM"
G
General date/time pattern (long time)
"8/9/2009 2:44:01 PM"
t
Short time pattern
"2:44 PM"
T
Long time pattern
"2:44:01 PM"
使用實例：
Format Specifier
Description
d
顯示當前月份的日期，以 1 至 31（含 31）之間的數字表示。如果日期僅為個位數（1-9），則顯示為個位數。
dd
顯示當前月份的日期，以 1 到 31（含 31）之間的數字表示。如果日期僅為個位數（1-9），則格式化為前面加 0 (01-09)。
ddd
顯示日的縮寫名稱。
dddd
顯示日期的全稱。
f or F
顯示秒分數的最有效數字。
h
顯示范圍為 1-12 的小時。如果小時是個位數（1-9），則顯示為個位數。
hh 在 1-12 范圍內顯示小時。如果小時為個位數 (1-9)，則以前面的 0 (01-09) 格式顯示。
hh
在 0-23 范圍內顯示小時。如果小時為個位數 (1-9)，則顯示為個位數。
HH 在 0-23 范圍內顯示小時。如果小時是個位數（1-9），則以前面的 0 格式顯示（01-09）。
H
如果分鐘是個位數 (0-9)，則顯示為個位數。
HH
顯示 0-59 范圍內的分鐘。如果分鐘是個位數 (0-9)，則以前面的 0 (01-09) 格式顯示。
m
顯示范圍為 0-59 的分鐘。如果分鐘是個位數 (0-9)，則顯示為個位數。
mm
顯示月份，以 1 到 12（含 12）之間的數字表示。如果月份是個位數 (1-9)，則以前面的 0 格式顯示 (01-09)。
M
顯示月份，以 1 至 12（含 12）之間的數字表示。如果月份是個位數（1-9），則顯示為個位數。
MM
顯示月份，以 1 到 12（含 12）之間的數字表示。如果月份是個位數 (1-9)，則以前面的 0 格式顯示 (01-09)。
MMM
顯示月份的縮寫名稱。
MMMM
顯示月份的全稱。
s
顯示范圍為 0-59 的秒。如果秒是個位數 (0-9)，則只顯示個位數。
ss
顯示 0-59 范圍內的秒。如果秒是個位數 (0-9)，則以前面的 0 格式顯示 (01-09)。
t
顯示 A.M./P.M. 代號的第一個字符。
tt
顯示 A.M./P.M. 代號。
y
顯示最大兩位數的年份。年份的前兩位數省略。如果年份是個位數（1-9），則顯示為個位數。
yy
顯示最大兩位數的年份。省略年份的前兩位數。如果年份是個位數 (1-9)，則格式化為前面加 0 (01-09)
yyyy
顯示年份，包括世紀。如果年份長度小于四位數，則根據需要添加前面的零，使顯示的年份長度為四位數。
z
顯示系統當前時區的時區偏移量，單位僅為整數小時。偏移量總是以前導符號顯示（零顯示為 "+0"），表示比格林尼治平均時間早幾個小時（+）或比格林尼治平均時間晚幾個小時（-）。如果偏移量是個位數（0-9），則顯示為帶適當前導符號的個位數。
zz
僅以整數小時顯示系統當前時區的時區偏移。偏移量總是以前導符號或后置符號顯示（零顯示為 "+00"），表示比格林尼治平均時間早幾個小時（+）或比格林尼治平均時間晚幾個小時（-）。如果偏移量是個位數（0-9），則格式化為前置 0（01-09），并帶有相應的前置符號。
zzz
以小時和分鐘為單位顯示系統當前時區的時區偏移。偏移量總是以前導符號或后置符號顯示（零顯示為 "+00:00"），表示比格林威治平均時早幾個小時（+）或比格林威治平均時晚幾個小時（-）。數值范圍為 -12:00 至 +13:00。如果偏移量是個位數（0-9），則格式化為前置 0（01-09），并帶有適當的前導符號
:
時間分隔符。
/
日期分隔符。
Format("{0:d MMM yyyy}", DateTime.Now) = "9 Aug 2009"
Format("{0:MM/dd/yyyy}", DateTime.Now) = "08/09/2009"
Format("{0:MMMM, d}", DateTime.Now) = "August, 9"
Format("{0:HH:mm}", DateTime.Now) = "16:07"
Format("{0:MM/dd/yyyy hh:mm tt}", DateTime.Now) = "08/09/2009 04:07 PM"
FormatCurrency
| Function | Parameters | Return value |
|---|---|---|
| FormatCurrency | object value | string |
使用 Windows 區域設置將指定值格式化為貨幣。
例如
FormatCurrency(1.25) = "$1.25"
| Function | Parameters | Return value |
|---|---|---|
| FormatCurrency | object value, int decimalDigits | string |
將指定的數值格式化為貨幣。參數 "decimalDigits "表示小數點右邊顯示的位數。
例如
FormatCurrency(1.25, 1) = "$1.3"
FormatDateTime
| Function | Parameters | Return value |
|---|---|---|
| FormatDateTime | DateTime value | string |
使用 Windows 區域設置將指定值格式化為日期/時間。此函數不會在生成的字符串中包含中性值。
例如
FormatDateTime(#1/1/2009#) = "01/01/2009" FormatDateTime(#1/1/2009 1:30#) = "01/01/2009 1:30:00 AM" FormatDateTime(#1:30#) = "1:30:00 AM"
| Function | Parameters | Return value |
|---|---|---|
| FormatDateTime | DateTime value, string format | string |
使用參數 "format"（格式）中指定的格式，將指定值格式化為日期/時間。該參數的有效值為
- "長日期”
- "短日期”
- "長時間"
- "短時間"
FormatDateTime(#1/1/2009 1:30#, "Long Date") = "Thursday, January 01, 2009" FormatDateTime(#1/1/2009#, "Short Date") = "01/01/2009" FormatDateTime(#1:30#, "Short Time") = "01:30 AM" FormatDateTime(#1:30#, "Long Time") = "1:30:00 AM"
FormatNumber
| Function | Parameters | Return value |
|---|---|---|
| FormatNumber | object value | string |
使用 Windows 區域設置將指定值格式化為數字。
例如
FormatNumber(1234.56) = "1,234.56"
| Function | Parameters | Return value |
|---|---|---|
| FormatNumber | object value, int decimalDigits | string |
將指定數值格式化為數字。參數 "decimalDigits "表示小數點右邊顯示的位數。
例如
FormatNumber(1234.56, 1) = "1,234.6"
FormatPercent
| Function | Parameters | Return value |
|---|---|---|
| FormatPercent | object value | string |
示例
FormatPercent(0.15) = "15.00%"
點擊復制
| Function | Parameters | Return value |
|---|---|---|
| FormatPercent | object value, int decimalDigits | string |
例如
FormatPercent(0.15, 0) = "15%"
如需下載fastreport最新試用版，請點產品名跳轉產品下載頁>>
QQ交談
在線咨詢
渝公網安備
50010702500608號
客服熱線