日期、時間、編號和其他格式

將月份中的日期表示為 1 到 31 之間的數字：27。

一位數的日期格式不帶前置零：3。

如果單獨使用，首碼為 %。

將月份中的日期表示為 01 到 31 之間的兩位數字：27。

一位數的日期格式帶前置零：03。

將月份表示為 1 到 12 的數字：11。

一位數的月份格式不帶前置零：5。

如果單獨使用，首碼為 %。

將月份表示為 01 到 12 的兩位數字：11。

一位數的月份格式帶前置零：05。

將年份表示為一位數或兩位數：23。

如果年份超過兩位數，則結果中只會出現兩位低位數。例如，給定 2023 年，出現 23。

如果兩位數年份的第一個數位以零開頭（例如 02），則該數字的格式不帶前置零：2。

將年份表示為兩位數：23。

如果年份超過兩位數，則結果中只會出現兩位低位數。例如，給定 2023 年，出現 23。

如果兩位數年份少於兩位有效數位，則用前置零填充該數字使之達到兩位數：02。

如果單獨使用，首碼為 %。

用最少三位數表示年份：2023。

如果年份的有效數位超過三位，則其會包含在結果字串中。如果年份的有效數位少於三位，則用前置零填充該數字使之達到三位數。

備註：對於年份可以為五位數的泰國佛歷，此格式指定元會顯示所有五位數。

將年份表示為四位數：2023。

如果年份超過四位數，則結果中只會出現四位低位數。如果年份少於四位數，則用前置零填充該數字使之達到四位數。

備註：對於年份可以為五位數的泰國佛歷，此格式指定元會顯示所有五位數。

將年份表示為五位數。

如果年份超過五位數，則結果中只會出現五位低位數。如果年份少於五位數，則用前置零填充該數字使之達到五位數：02023。

若存在超過五個 y 指定元，則用所需數量的前置零填充該數字，使之達到 y 指定元的數量。例如，如果有 8 個指定元，則輸出為 00002023。

表示時期或紀元，例如 A.D。若要格式化的日期沒有關聯的時期或紀元字串，則格式化會忽略此指定元。

無法單獨使用單個 g。如果您只想輸出紀元或時期的名稱，請使用雙 gg。

將小時表示為 12 小時制從 1 到 12 的數字，從午夜或中午開始對整小時計數。

午夜之後的特定小時與中午之後的同一小時無法加以區分。例如，1:00 AM 與 1:00 PM 相同。

小時不進行捨入，一位數的小時格式不帶前置零。

如果單獨使用，首碼為 %。

例如，在時間為 5:43 時，此自訂格式指定元顯示 5。

將小時表示為 12 小時制從 01 到 12 的兩位數字，從午夜或中午開始對整小時計數。

午夜之後的特定小時與中午之後的同一小時無法加以區分。例如，1:00 AM 與 1:00 PM 相同。

小時不進行捨入，一位數的小時格式帶有前置零。

例如，在時間為 5:43 時，此自訂格式指定元顯示 05。

將小時表示為 24 小時制從 0 到 23 的數字，從午夜開始對小時計數。

一位數的小時格式不帶前置零。

例如，在時間為 5:43 PM 時，此自訂格式指定元顯示 17。

如果單獨使用，首碼為 %。

將小時表示為 24 小時制從 00 到 23 的兩位數字，從午夜開始對小時計數。

一位數的小時格式帶有前置零。

例如，在時間為 5:43 PM 時，此自訂格式指定元顯示 17。

將分鐘表示為 0 到 59 的數字。

分鐘表示自上一小時以來經過的整分鐘數。一位數的分鐘格式不帶前置零。

例如，在時間為 5:43:34 時，此自訂格式指定元顯示 43。

如果單獨使用，首碼為 %。

將分鐘表示為 00 到 59 的兩位數字。

分鐘表示自上一小時以來經過的整分鐘數。一位數的分鐘格式帶有前置零。

例如，在時間為 5:03:34 時，此自訂格式指定元顯示 03。

將秒表示為 0 到 59 的數字。

結果表示自上一分鐘以來經過的整秒數。一位數的秒格式不帶前置零。

例如，在時間為 5:43:04 時，此自訂格式指定元顯示 4。

如果單獨使用，首碼為 %。

將秒表示為 00 到 59 的兩位數字。

結果表示自上一分鐘以來經過的整秒數。一位數的秒格式帶有前置零。

