<menu id="w2i4a"></menu>

FastReport中文文檔

FastReport.Net
- 用戶指南
- 程序員手冊

文檔首頁>>FastReport中文文檔>>格式化

格式化

Format

Function	Parameters	Return value
Format	string format, params object[] args	string

用指定 "args "數(shù)組中相應(yīng)對象實(shí)例的值替換指定 "format "字符串中的格式項(xiàng)。

例如，下面的函數(shù)調(diào)用

Format("Name = {0}, hours = {1:hh}", myName, DateTime.Now)

包含以下格式項(xiàng)："{0}"和"{1:hh}"。它們將被替換為 myName 和 DateTime.Now 的值。結(jié)果如下：

Name = Alex, hours = 12

每個(gè)格式項(xiàng)目的格式如下：

{index[,alignment][:formatString]}

index - 基于零的整數(shù)，表示要格式化對象列表中的哪個(gè)元素；
alignment - 可選整數(shù)，表示包含格式化值的區(qū)域的最小寬度。如果格式化值的長度小于 alignment，則該區(qū)域?qū)⑻畛淇崭?。如果對齊方式為負(fù)數(shù)，格式化值將在區(qū)域內(nèi)左對齊；如果對齊方式為正數(shù)，格式化值將右對齊；
formatString - 格式指定符的可選字符串。

下表描述了標(biāo)準(zhǔn)數(shù)字格式字符串。

Format Specifier	Name	Description
C or c	Currency	將數(shù)字轉(zhuǎn)換為表示貨幣金額的字符串。Format("{0:C}", 10) ="$10.00"。
D or d	Decimal	該格式僅支持整數(shù)類型。數(shù)字會(huì)轉(zhuǎn)換成一個(gè)十進(jìn)制數(shù)字（0-9）字符串。Format("{0:D}",10)="10
E or e	Scientific	數(shù)字轉(zhuǎn)換為"-d.ddd...E+ddd "或"-d.ddd...e+ddd "形式的字符串，其中每個(gè) "d "表示一位數(shù)字（0-9）。
F or f	Fixed-point	將數(shù)字轉(zhuǎn)換為形式為"-ddd.ddd... "的字符串，其中每個(gè) "d "表示一位數(shù)字（0-9）.Format("{0:F}", 10) = "10.00"
G or g	General	數(shù)字轉(zhuǎn)換為最簡潔的符號.Format("{0:G}", 10) = "10"
N or n	Number	將數(shù)字轉(zhuǎn)換為形式為"-d,ddd,ddd.ddd... "的字符串，其中每個(gè) "d "表示一位數(shù)字（0-9）.Format("{0:N}", 1234.56) = "1,234.56"
P or p	Percent	將數(shù)字轉(zhuǎn)換為表示百分?jǐn)?shù)的字符串。轉(zhuǎn)換后的數(shù)字乘以 100 才能顯示為百分比。
X or x	Hexadecimal	數(shù)字轉(zhuǎn)換為十六進(jìn)制數(shù)字字符串。格式指定符號的大小寫表示對大于 9 的十六進(jìn)制數(shù)字使用大寫還是小寫字符。例如，使用 "X "產(chǎn)生 "ABCDEF"，使用 "x "產(chǎn)生 "abcdef"。

如果對浮點(diǎn)數(shù)值進(jìn)行格式化，可以在格式化字符串后標(biāo)明小數(shù)點(diǎn)位數(shù)：

Format("{0:C1}", 12.23) = "$12.2"

如果標(biāo)準(zhǔn)數(shù)字格式指定符無法提供所需的格式化類型，可以使用自定義格式字符串：

Format character	Description
0	零占位符。如果被格式化的數(shù)值在格式字符串中 "0 "所在的位置有一位數(shù)字，那么該數(shù)字將被復(fù)制到結(jié)果字符串中。小數(shù)點(diǎn)前最左邊的 "0 "和小數(shù)點(diǎn)后最右邊的 "0 "的位置決定了結(jié)果字符串中始終存在的數(shù)字范圍。
#	位數(shù)占位符。如果被格式化的數(shù)值在格式化字符串中出現(xiàn) "#"的位置有數(shù)字，那么該數(shù)字將被復(fù)制到結(jié)果字符串中。否則，結(jié)果字符串中的該位置不會(huì)存儲(chǔ)任何內(nèi)容。
.	小數(shù)點(diǎn)。格式字符串中的第一個(gè)". "字符決定小數(shù)分隔符在格式化值中的位置。
,	千位分隔符。如果格式字符串包含", "字符，則輸出結(jié)果將在小數(shù)分隔符左側(cè)的每組三位數(shù)之間插入千位分隔符。
%	百分比占位符。如果格式字符串中出現(xiàn)"%"字符，則會(huì)在格式化前將數(shù)字乘以 100。
；	分隔符。; "字符用于分隔格式字符串中的正數(shù)、負(fù)數(shù)和零。

