日期、时间、数字和其他格式设置

以 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 说明符的数量。例如，如果有八个 y 说明符，则输出为 00002023。

表示时期或时代，例如 A.D。如果要格式化的日期没有关联的时期或时代字符串，则脚本将忽略此说明符。

单个 g 不能独立使用。如果只想输出时代或时期的名称，请使用双 gg。

对于 12 小时制，将小时表示为从 1 到 12 的一个数字；12小时制从午夜或中午开始计算整小时数。

午夜后的某一小时与中午后的同一小时不可区分。例如，上午 1:00 与下午 1:00 相同。

小时不会四舍五入，一位数小时的格式不带起首零位。

如果单独使用，请添加前缀%。

例如，对于 5:43 这一时间，此自定义格式说明符将显示 5。

对于 12 小时制，将小时表示为从 01 到 12 的一个双位数；12 小时制从午夜或中午开始计算整小时数。

午夜后的某一小时与中午后的同一小时不可区分。例如，上午 1:00 与下午 1:00 相同。

小时不会四舍五入，一位数小时的格式带起首零位。

例如，对于 5:43 这一时间，此自定义格式说明符将显示 05。

对于 24 小时制，将小时表示为从 0 到 23 的一个数字；24 小时制从午夜开始计算小时数。

一位数小时的格式不带起首零位。

例如，对于下午 5:43 这一时间，此自定义格式说明符将显示 17。

如果单独使用，请添加前缀 %。

对于 24 小时制，将小时表示为从 00 到 23 的一个双位数；24 小时制从午夜开始计算小时数。

一位数小时的格式带起首零位。

例如，对于下午 5:43 这一时间，此自定义格式说明符将显示 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

根据数字的类型以及是包含精度说明符，数字将转换为最紧凑的定点记数法或科学记数法。如果精度说明符省略或为零，则数字的类型决定默认精度，如下面的列表所示。

• Byte 或 SByte：3
• Int16 或 UInt16：5
• Int32 或 UInt32：10
• Int64 或 UInt64：19
• Single：7
• Double：15
• Decimal：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('##')

示例的结果是

数字占位符 = 2,343,456.2

双位数说明符 = 456

第一个句点 (.) 格式字符串中的第一个句点 () 字符确定了格式化的值中小数点分隔符的位置。任何其他句点字符都将被忽略。

逗号 (,) 字符既可以用作千位分隔符说明符，也可以用作记数法说明符。

千位分隔符说明符：如果在格式化数字整数位的两个数字占位符（0 或 #）之间指定了一个或多个逗号 (,) 字符，则在输出的整数部分的每个数组之间插入一个组分隔符字符。例如，如果使用字符串“#,#”和固定区域性来格式化数字 1000，则输出为“1,000”。

记数法说明符：如果在显式或隐式小数点的左边指定了一个或多个逗号 (,) 字符，则要格式化的数字要为每个记数法说明符除以 1000。例如，如果用字符串 0,, 来格式化数字 100000000 (1亿)，则输出为 100。

您可在相同的格式字符串中使用千位分隔符和计数法说明符。例如，如果使用字符串 #,0,, 和固定区域性来格式化数字 100000000（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"