例如，在時間為 5:43:04 時，此自訂格式指定元顯示 04。

代表秒小數的位數。小寫 f 指定元包含尾數零。大寫 F 指定元會去掉尾數零。

此指定元僅適用於 OLE 自動化 一種將日期寫成浮點整數的方法。表示自 1899 年 12 月 30 日以來的天數。日期/時間。

f 或 F 字元數決定了要包括秒小數的多少個有效數位：

• F：十分之一秒，或最高位。如果數位為零，則不顯示任何內容。
• ff 或 FF：百分之一秒，或兩個有效數位。
• fff 或 FFF：千分之一秒，或三個有效數位。這就是所謂的毫秒。
• ffff或FFFF：萬分之一秒，或四個有效數位。
• fffff 或 FFFFF：十萬分之一秒，或五個有效數位。
• ffffff 或 FFFFFF：百萬分之一秒，或六個有效數位。
• FFFFFFF：千萬分之一秒，或七個有效數位。

指定的精度越高，其可靠性或意義就越低。時間值的精度取決於電腦系統時鐘的解析度。

表示 AM/PM 指示項的第一個字元。若正在格式化的時間中的小時數小於 12，則使用 AM 指示項。否則，使用 PM 指示項。

對於使用 AM/PM 指示的語言，如果第一個字元相同，而第二個字元有變化，則使用 tt 指定元。

如果單獨使用，首碼為 %。

表示 AM/PM 指示項。若正在格式化的時間中的小時數小於 12，則使用 AM 指示項。否則，使用 PM 指示項。

對於使用 AM/PM 指示項的語言，如果第一個字元相同，而第二個字元有變化（例如日語），則使用 tt 指定元。

表示本機作業系統時區與協調世界時間 (UTC) 的帶符號偏移量，測量單位為小時。Z 字元數定義了要顯示的偏移量：

• z， zz：以 小時為單位測量偏移量。
• zzz：以小時和分鐘為單位測量偏移量。

偏移量始終以前置符號顯示。正號 (+) 表示小時數早於 UTC，負號 (-) 表示小時數遲於 UTC。偏移範圍為 –12 到 +13。一位數的偏移量格式帶有前置零。

如果單獨使用，首碼為 %。

該數字已被轉換為代表貨幣金額的字串。包括一個帶有格式指定元的數字，表示您希望該數字具有的小數位數。格式指定元的大小寫不影響結果。

ASSIGN StringVal = "0013001.93912837"
ASSIGN CurrencyResult = "{StringVal.format('C')}"
ASSIGN CurrencyResult3 = "{StringVal.format('C3')}"

結果：

CURRENCYRESULT=$13,001.94

CURRENCYRESULT3=$13,001.939

E0

E-0

e0

e+0

e-0

該數字將轉換 -d.ddd…E+ddd 或 -d.ddd…e+ddd 形式的字串，其中每個 d 表示一個數位 (0-9)。若數字為負數，則字串以負號作為開頭。小數點前面總有一位數位。

包括一個帶有格式指定元的數字，表示您希望的小數點後位數。如果不包括精度指定元，則指令碼預設為六位小數。

格式指定元的大小寫表示輸出中的指數是用 E 或 e 作為首碼。指數始終由正號或負號以及最少三位數組成。若需要，則用零填充指數，以滿足這一最低要求。

如果字串 E、E+、E-、e、e+ 或 e- 中的任何一個出現在格式字串中，並且其後緊跟至少一個 0 字元，則使用科學標記法對數字進行格式化，並在數字和指數之間插入 E 或 e。

科學標記法指示器後面的 0 字元數決定了指數輸出的最小位數。E+ 和 e+ 格式表示符號字元（正號或負號）應始終位於指數之前。E、E-、e 或 e- 格式表示符號字元應該只在負指數之前。

 ASSIGN StringVal = "0013001.93912837"
ASSIGN ScientificResult = "{StringVal.format('e')}"		
ASSIGN ScientificResult = "{StringVal.format('E2')}"	

結果：

SCIENTIFICRESULT=1.300194e+004

SCIENTIFICRESULT2=1.300194E+004

該數字將轉換 -ddd.ddd… 形式的字串，其中每個 d 表示一個數位 (0-9)。若數字為負數，則字串以負號作為開頭。

包括一個帶有格式指定元的數字，表示您希望該結果具有的小數位數。如果沒有精度指示器，則指令碼預設為兩位小數。

