as.zh.md

<pageheader><i>变量名</i> 为 <i>类型/格式</i></pageheader>

为运算符执行两个功能——转换和格式化。

转换：变量名 为 类型

将变量 变量名 转换为指定 类型。有效类型为：

bool	布尔值（true 或 false）
int	有符号 32 位整数
uint	无符号 32 位整数
int64	有符号 64 位整数
uint64	无符号 64 位整数
double	双精度浮点数
date	日期/时间
str	字符串
path	路径

从字符串转换为日期时，有效的输入格式为：

• YYYY-MM-DD
• YYYY-MM-DD HH:MM:SS
• HH:MM:SS

时间必须为 24 小时格式，分钟和秒可选。如果单独指定时间，则假定为今天的日期。

格式化：变量名 为 格式

使用指定格式化代码格式化变量 变量名。

可以使用各种格式化操作。

• 可以使用 D#、T# 和 A# 前缀代码 格式化日期/时间值
• 使用以下代码格式化文件大小值
• 使用 #p 或 %0p 对 p 位数进行零填充
• 使用 %p 右对齐 p 位数
• 使用 %-p 左对齐 p 位数
• 内部对齐：
  • 对负数使用 %_p 对齐到 p 位数
  • 对正数使用 %+p
• 使用 %.p 限制小数点后位数为 p
• 使用 %.0p 将小数位数用零填充至 p
• 使用 %x（小写）或 %X（大写）转换为十六进制

在有意义的情况下，可以组合上述代码，例如，%_+8 将数字内部对齐到 8 位，无论它是正数还是负数。

文件大小格式

使用 值 为大小 可以使用默认设置将数字自动格式化为文件大小。您还可以使用以下关键字来控制单位：

size	自动（字节/KB/MB 等）并带有用户配置的小数/二进制单位选项
szt	使用传统单位（1 KB = 1024 字节）自动
szi	使用二进制单位（1 KiB = 1024 字节）自动
szd	使用小数单位（1 KB = 1000 字节）自动
bytes	字节
kb	千字节，传统单位
mb	兆字节，传统单位
gb	吉字节，传统单位
tb	太字节，传统单位
pb	皮字节，传统单位
kib	千字节，二进制单位
mib	兆字节，二进制单位
gib	吉字节，二进制单位
tib	太字节，二进制单位
pib	皮字节，二进制单位
kbd	千字节，小数单位
mbd	兆字节，小数单位
gbd	吉字节，小数单位
tbd	太字节，小数单位
pbd	皮字节，小数单位

• 您使用 %.x 来指定小数位数，例如，%.3mib。或 %.03kb 用零填充
• 使用 %^ 向上舍入到最接近的千字节，例如 %^kb。
• 在“自动”关键字前使用 %0 来强制将 0 字节格式化为千字节

//<示例：//>

d = "2023-09-23" as date;
Output(d as "D#dd-MMM-yyyy");
--> 23-Sep-2023

i = 1 as double / 3;
Output(i as "%-.3");
--> 0.333

i = 183743933;
output(i as "%.3kb");
--> 179,437.435 KB

另请参阅: 格式