format

format(X, format)

X 可以是标量或向量。

format 是表示 X 格式的字符串。

把指定格式应用到给定对象。返回结果是字符串标量或向量。

根据输入对象的数据类型，format 函数调用 decimalFormat 或 temporalFormat。

有关从数字向指定格式字符串的转换，参考：

• 备注1：小数点之前0的个数表示整数部分的位数。与之对比，小数点之后0的个数表示小数部分的位数。

  decimalFormat(123,"0");
  # output
  123
  
  decimalFormat(123,"00000");
  # output
  00123
  
  decimalFormat(123.45,"0");
  # output
  123
  
  decimalFormat(123.45,"0.0");
  # output
  123.5
  
  decimalFormat(123.45,"0.000");
  # output
  123.450
  
  decimalFormat(123.45, ".0");
  # output
  123.5
  
  decimalFormat(0.45, ".0");
  # output
  .5

• 备注2：如果0与#同时在小数点后使用，0必须在#前面。

  decimalFormat(123.45,"0.#");
  # output
  123.5
  
  decimalFormat(123.45,"0.###");
  # output
  123.45
  
  decimalFormat(123.456,"0.000###");
  # output
  123.456
  
  decimalFormat(123.456789110,"0.000###");
  # output
  123.456789
  
  decimalFormat(0.345, ".##");
  # output
  .35

• 备注3：%用于格式字符串的结尾。%和 E 在一个格式字符串中不能同时出现。

  decimalFormat(0.125,"0.00%");
  # output
  12.50%
  
  decimalFormat(0.125, "#.##%");
  # output
  12.5%
  
  decimalFormat(0.12567,"#.##%");
  # output
  12.57%

• 备注4：E 后面只能紧跟0，并且至少紧跟一个0。

  decimalFormat(1234567.89,"0.##E00");
  # output
  1.23E06
  
  decimalFormat(0.0000000000123456789,"0.000E0");
  # output
  1.235E-11

• 备注5：分隔符在一个格式字符串中只能出现一次。分隔符与小数点之间的位数或分隔符到结尾的位数即为分隔的间距。

  decimalFormat(123456789,"#,###");
  # output
  123,456,789
  
  decimalFormat(123456789.166,"#,###.##");
  # output
  123,456,789.17
  
  decimalFormat(123456789.166,"0,000.00");
  # output
  123,456,789.17

• 备注6：我们可以使用";"来选择数字对象的正负。

  decimalFormat(123.456,"0.00#E00;(0.00#E00)");
  # output
  1.235E02
  
  decimalFormat(-123.456,"0.00#E00;(0.00#E00)");
  # output
  (1.235E02)

有关 DolphinDB 时序对象的格式，参考：

t = table(1..100 as id, (1..100 + 2018.01.01) as date, rand(100.0, 100) as price, rand(10000, 100) as qty);
t;

select id, date.format("MM/dd/yyyy") as date, price.format("00.00") as price, qty.format("#,###") as qty from t;