使用實(shí)例：

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 值的標(biāo)準(zhǔn)格式指定符：

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"

下表描述了自定義日期/時(shí)間格式指定符及其產(chǎn)生的結(jié)果。

Format Specifier	Description
d	顯示當(dāng)前月份的日期，以 1 至 31（含 31）之間的數(shù)字表示。如果日期僅為個(gè)位數(shù)（1-9），則顯示為個(gè)位數(shù)。
dd	顯示當(dāng)前月份的日期，以 1 到 31（含 31）之間的數(shù)字表示。如果日期僅為個(gè)位數(shù)（1-9），則格式化為前面加 0 (01-09)。
ddd	顯示日的縮寫名稱。
dddd	顯示日期的全稱。
f or F	顯示秒分?jǐn)?shù)的最有效數(shù)字。
h	顯示范圍為 1-12 的小時(shí)。如果小時(shí)是個(gè)位數(shù)（1-9），則顯示為個(gè)位數(shù)。 hh 在 1-12 范圍內(nèi)顯示小時(shí)。如果小時(shí)為個(gè)位數(shù) (1-9)，則以前面的 0 (01-09) 格式顯示。
hh	在 0-23 范圍內(nèi)顯示小時(shí)。如果小時(shí)為個(gè)位數(shù) (1-9)，則顯示為個(gè)位數(shù)。 HH 在 0-23 范圍內(nèi)顯示小時(shí)。如果小時(shí)是個(gè)位數(shù)（1-9），則以前面的 0 格式顯示（01-09）。
H	如果分鐘是個(gè)位數(shù) (0-9)，則顯示為個(gè)位數(shù)。
HH	顯示 0-59 范圍內(nèi)的分鐘。如果分鐘是個(gè)位數(shù) (0-9)，則以前面的 0 (01-09) 格式顯示。
m	顯示范圍為 0-59 的分鐘。如果分鐘是個(gè)位數(shù) (0-9)，則顯示為個(gè)位數(shù)。
mm	顯示月份，以 1 到 12（含 12）之間的數(shù)字表示。如果月份是個(gè)位數(shù) (1-9)，則以前面的 0 格式顯示 (01-09)。
M	顯示月份，以 1 至 12（含 12）之間的數(shù)字表示。如果月份是個(gè)位數(shù)（1-9），則顯示為個(gè)位數(shù)。
MM	顯示月份，以 1 到 12（含 12）之間的數(shù)字表示。如果月份是個(gè)位數(shù) (1-9)，則以前面的 0 格式顯示 (01-09)。
MMM	顯示月份的縮寫名稱。
MMMM	顯示月份的全稱。
s	顯示范圍為 0-59 的秒。如果秒是個(gè)位數(shù) (0-9)，則只顯示個(gè)位數(shù)。
ss	顯示 0-59 范圍內(nèi)的秒。如果秒是個(gè)位數(shù) (0-9)，則以前面的 0 格式顯示 (01-09)。
t	顯示 A.M./P.M. 代號的第一個(gè)字符。
tt	顯示 A.M./P.M. 代號。
y	顯示最大兩位數(shù)的年份。年份的前兩位數(shù)省略。如果年份是個(gè)位數(shù)（1-9），則顯示為個(gè)位數(shù)。
yy	顯示最大兩位數(shù)的年份。省略年份的前兩位數(shù)。如果年份是個(gè)位數(shù) (1-9)，則格式化為前面加 0 (01-09)
yyyy	顯示年份，包括世紀(jì)。如果年份長度小于四位數(shù)，則根據(jù)需要添加前面的零，使顯示的年份長度為四位數(shù)。
z	顯示系統(tǒng)當(dāng)前時(shí)區(qū)的時(shí)區(qū)偏移量，單位僅為整數(shù)小時(shí)。偏移量總是以前導(dǎo)符號顯示（零顯示為 "+0"），表示比格林尼治平均時(shí)間早幾個(gè)小時(shí)（+）或比格林尼治平均時(shí)間晚幾個(gè)小時(shí)（-）。如果偏移量是個(gè)位數(shù)（0-9），則顯示為帶適當(dāng)前導(dǎo)符號的個(gè)位數(shù)。
zz	僅以整數(shù)小時(shí)顯示系統(tǒng)當(dāng)前時(shí)區(qū)的時(shí)區(qū)偏移。偏移量總是以前導(dǎo)符號或后置符號顯示（零顯示為 "+00"），表示比格林尼治平均時(shí)間早幾個(gè)小時(shí)（+）或比格林尼治平均時(shí)間晚幾個(gè)小時(shí)（-）。如果偏移量是個(gè)位數(shù)（0-9），則格式化為前置 0（01-09），并帶有相應(yīng)的前置符號。
zzz	以小時(shí)和分鐘為單位顯示系統(tǒng)當(dāng)前時(shí)區(qū)的時(shí)區(qū)偏移。偏移量總是以前導(dǎo)符號或后置符號顯示（零顯示為 "+00:00"），表示比格林威治平均時(shí)早幾個(gè)小時(shí)（+）或比格林威治平均時(shí)晚幾個(gè)小時(shí)（-）。數(shù)值范圍為 -12:00 至 +13:00。如果偏移量是個(gè)位數(shù)（0-9），則格式化為前置 0（01-09），并帶有適當(dāng)?shù)那皩?dǎo)符號
:	時(shí)間分隔符。
/	日期分隔符。

