格式化如果全靠程式碼硬湊,不但醜還慢。.NET 的 ToString("格式字串") 與 string.Format() 提供了大量現成寫法,值得整理成速查表。(本文示範為 C#/.NET 語法,JavaScript 需改用 toFixed、Intl.NumberFormat、Intl.DateTimeFormat 等 API。)
| 格式 | 說明 | 範例 |
|---|---|---|
| "C" | 貨幣格式(int / float / double) | 400 → ¥400.00 |
| "D5" | 十進位並補零到 5 位(僅 int) | 400 → 00400 |
| "E" | 科學計數法 | 400 → 4.000000E+002 |
| "F3" | 固定小數位數,F2 為兩位、F 預設兩位 | 400 → 400.000 |
| "N" | 千分位分隔,預設小數兩位,無貨幣符號 | 400000000000 → 400,000,000,000.00 |
| "x" | 十六進位 | 400000000000 → 5d21dba000 |
double d = 400;
d.ToString("C"); // ¥400.00
int i = 400;
i.ToString("D5"); // 00400
float f = 400;
f.ToString("E"); // 4.000000E+002
i.ToString("F3"); // 400.000
400000000000.ToString("N"); // 400,000,000,000.00
400000000000.ToString("x"); // 5d21dba000
C 與 N 的差别就在那個 ¥ 符號,以及 C 會依目前 culture 套用當地貨幣單位。
string.Format("{0:f}", System.DateTime.Now); // 2011年8月4日星期四 11:23
string.Format("{0:F}", System.DateTime.Now); // 2011年8月4日星期四 11:23:53
完整的單字母格式說明符對照:
| 格式符 | 輸出範例 |
|---|---|
| d | 2005-11-5(短日期) |
| D | 2005年11月5日(完整日期) |
| f | 2005年11月5日 14:23(完整日期+短時間) |
| F | 2005年11月5日 14:23:23(完整日期+完整時間) |
| g | 2005-11-5 14:23(短日期+短時間) |
| G | 2005-11-5 14:23:23(短日期+完整時間) |
| M / m | 11月5日(月日) |
| R / r | Sat, 05 Nov 2005 14:23:23 GMT(RFC1123) |
| s | 2005-11-05T14:23:23(可排序 ISO 8601) |
| t | 14:23(短時間) |
| T | 14:23:23(完整時間) |
| u | 2005-11-05 14:23:23Z(通用可排序) |
| U | 2005年11月5日 6:23:23(UTC 完整日期時間) |
| Y / y | 2005年11月(年月) |
如果不想自己指定,可以直接從 DateTime 拿出該 culture 支援的所有格式,挑一個用:
dt.GetDateTimeFormats('s')[0].ToString(); // 2005-11-05T14:06:25
dt.GetDateTimeFormats('t')[0].ToString(); // 14:06
dt.GetDateTimeFormats('y')[0].ToString(); // 2005年11月
dt.GetDateTimeFormats('D')[0].ToString(); // 2005年11月5日
dt.GetDateTimeFormats('D')[2].ToString(); // 星期六 2005 11 05
dt.GetDateTimeFormats('M')[0].ToString(); // 11月5日
dt.GetDateTimeFormats('f')[0].ToString(); // 2005年11月5日 14:06
dt.GetDateTimeFormats('g')[0].ToString(); // 2005-11-5 14:06
dt.GetDateTimeFormats('r')[0].ToString(); // Sat, 05 Nov 2005 14:06:25 GMT
當預設格式都不合用時,可以自由組合:
string.Format("{0:yyyyMMddHHmmssffff}", System.DateTime.Now);
其中 yyyy 為年、MM 為月、dd 為日、HH 為 24 小時制小時、mm 為分、ss 為秒、ffff 為秒的小數四位。注意 MM 與 mm、HH 與 hh 的大小寫差異:前者是月/分、小時,後者才是 12 小時制,這是新手最常出錯的地方。
這份表若日後遇到新的格式需求,可以再往下補充。