ASSIGN StringVal = "0013001.93912837"
ASSIGN FixedPointResult = "{StringVal.format('F3')}"
ASSIGN FixedPointResult2 = "{StringVal.format('f')}"

結果：

FIXEDPOINTRESULT=13001.939

FIXEDPOINTRESULT2=13001.94

根據數字的類型以及是否包含精度指定元，數字將轉換為最緊湊的固定點或科學標記法。若精度指定元已省略或為零，則數字的類型決定預設精度，如下面的清單所示。

• 位元或 SByte：3
• Int16 或 UInt16：5
• Int32 或 UInt32：10
• Int64 或 UInt64：19
• 單精度：7
• 雙精度：15
• 十進位：29

若用科學標記法表示數字所產生的指數大於 -5 且小於精度指定元，則使用固定點標記法；否則，使用科學標記法。如果需要，結果包含一個小數點，並省略末尾零。

若存在精度指定元並且結果中的有效位數超過指定精度，則透過捨入移除多餘的末尾數位。本規則的例外情況是，若數字是十進位數字並且已省略精度指定元。在這種情況下，始終使用固定點標記法並保留末尾零。

在使用科學標記法時，若格式指定元為 G，則結果中的指數前綴為 E，或者若格式指定元為 g，則前綴為 e。

ASSIGN StringVal = "0013001.93912837"
ASSIGN GeneralResult1 = "{StringVal.format('G')}"
ASSIGN StringVal2 = 6002348902348890234.234432234
ASSIGN GeneralResult2 = "{StringVal2.format('G')}"

結果：

GENERALRESULT1=13001.93912837

GENERALRESULT2=6.00234890234889E+18

僅整數型支援此格式。該數字被轉換為一串十六進位數位。格式指定元的大小寫指示對於大於 9 的十六進位數位是使用大寫還是小寫字元。例如，使用 X 產生 ABCDEF，使用 x 產生 abcdef。

精度指定元指示結果字串中所需的最小位數。如果需要，數字的左側用零填充，以產生精度指定元給出的位數。

該數字被轉換為 -d,ddd,ddd.ddd… 形式的子串，其中：

• 如果需要，負號 ( - ) 表示負數符號。
• 每個 d 代表一個數位 (0-9)。
• 逗號 ( , ) 表示數字組之間的千位元分隔符號。
• 句號 ( .) 表示十進位點符號。

包括一個精度指定元，表示您希望該結果具有的小數位數。如果未包含精度指定元，則預設值為小數點後兩位。如果數字不包含小數點，輸出數字中將新增 .00。

ASSIGN StringVal = "0013001.93912837"
ASSIGN NumberResult = StringVal.format('N')
ASSIGN NumberResult2 = "{StringVal.format('n2')}"

結果：

NUMBERRESULT=13,001.94

NUMBERRESULT2=13,001.9391

該數字已被轉換為代表百分比的字串。轉換後的數字乘以 100，使之以百分比表示。

包括一個精度指定元，表示您希望該結果具有的小數位數。如果未包含精度指定元，則預設值為小數點後兩位。如果數字不包含小數點，輸出數字中將新增 .00。

ASSIGN StringVal = "0013001.93912837"
ASSIGN PercentResult = "{StringVal.format('P')}"
ASSIGN PercentResult2 = StringVal.format('P2')	

結果：

PERCENTRESULT=1,300,193.91%

PERCENTRESULT2=1,300,193.91%

僅單精度型和雙精度型支援此格式。往復指定元保證已轉換為字串的數值將解析回相同的數值。當使用此指定元格式化數值時，首先使用一般格式對其進行測試，雙精度為 15 個空格，單精度為 7 個空格。若該值已成功解析回相同的數值，則使用一般格式指定元對其進行格式化。但是，如果該值沒有成功解析回相同的數值，則將使用雙精度的 17 位數和單精度的 9 位數對該值進行格式化。

雖然可以存在精度指定元，但其已被忽略。使用此指定元時，往復優先於精度。

ASSIGN StringVal = "0013001.93912837"
ASSIGN RoundTripResult = "{StringVal.format('R')}"	

結果：

ROUNDTRIPRESULT=13001.93912837

使用一個或多個零預留位置來定義輸出中數字的格式。您可以將此預留位置與表中定義的其他預留位置字元合併。