使用實(shí)例：

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 區(qū)域設(shè)置將指定值格式化為貨幣。

例如

FormatCurrency(1.25) = "$1.25"

Function	Parameters	Return value
FormatCurrency	object value, int decimalDigits	string

將指定的數(shù)值格式化為貨幣。參數(shù) "decimalDigits "表示小數(shù)點(diǎn)右邊顯示的位數(shù)。

例如

FormatCurrency(1.25, 1) = "$1.3"

FormatDateTime

Function	Parameters	Return value
FormatDateTime	DateTime value	string

使用 Windows 區(qū)域設(shè)置將指定值格式化為日期/時(shí)間。此函數(shù)不會(huì)在生成的字符串中包含中性值。

例如

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

使用參數(shù) "format"（格式）中指定的格式，將指定值格式化為日期/時(shí)間。該參數(shù)的有效值為

"長日期”
"短日期”
"長時(shí)間"
"短時(shí)間"

例如

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 區(qū)域設(shè)置將指定值格式化為數(shù)字。

例如

FormatNumber(1234.56) = "1,234.56"

Function	Parameters	Return value
FormatNumber	object value, int decimalDigits	string

將指定數(shù)值格式化為數(shù)字。參數(shù) "decimalDigits "表示小數(shù)點(diǎn)右邊顯示的位數(shù)。

例如

FormatNumber(1234.56, 1) = "1,234.6"

FormatPercent

Function	Parameters	Return value
FormatPercent	object value	string

使用 Windows 區(qū)域設(shè)置將指定值格式化為百分?jǐn)?shù)。

示例

FormatPercent(0.15) = "15.00%"

點(diǎn)擊復(fù)制

Function	Parameters	Return value
FormatPercent	object value, int decimalDigits	string

將指定值格式化為百分?jǐn)?shù)。參數(shù) "decimalDigits "表示小數(shù)點(diǎn)右邊顯示的位數(shù)。

例如

FormatPercent(0.15, 0) = "15%"

如需下載fastreport最新試用版，請點(diǎn)產(chǎn)品名跳轉(zhuǎn)產(chǎn)品下載頁>>

慧都科技版權(quán)所有 Copyright 2003-2024 渝ICP備12000582號-13 渝公網(wǎng)安備 50010702500608號本站由提供CDN加速/云存儲(chǔ)服務(wù)

掃碼咨詢

添加微信立即咨詢

電話咨詢

客服熱線
023-68661681

TOP

三级成人熟女影院,欧美午夜成人精品视频,亚洲国产成人乱色在线观看,色中色成人论坛 (function(){ var bp = document.createElement('script'); var curProtocol = window.location.protocol.split(':')[0]; if (curProtocol === 'https') { bp.src = 'https://zz.bdstatic.com/linksubmit/push.js'; } else { bp.src = 'http://push.zhanzhang.baidu.com/push.js'; } var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(bp, s); })();