用户定义的格式

一般语法

一个特殊字符序列用于描述用户自定义格式。

格式字符串之前和之后的任何字符都将原样打印。

为了避免特殊字符的解读,必须用'\字符对其引用。

数值表达式的格式语法

+ 打印数字的符号
- 仅打印负数的符号
# 仅打印需要的数位。

数字的左侧用空格填补, 以便小数点前面打印的字符数量大于等于小数点前的 # 数量。
0 总是打印数位,如果需要则用0填充。
. 打印小数点。
, 打印千位分隔符。
% 数乘100,并打印百分号。
E 引入浮点数的指数部分,指数的符号总是打印。

示例

PRINT Format$(Pi, "-#.###")
3.142

PRINT Format$(Pi, "+0#.###0")
+03.1416

PRINT Format$(Pi / 10, "###.# %")
31.4 %

PRINT Format$(-11 ^ 11, "#.##E##")
-2.85E+11

货币的格式语法

对于货币格式,可以使用所有的数值格式符,以及下列这些:

$ 打印本国货币符号。
$$ 打印国际货币符号。
( 打印负数货币的表示,必须是格式中的第一个字符,在格式字符串结尾可以使用')

示例

PRINT Format$(1972.06, "$#.###")
$1972.06

PRINT Format$(-1972.06, "$,#.###")
-$1,972.06

PRINT Format$(-1972.06, "($$,#.###)")
(USD 1,972.06)

日期的格式语法

yy 打印两位数的年份。
yyyy 打印4位数的年份。
m 打印月。
mm 打印两位数的月份。
mmm 打印月的缩写字符串。
mmmm 打印月的全称字符串。
d 打印天。
dd 打印两位数的天。
ddd 打印星期的缩写字符串。
dddd 打印星期的全称字符串。
/ 打印日期分隔符。
h 打印小时。
hh 打印两位数的小时。
n 打印分钟。
nn 打印两位数的分钟。
s 打印秒。
ss 打印两位数的秒。
: 打印时间分隔符。
u 打印毫秒数(如果其不为0)。
uu 打印一个小数点和三位数的毫秒值。
t 打印时区的字母缩写。

自从 3.1
tt 用HHMM格式打印时区。

自从 3.1
AM/PM 依据小时数打印AM或者PM的本地等价符号,而且强制将小时用1到12的数值表示。

从Gambas 3开始,'u'日期格式不再打印小数点。如果需要则必须在格式字符串中明确的添加小数点。

示例

PRINT Format$(Now, "mm/dd/yyyy hh:nn:ss.u")
04/15/2002 09:05:36.26

PRINT Format$(Now, "mm/dd/yyyy hh:nn:ss.uu")
04/15/2002 09:05:36.026

PRINT Format$(Now, "m/d/yy h:n:s")
4/15/02 9:5:36

PRINT Format$(Now, "ddd dd mmm yyyy")
Mon 15 Apr 2002

PRINT Format$(Now, "dddd dd mmmm yyyy")
Monday 15 April 2002

PRINT Format$(Now, "yyyy-mm-dd hh-nn-ss")
PRINT Format$(Now, "yyyy/mm/dd hh:nn:ss")
2006-04-29 07-41-11
2006.04.29 07:41:11