如果被格式化的值在格式字串中 0 出現的位置上有一個數字，那麼該數字出現在輸出子串中。如果 0 出現的位置上未出現數字，那麼 0 將出現在輸出子串中。這有助於將零新增到需要前置零但沒有前置零的數字中。

小數點前最左邊的「0」和小數點後最右邊的「0」的位置決定了輸出字串中始終存在的位數。

00 指定元使數值重設為最接近的整數。

ASSIGN number = "2343456.2343"
ASSIGN zeroPlaceholders = "number.format(000,000.00)
ASSIGN number = "456.47"
ASSIGN doubleZeroSpecifier = number.format('00')

範例的結果是

zeroPlaceholders = 2,343,456.23

doubleZeroSpecifier = 456

使用一個或多個數位預留位置來定義輸出中數字的格式。您可以將此預留位置與表中定義的其他預留位置字元合併。

如果被格式化的值在格式字串中 # 出現的位置上有一個數字，那麼該數字出現在輸出結果中。如果 # 出現的位置上未出現數字，那麼輸出子串中的該位置為空。

如果被格式化的數字包含 0 作為有效數位，則 0 將出現在輸出字串中。如果 0 不是有效數位，則不會出現在輸出字串中，即使 0 是被格式化的字串中的唯一數字。

## 格式子串使數值重設為最接近的整數。

ASSIGN number = "2343456.2043"
ASSIGN digitPlaceholders = "number.format(###,###.##)
ASSIGN number = "456.47"
ASSIGN doubleDigitSpecifier = number.format('##')

範例的結果是

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

格式字串中的第一個句號 ( .決定了十進制分隔符在格式化值中的位置。任何額外的句號字元將被忽略。

逗號 ( , )字元既用作千位分隔符指定元又用作記數法指定元。

千位分隔符指定元：若在格式化數字整數的兩個數位預留位置（0 或 #）之間指定了一個或多個逗號 ( , ) 字元，則在輸出的整數部分中的每個數字群組之間插入一個群組分隔符字元。例如，如果使用字串 #,# 和非變異文化特性來格式化數字 1000，則輸出為 1,000。

記數法指定元：如果在顯小數點或隱小數點的左側緊接指定一個或多個逗號 ( , ) 字元，則對於每個記數法指定元，要格式化的數字將除以 1000。例如，如果使用字串 0,, 來格式化數字 1 億，則輸出為 100。

您可以在相同的格式字串中使用千位分隔符和記數法指定元。例如，如果使用字串 #,0,, 和非變異文化特性來格式化數字 10 億，則輸出為 1,000。

允許對數字指定兩種或三種可能的格式選項。格式的套用取決於數字是正數、負數還是零。

格式選項定義為單字串。每個選項都用分號 ( ; ) 字元分隔。如下例所示，使用零、位、千位和十位預留位置來指定格式。這些預留位置已在表中列出。

如果自訂格式字串中有兩個部分：

• 左側部分定義正數和零的格式。
• 右側部分定義負數的格式。

範例：

ASSIGN number9 = 928374
ASSIGN sectionSeparator4 = number9.format('000,000.##;00.##')

ASSIGN number10 = -998822.25
ASSIGN sectionSeparator5 = number10.format('000,000.##;00.##')

ASSIGN number11 = 0
ASSIGN sectionSeparator6 = number11.format('000,000.##;00.##')	

範例的結果是

sectionSeparator4 = 928,374

sectionSeparator5 = 998822.25

sectionSeparator6 = 000,000

如果存在三個部分：

• 左側部分定義正數的格式。
• 第二部分定義負數的格式。
• 右側部分定義零的格式。

範例：

ASSIGN number1 = 1789789
ASSIGN sectionSeparator1 = number1.format('000,000.##;00.##;000.0000')

ASSIGN number2 = 0
ASSIGN sectionSeparator2 = number2.format('000,000.##;00.##;000.0000')

ASSIGN number3 = -4321
ASSIGN sectionSeparator3 = number3.format('000,000.##;00.##;000.0000')

範例的結果是

sectionSeparator1 = 1,789,789

sectionSeparator2 = 000.0000

sectionSeparator3 = 4321

所有其他字元

將任何其他字元複製到結果字串中，不會影響格式。

使用包含轉義序列的序列。$ 字元必須位於雙引號之外。範例：

z = $"Use the \{myVar} variable."

用於為值新增首碼，以將其聲明為日期/時間類型。# 字元必須在雙引號之外。範例：

ASSIGN var = #"02/09/2023"