格式化
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交談
QQ交談 在線咨詢
在線咨詢 
                 
                
 渝公網安備
            50010702500608號
渝公網安備
            50010702500608號
             
            
 客服熱線
客服熱線