SSF

SpreadSheet Format(SSF)是一个纯JS库,使用ECMA-376电子表格格式代码来格式化数据。

Options

各种 API 函数采用 opts 参数来控制解析。默认选项如下所述:

/* 选项 */
var opts_fmt/*:Array<Array<any> >*/ = [

有两种通常被认可的日期代码格式。

  • 1900模式(其中date=0为1899-12-31)。
  • 1904模式(其中date=0为1904-01-01)。

1900 和 1904 日期模式之间的差异是 1462 天。由于 1904 日期模式仅在 Excel 的少数 Mac 变体中是默认的(2011 使用 1900 模式),因此默认为 1900 模式。与 ECMA-376 一致,名称为 date1904

  ["date1904", 0],

默认输出是文本表示(不努力捕捉颜色)。要控制输出,请设置 output 变量:

  • text :无颜色(默认)
  • html : 使用 html 输出
  • ansi : ansi 颜色代码(需要 colors 模块)
  ["output", ""],

这些选项通过 opts 字段提供:

  ["WTF", false]
];
function fixopts(o){
  for(var y = 0; y != opts_fmt.length; ++y) if(o[opts_fmt[y][0]]===undefined) o[opts_fmt[y][0]]=opts_fmt[y][1];
}
SSF.opts = opts_fmt;

条件性格式代码

说明书在这里有点不清楚。它最初在§18.3.1中声称。

最多可以指定四个部分的格式代码。这些格式代码由分号分隔,依次定义了正数、负数、零值和文本的格式。

分号可以用 \ 字符转义,因此我们需要拆分那些不以斜杠开头或在带引号的字符串中的分号:

function split_fmt(fmt/*:string*/)/*:Array<string>*/ {
  var out/*:Array<string>*/ = [];
  var in_str = false, cc;
  for(var i = 0, j = 0; i < fmt.length; ++i) switch((cc=fmt.charCodeAt(i))) {
    case 34: /* '"' */
      in_str = !in_str; break;
    case 95: case 42: case 92: /* '_' '*' '\\' */
      ++i; break;
    case 59: /* ';' */
      out[out.length] = fmt.substr(j,i-j);
      j = i+1;
  }
  out[out.length] = fmt.substr(j);
  if(in_str === true) throw new Error("Format |" + fmt + "| unterminated string ");
  return out;
}
SSF._split = split_fmt;

但它也允许有条件的格式化。

要设置仅在数字满足指定条件时应用的数字格式,请将条件括在方括号中。条件由一个比较运算符和一个值组成。比较运算符包括: = 等于; > 大于; < 小于; >= 大于等于, <= 小于等于, <> 不等于。

一个问题是,Excel不支持三个条件。比如说。

[Red][<-25]General;[Blue][>25]General;[Green][<>0]General;[Yellow]General

人们会期望格式代码会将所有 < -25 的数字涂成红色,所有 > 25 -2525 之间的非零数字涂成绿色,并将颜色 0 和文本涂成黄色。Excel 不这样做。

如果你把第三个子句解释为不符合前两个子句的数字的情况,那么双条件的情况以 "预期 "的方式工作。

[Red][<-25]General;[Blue][>25]General;[Green]General;[Yellow]General

将低于 -25 的值呈现为红色,高于 25 的值呈现为蓝色,其他数字呈现绿色,文本呈现黄色。

只有文本大小写允许有 @ 文本符号。Excel 将其解释为最后一种格式。

Utility Functions

function _strrev(x/*:string*/)/*:string*/ { var o = "", i = x.length-1; while(i>=0) o += x.charAt(i--); return o; }
function fill(c/*:string*/,l/*:number*/)/*:string*/ { var o = ""; while(o.length < l) o+=c; return o; }

接下来的几个助手将一般的 pad 功能分解为特殊情况:

function pad0(v/*:any*/,d/*:number*/)/*:string*/{var t=""+v; return t.length>=d?t:fill('0',d-t.length)+t;}
function pad_(v/*:any*/,d/*:number*/)/*:string*/{var t=""+v;return t.length>=d?t:fill(' ',d-t.length)+t;}
function rpad_(v/*:any*/,d/*:number*/)/*:string*/{var t=""+v; return t.length>=d?t:t+fill(' ',d-t.length);}
function pad0r1(v/*:any*/,d/*:number*/)/*:string*/{var t=""+Math.round(v); return t.length>=d?t:fill('0',d-t.length)+t;}
function pad0r2(v/*:any*/,d/*:number*/)/*:string*/{var t=""+v; return t.length>=d?t:fill('0',d-t.length)+t;}
var p2_32 = Math.pow(2,32);
function pad0r(v/*:any*/,d/*:number*/)/*:string*/{if(v>p2_32||v<-p2_32) return pad0r1(v,d); var i = Math.round(v); return pad0r2(i,d); }

通过char代码与字符串 "general "进行比较,速度更快。

function isgeneral(s/*:string*/, i/*:?number*/)/*:boolean*/ { i = i || 0; return s.length >= 7 + i && (s.charCodeAt(i)|32) === 103 && (s.charCodeAt(i+1)|32) === 101 && (s.charCodeAt(i+2)|32) === 110 && (s.charCodeAt(i+3)|32) === 101 && (s.charCodeAt(i+4)|32) === 114 && (s.charCodeAt(i+5)|32) === 97 && (s.charCodeAt(i+6)|32) === 108; }

一般号码格式

电子表格的 "一般 "格式(由格式代码0确定)对环境高度敏感,并且实现试图在给定的知识范围内最大限度地遵循该格式。

首先:以10为基数的32位整数比11个字符短,所以它们总是被写满。

function general_fmt_int(v/*:number*/, opts/*:?any*/)/*:string*/ { return ""+v; }
SSF._general_int = general_fmt_int;

下一篇:其他数字需要进行一些微调。

var general_fmt_num = (function make_general_fmt_num() {
var gnr1 = /\.(\d*[1-9])0+$/, gnr2 = /\.0*$/, gnr4 = /\.(\d*[1-9])0+/, gnr5 = /\.0*[Ee]/, gnr6 = /(E[+-])(\d)$/;
function gfn2(v) {
  var w = (v<0?12:11);
  var o = gfn5(v.toFixed(12)); if(o.length <= w) return o;
  o = v.toPrecision(10); if(o.length <= w) return o;
  return v.toExponential(5);
}
function gfn3(v) {
  var o = v.toFixed(11).replace(gnr1,".$1");
  if(o.length > (v<0?12:11)) o = v.toPrecision(6);
  return o;
}
function gfn4(o) {
  for(var i = 0; i != o.length; ++i) if((o.charCodeAt(i) | 0x20) === 101) return o.replace(gnr4,".$1").replace(gnr5,"E").replace("e","E").replace(gnr6,"$10$2");
  return o;
}
function gfn5(o) {
  //for(var i = 0; i != o.length; ++i) if(o.charCodeAt(i) === 46) return o.replace(gnr2,"").replace(gnr1,".$1");
  //return o;
  return o.indexOf(".") > -1 ? o.replace(gnr2,"").replace(gnr1,".$1") : o;
}
return function general_fmt_num(v/*:number*/, opts/*:?any*/)/*:string*/ {
  var V = Math.floor(Math.log(Math.abs(v))*Math.LOG10E), o;
  if(V >= -4 && V <= -1) o = v.toPrecision(10+V);
  else if(Math.abs(V) <= 9) o = gfn2(v);
  else if(V === 10) o = v.toFixed(10).substr(0,12);
  else o = gfn3(v);
  return gfn5(gfn4(o));
};})();
SSF._general_num = general_fmt_num;

Finally

function general_fmt(v/*:any*/, opts/*:?any*/) {
  switch(typeof v) {

对于字符串,只需按原样返回文本。

    case 'string': return v;

布尔运算是以大写字母序列化的。

    case 'boolean': return v ? "TRUE" : "FALSE";

对于数字,根据数值调用相关函数(int或num)。

    case 'number': return (v|0) === v ? general_fmt_int(v, opts) : general_fmt_num(v, opts);
  }

其他都是坏事。

  throw new Error("unsupported value in General format: " + v);
}
SSF._general = general_fmt;

隐含号码格式

这些是常用的格式,有一个特殊的隐含代码。这里不包括国际格式。

var table_fmt = {
  /*::[*/0/*::]*/:  'General',
  /*::[*/1/*::]*/:  '0',
  /*::[*/2/*::]*/:  '0.00',
  /*::[*/3/*::]*/:  '#,##0',
  /*::[*/4/*::]*/:  '#,##0.00',
  /*::[*/9/*::]*/:  '0%',
  /*::[*/10/*::]*/: '0.00%',
  /*::[*/11/*::]*/: '0.00E+00',
  /*::[*/12/*::]*/: '# ?/?',
  /*::[*/13/*::]*/: '# ??/??',

现在 Excel 和其他格式将代码 14 视为 m/d/yy (带有斜杠)。鉴于规范没有考虑国际化,在应用程序方面犯错在这里是有意义的:

  /*::[*/14/*::]*/: 'm/d/yy',
  /*::[*/15/*::]*/: 'd-mmm-yy',
  /*::[*/16/*::]*/: 'd-mmm',
  /*::[*/17/*::]*/: 'mmm-yy',
  /*::[*/18/*::]*/: 'h:mm AM/PM',
  /*::[*/19/*::]*/: 'h:mm:ss AM/PM',
  /*::[*/20/*::]*/: 'h:mm',
  /*::[*/21/*::]*/: 'h:mm:ss',
  /*::[*/22/*::]*/: 'm/d/yy h:mm',
  /*::[*/37/*::]*/: '#,##0 ;(#,##0)',
  /*::[*/38/*::]*/: '#,##0 ;[Red](#,##0)',
  /*::[*/39/*::]*/: '#,##0.00;(#,##0.00)',
  /*::[*/40/*::]*/: '#,##0.00;[Red](#,##0.00)',
  /*::[*/45/*::]*/: 'mm:ss',
  /*::[*/46/*::]*/: '[h]:mm:ss',
  /*::[*/47/*::]*/: 'mmss.0',
  /*::[*/48/*::]*/: '##0.0E+0',
  /*::[*/49/*::]*/: '@',

在[ECMA-376]18.8.30中确定了一些特殊的隐式格式代码。假设zh-tw是默认的。

  /*::[*/56/*::]*/: '"上午/下午 "hh"時"mm"分"ss"秒 "',

一些作者错误地将65535作为一般情况。

  /*::[*/65535/*::]*/: 'General'
};

日期和时间

代码 ddd 显示较短的星期几,而 dddd 显示较长的星期几:

var days = [
  ['Sun', 'Sunday'],
  ['Mon', 'Monday'],
  ['Tue', 'Tuesday'],
  ['Wed', 'Wednesday'],
  ['Thu', 'Thursday'],
  ['Fri', 'Friday'],
  ['Sat', 'Saturday']
];

mmm 显示短月, mmmm 显示长月, mmmmm 显示一个字符:

var months = [
  ['J', 'Jan', 'January'],
  ['F', 'Feb', 'February'],
  ['M', 'Mar', 'March'],
  ['A', 'Apr', 'April'],
  ['M', 'May', 'May'],
  ['J', 'Jun', 'June'],
  ['J', 'Jul', 'July'],
  ['A', 'Aug', 'August'],
  ['S', 'Sep', 'September'],
  ['O', 'Oct', 'October'],
  ['N', 'Nov', 'November'],
  ['D', 'Dec', 'December']
];

解析日期和时间代码

大多数电子表格格式将日期和时间存储为浮点数(其中整数部分是基于格式的日期代码,小数部分是一天中24小时的部分)。

Excel 支持备用回历日历(用 b2 表示):

function parse_date_code(v/*:number*/,opts/*:?any*/,b2/*:?boolean*/) {

超过12/31/9999的日期代码是无效的。

  if(v > 2958465 || v < 0) return null;

现在我们可以解析了!

  var date = (v|0), time = Math.floor(86400 * (v - date)), dow=0;
  var dout=[];
  var out={D:date, T:time, u:86400*(v-date)-time,y:0,m:0,d:0,H:0,M:0,S:0,q:0};
  if(Math.abs(out.u) < 1e-6) out.u = 0;
  fixopts(opts != null ? opts : (opts=[]));

Excel帮助实际上建议将1904年的日期代码视为1900年的日期代码,并将其移位1462天。

  if(opts.date1904) date += 1462;

由于浮点问题,修正为亚秒。

  if(out.u > 0.999) {
    out.u = 0;
    if(++time == 86400) { time = 0; ++date; }
  }

由于 Excel 和其他变体传播的 Lotus 1-2-3 中的错误,1900 年被认为是闰年。JS 无法将这种可憎的行为表示为 Date ,因此最简单的方法是将数据存储为元组。

1900 年 2 月 29 日(日期 60 )被认为是星期三。日期 0 被视为 1900 年 1 月 0 日,而不是 1899 年 12 月 31 日。

  if(date === 60) {dout = b2 ? [1317,10,29] : [1900,2,29]; dow=3;}
  else if(date === 0) {dout = b2 ? [1317,8,29] : [1900,1,0]; dow=6;}

对于其他日期,使用JS日期机制就足够了。

  else {
    if(date > 60) --date;
    /* 1 = 公历 1900 年 1 月 1 日 */
    var d = new Date(1900, 0, 1);
    d.setDate(d.getDate() + date - 1);
    dout = [d.getFullYear(), d.getMonth()+1,d.getDate()];
    dow = d.getDay();

请注意,Excel 选择使星期几指标与额外的一天保持一致。实际上,这意味着假闰日之前的日子已经过去了。例如,日期代码 55 是“1900 年 2 月 24 日星期五”,而实际上它是星期六。要做的“正确”事情是保持道琼斯指数的一致性,并打破那个“周”中有两个星期三的事实。

    if(date < 60) dow = (dow + 6) % 7;

对于hijri日历,需要固定日期

    if(b2) dow = fix_hijri(d, dout);
  }

因为JS日期不能代表坏的闰日,这将返回一个对象。

  out.y = dout[0]; out.m = dout[1]; out.d = dout[2];
  out.S = time % 60; time = Math.floor(time / 60);
  out.M = time % 60; time = Math.floor(time / 60);
  out.H = time;
  out.q = dow;
  return out;
}
SSF.parse_date_code = parse_date_code;

TODO:适当的hijri校正

function fix_hijri(date, o) { return 0; }

评估数字格式

实用程序 commaify 将逗号添加到整数:

function commaify(s/*:string*/)/*:string*/ {
  if(s.length <= 3) return s;
  var j = (s.length % 3), o = s.substr(0,j);
  for(; j!=s.length; j+=3) o+=(o.length > 0 ? "," : "") + s.substr(j,3);
  return o;
}

write_num 被分解为子函数以帮助优化:

var write_num = (function make_write_num(){

Percentages

百分比的基本数字应该是物理移位的。

var pct1 = /%/g;
function write_num_pct(type/*:string*/, fmt/*:string*/, val/*:number*/)/*:string*/{
  var sfmt = fmt.replace(pct1,""), mul = fmt.length - sfmt.length;
  return write_num(type, sfmt, val * Math.pow(10,2*mul)) + fill("%",mul);
}

Trailing Commas

小数点后有多个逗号的格式应以1000的适当倍数进行移位(更神奇)。

function write_num_cm(type/*:string*/, fmt/*:string*/, val/*:number*/)/*:string*/{
  var idx = fmt.length - 1;
  while(fmt.charCodeAt(idx-1) === 44) --idx;
  return write_num(type, fmt.substr(0,idx), val / Math.pow(10,3*(fmt.length-idx)));
}

Exponential

对于指数来说,要获得指数和尾数,并将它们分别格式化。

function write_num_exp(fmt/*:string*/, val/*:number*/)/*:string*/{
  var o/*:string*/;
  var idx = fmt.indexOf("E") - fmt.indexOf(".") - 1;

对于工程符号的特殊情况,"移位 "小数。

  if(fmt.match(/^#+0.0E\+0$/)) {
    var period = fmt.indexOf("."); if(period === -1) period=fmt.indexOf('E');
    var ee = Math.floor(Math.log(Math.abs(val))*Math.LOG10E)%period;
    if(ee < 0) ee += period;
    o = (val/Math.pow(10,ee)).toPrecision(idx+1+(period+ee)%period);
    if(o.indexOf("e") === -1) {

TODO:更清洁的东西

      var fakee = Math.floor(Math.log(Math.abs(val))*Math.LOG10E);
      if(o.indexOf(".") === -1) o = o.charAt(0) + "." + o.substr(1) + "E+" + (fakee - o.length+ee);
      else o += "E+" + (fakee - ee);
      while(o.substr(0,2) === "0.") {
        o = o.charAt(0) + o.substr(2,period) + "." + o.substr(2+period);
        o = o.replace(/^0+([1-9])/,"$1").replace(/^0+\./,"0.");
      }
      o = o.replace(/\+-/,"-");
    }
    o = o.replace(/^([+-]?)(\d*)\.(\d*)[Ee]/,function($$,$1,$2,$3) { return $1 + $2 + $3.substr(0,(period+ee)%period) + "." + $3.substr(ee) + "E"; });
  } else o = val.toExponential(idx);
  if(fmt.match(/E\+00$/) && o.match(/e[+-]\d$/)) o = o.substr(0,o.length-1) + "0" + o.charAt(o.length-1);
  if(fmt.match(/E\-/) && o.match(/e\+/)) o = o.replace(/e\+/,"e");
  return o.replace("e","E");
}

Fractions

var frac1 = /# (\?+)( ?)\/( ?)(\d+)/;
function write_num_f1(r/*:Array<string>*/, aval/*:number*/, sign/*:string*/)/*:string*/ {
  var den = parseInt(r[4],10), rr = Math.round(aval * den), base = Math.floor(rr/den);
  var myn = (rr - base*den), myd = den;
  return sign + (base === 0 ? "" : ""+base) + " " + (myn === 0 ? fill(" ", r[1].length + 1 + r[4].length) : pad_(myn,r[1].length) + r[2] + "/" + r[3] + pad0(myd,r[4].length));
}
function write_num_f2(r/*:Array<string>*/, aval/*:number*/, sign/*:string*/)/*:string*/ {
  return sign + (aval === 0 ? "" : ""+aval) + fill(" ", r[1].length + 2 + r[4].length);
}
var dec1 = /^#*0*\.(0+)/;
var closeparen = /\).*[0#]/;
var phone = /\(###\) ###\\?-####/;
function hashq(str/*:string*/)/*:string*/ {
  var o = "", cc;
  for(var i = 0; i != str.length; ++i) switch((cc=str.charCodeAt(i))) {
    case 35: break;
    case 63: o+= " "; break;
    case 48: o+= "0"; break;
    default: o+= String.fromCharCode(cc);
  }
  return o;
}

V8有一个恼人的习惯,那就是对圆形和地板进行优化。

function rnd(val/*:number*/, d/*:number*/)/*:string*/ { var dd = Math.pow(10,d); return ""+(Math.round(val * dd)/dd); }
function dec(val/*:number*/, d/*:number*/)/*:number*/ {
	if (d < ('' + Math.round((val-Math.floor(val))*Math.pow(10,d))).length) {
		return 0;
	}
	return Math.round((val-Math.floor(val))*Math.pow(10,d));
}
function carry(val/*:number*/, d/*:number*/)/*:number*/ {
	if (d < ('' + Math.round((val-Math.floor(val))*Math.pow(10,d))).length) {
		return 1;
	}
	return 0;
}
function flr(val/*:number*/)/*:string*/ { if(val < 2147483647 && val > -2147483648) return ""+(val >= 0 ? (val|0) : (val-1|0)); return ""+Math.floor(val); }

主要的数字书写功能

最后是身体。

function write_num_flt(type/*:string*/, fmt/*:string*/, val/*:number*/)/*:string*/ {

对于圆括号,明确解决符号问题。

  if(type.charCodeAt(0) === 40 && !fmt.match(closeparen)) {
    var ffmt = fmt.replace(/\( */,"").replace(/ \)/,"").replace(/\)/,"");
    if(val >= 0) return write_num_flt('n', ffmt, val);
    return '(' + write_num_flt('n', ffmt, -val) + ')';
  }

帮助者用于。

  • Percentage values
  • Trailing commas
  • Exponentials
  if(fmt.charCodeAt(fmt.length - 1) === 44) return write_num_cm(type, fmt, val);
  if(fmt.indexOf('%') !== -1) return write_num_pct(type, fmt, val);
  if(fmt.indexOf('E') !== -1) return write_num_exp(fmt, val);

TODO:使货币本地化。

  if(fmt.charCodeAt(0) === 36) return "$"+write_num_flt(type,fmt.substr(fmt[1]==' '?2:1),val);

一些简单的案件应首先解决。

  var o;
  var r/*:?Array<string>*/, ri, ff, aval = Math.abs(val), sign = val < 0 ? "-" : "";
  if(fmt.match(/^00+$/)) return sign + pad0r(aval,fmt.length);
  if(fmt.match(/^[#?]+$/)) {
    o = pad0r(val,0); if(o === "0") o = "";
    return o.length > fmt.length ? o : hashq(fmt.substr(0,fmt.length-o.length)) + o;
  }

已知分母的分数是通过四舍五入解决的。

  if((r = fmt.match(frac1))) return write_num_f1(r, aval, sign);

一些特殊的一般情况可以用很笨的方式来处理。

  if(fmt.match(/^#+0+$/)) return sign + pad0r(aval,fmt.length - fmt.indexOf("0"));
  if((r = fmt.match(dec1))) {
    // $FlowIgnore
    o = rnd(val, r[1].length).replace(/^([^\.]+)$/,"$1."+r[1]).replace(/\.$/,"."+r[1]).replace(/\.(\d*)$/,function($$, $1) { return "." + $1 + fill("0", r[1].length-$1.length); });
    return fmt.indexOf("0.") !== -1 ? o : o.replace(/^0\./,".");
  }

接下来的几个简化忽略了前导可选符号( # ):

  fmt = fmt.replace(/^#+([0.])/, "$1");
  if((r = fmt.match(/^(0*)\.(#*)$/))) {
    return sign + rnd(aval, r[2].length).replace(/\.(\d*[1-9])0*$/,".$1").replace(/^(-?\d*)$/,"$1.").replace(/^0\./,r[1].length?"0.":".");
  }
  if((r = fmt.match(/^#,##0(\.?)$/))) return sign + commaify(pad0r(aval,0));
  if((r = fmt.match(/^#,##0\.([#0]*0)$/))) {
    return val < 0 ? "-" + write_num_flt(type, fmt, -val) : commaify(""+(Math.floor(val) + carry(val, r[1].length))) + "." + pad0(dec(val, r[1].length),r[1].length);
  }
  if((r = fmt.match(/^#,#*,#0/))) return write_num_flt(type,fmt.replace(/^#,#*,/,""),val);

Zip Code + 4 格式需要将间隙连字符视为字符:

  if((r = fmt.match(/^([0#]+)(\\?-([0#]+))+$/))) {
    o = _strrev(write_num_flt(type, fmt.replace(/[\\-]/g,""), val));
    ri = 0;
    return _strrev(_strrev(fmt.replace(/\\/g,"")).replace(/[0#]/g,function(x){return ri<o.length?o[ri++]:x==='0'?'0':"";}));
  }

有一个更好的方法来概括电话号码和其他格式的第一次绘制的数字,但这种选择允许更多的细微差别。

  if(fmt.match(phone)) {
    o = write_num_flt(type, "##########", val);
    return "(" + o.substr(0,3) + ") " + o.substr(3, 3) + "-" + o.substr(6);
  }

frac辅助函数用于分数格式(定义如下)。

  var oa = "";
  if((r = fmt.match(/^([#0?]+)( ?)\/( ?)([#0?]+)/))) {
    ri = Math.min(/*::String(*/r[4]/*::)*/.length,7);
    ff = frac(aval, Math.pow(10,ri)-1, false);
    o = "" + sign;
    oa = write_num("n", /*::String(*/r[1]/*::)*/, ff[1]);
    if(oa[oa.length-1] == " ") oa = oa.substr(0,oa.length-1) + "0";
    o += oa + /*::String(*/r[2]/*::)*/ + "/" + /*::String(*/r[3]/*::)*/;
    oa = rpad_(ff[2],ri);
    if(oa.length < r[4].length) oa = hashq(r[4].substr(r[4].length-oa.length)) + oa;
    o += oa;
    return o;
  }
  if((r = fmt.match(/^# ([#0?]+)( ?)\/( ?)([#0?]+)/))) {
    ri = Math.min(Math.max(r[1].length, r[4].length),7);
    ff = frac(aval, Math.pow(10,ri)-1, true);
    return sign + (ff[0]||(ff[1] ? "" : "0")) + " " + (ff[1] ? pad_(ff[1],ri) + r[2] + "/" + r[3] + rpad_(ff[2],ri): fill(" ", 2*ri+1 + r[2].length + r[3].length));
  }

通用类 /^[#0?]+$/ 将 '0' 视为文字,'#' 视为 noop,'?' 作为空间:

  if((r = fmt.match(/^[#0?]+$/))) {
    o = pad0r(val, 0);
    if(fmt.length <= o.length) return o;
    return hashq(fmt.substr(0,fmt.length-o.length)) + o;
  }
  if((r = fmt.match(/^([#0?]+)\.([#0]+)$/))) {
    o = "" + val.toFixed(Math.min(r[2].length,10)).replace(/([^0])0+$/,"$1");
    ri = o.indexOf(".");
    var lres = fmt.indexOf(".") - ri, rres = fmt.length - o.length - lres;
    return hashq(fmt.substr(0,lres) + o + fmt.substr(fmt.length-rres));
  }

默认情况是硬编码的。TODO:实际解析它们

  if((r = fmt.match(/^00,000\.([#0]*0)$/))) {
    ri = dec(val, r[1].length);

请注意,这在技术上是不正确的

    return val < 0 ? "-" + write_num_flt(type, fmt, -val) : commaify(flr(val)).replace(/^\d,\d{3}$/,"0$&").replace(/^\d*$/,function($$) { return "00," + ($$.length < 3 ? pad0(0,3-$$.length) : "") + $$; }) + "." + pad0(ri,r[1].length);
  }
  switch(fmt) {
    case "#,###": var x = commaify(pad0r(aval,0)); return x !== "0" ? sign + x : "";

现在,默认情况下是一个错误。

    default:
  }
  throw new Error("unsupported format |" + fmt + "|");
}

Integer Optimizations

function write_num_cm2(type/*:string*/, fmt/*:string*/, val/*:number*/)/*:string*/{
  var idx = fmt.length - 1;
  while(fmt.charCodeAt(idx-1) === 44) --idx;
  return write_num(type, fmt.substr(0,idx), val / Math.pow(10,3*(fmt.length-idx)));
}
function write_num_pct2(type/*:string*/, fmt/*:string*/, val/*:number*/)/*:string*/{
  var sfmt = fmt.replace(pct1,""), mul = fmt.length - sfmt.length;
  return write_num(type, sfmt, val * Math.pow(10,2*mul)) + fill("%",mul);
}
function write_num_exp2(fmt/*:string*/, val/*:number*/)/*:string*/{
  var o/*:string*/;
  var idx = fmt.indexOf("E") - fmt.indexOf(".") - 1;
  if(fmt.match(/^#+0.0E\+0$/)) {
    var period = fmt.indexOf("."); if(period === -1) period=fmt.indexOf('E');
    var ee = Math.floor(Math.log(Math.abs(val))*Math.LOG10E)%period;
    if(ee < 0) ee += period;
    o = (val/Math.pow(10,ee)).toPrecision(idx+1+(period+ee)%period);
    if(!o.match(/[Ee]/)) {
      var fakee = Math.floor(Math.log(Math.abs(val))*Math.LOG10E);
      if(o.indexOf(".") === -1) o = o.charAt(0) + "." + o.substr(1) + "E+" + (fakee - o.length+ee);
      else o += "E+" + (fakee - ee);
      o = o.replace(/\+-/,"-");
    }
    o = o.replace(/^([+-]?)(\d*)\.(\d*)[Ee]/,function($$,$1,$2,$3) { return $1 + $2 + $3.substr(0,(period+ee)%period) + "." + $3.substr(ee) + "E"; });
  } else o = val.toExponential(idx);
  if(fmt.match(/E\+00$/) && o.match(/e[+-]\d$/)) o = o.substr(0,o.length-1) + "0" + o.charAt(o.length-1);
  if(fmt.match(/E\-/) && o.match(/e\+/)) o = o.replace(/e\+/,"e");
  return o.replace("e","E");
}
function write_num_int(type/*:string*/, fmt/*:string*/, val/*:number*/)/*:string*/ {
  if(type.charCodeAt(0) === 40 && !fmt.match(closeparen)) {
    var ffmt = fmt.replace(/\( */,"").replace(/ \)/,"").replace(/\)/,"");
    if(val >= 0) return write_num_int('n', ffmt, val);
    return '(' + write_num_int('n', ffmt, -val) + ')';
  }
  if(fmt.charCodeAt(fmt.length - 1) === 44) return write_num_cm2(type, fmt, val);
  if(fmt.indexOf('%') !== -1) return write_num_pct2(type, fmt, val);
  if(fmt.indexOf('E') !== -1) return write_num_exp2(fmt, val);
  if(fmt.charCodeAt(0) === 36) return "$"+write_num_int(type,fmt.substr(fmt[1]==' '?2:1),val);
  var o;
  var r, ri, ff, aval = Math.abs(val), sign = val < 0 ? "-" : "";
  if(fmt.match(/^00+$/)) return sign + pad0(aval,fmt.length);
  if(fmt.match(/^[#?]+$/)) {
    o = (""+val); if(val === 0) o = "";
    return o.length > fmt.length ? o : hashq(fmt.substr(0,fmt.length-o.length)) + o;
  }
  if((r = fmt.match(frac1))) return write_num_f2(r, aval, sign);
  if(fmt.match(/^#+0+$/)) return sign + pad0(aval,fmt.length - fmt.indexOf("0"));
  if((r = fmt.match(dec1))) {
    // $FlowIgnore
    o = (""+val).replace(/^([^\.]+)$/,"$1."+r[1]).replace(/\.$/,"."+r[1]).replace(/\.(\d*)$/,function($$, $1) { return "." + $1 + fill("0", r[1].length-$1.length); });
    return fmt.indexOf("0.") !== -1 ? o : o.replace(/^0\./,".");
  }
  fmt = fmt.replace(/^#+([0.])/, "$1");
  if((r = fmt.match(/^(0*)\.(#*)$/))) {
    return sign + (""+aval).replace(/\.(\d*[1-9])0*$/,".$1").replace(/^(-?\d*)$/,"$1.").replace(/^0\./,r[1].length?"0.":".");
  }
  if((r = fmt.match(/^#,##0(\.?)$/))) return sign + commaify((""+aval));
  if((r = fmt.match(/^#,##0\.([#0]*0)$/))) {
    return val < 0 ? "-" + write_num_int(type, fmt, -val) : commaify((""+val)) + "." + fill('0',r[1].length);
  }
  if((r = fmt.match(/^#,#*,#0/))) return write_num_int(type,fmt.replace(/^#,#*,/,""),val);
  if((r = fmt.match(/^([0#]+)(\\?-([0#]+))+$/))) {
    o = _strrev(write_num_int(type, fmt.replace(/[\\-]/g,""), val));
    ri = 0;
    return _strrev(_strrev(fmt.replace(/\\/g,"")).replace(/[0#]/g,function(x){return ri<o.length?o[ri++]:x==='0'?'0':"";}));
  }
  if(fmt.match(phone)) {
    o = write_num_int(type, "##########", val);
    return "(" + o.substr(0,3) + ") " + o.substr(3, 3) + "-" + o.substr(6);
  }
  var oa = "";
  if((r = fmt.match(/^([#0?]+)( ?)\/( ?)([#0?]+)/))) {
    ri = Math.min(r[4].length,7);
    ff = frac(aval, Math.pow(10,ri)-1, false);
    o = "" + sign;
    oa = write_num("n", r[1], ff[1]);
    if(oa[oa.length-1] == " ") oa = oa.substr(0,oa.length-1) + "0";
    o += oa + r[2] + "/" + r[3];
    oa = rpad_(ff[2],ri);
    if(oa.length < r[4].length) oa = hashq(r[4].substr(r[4].length-oa.length)) + oa;
    o += oa;
    return o;
  }
  if((r = fmt.match(/^# ([#0?]+)( ?)\/( ?)([#0?]+)/))) {
    ri = Math.min(Math.max(r[1].length, r[4].length),7);
    ff = frac(aval, Math.pow(10,ri)-1, true);
    return sign + (ff[0]||(ff[1] ? "" : "0")) + " " + (ff[1] ? pad_(ff[1],ri) + r[2] + "/" + r[3] + rpad_(ff[2],ri): fill(" ", 2*ri+1 + r[2].length + r[3].length));
  }
  if((r = fmt.match(/^[#0?]+$/))) {
    o = "" + val;
    if(fmt.length <= o.length) return o;
    return hashq(fmt.substr(0,fmt.length-o.length)) + o;
  }
  if((r = fmt.match(/^([#0]+)\.([#0]+)$/))) {
    o = "" + val.toFixed(Math.min(r[2].length,10)).replace(/([^0])0+$/,"$1");
    ri = o.indexOf(".");
    var lres = fmt.indexOf(".") - ri, rres = fmt.length - o.length - lres;
    return hashq(fmt.substr(0,lres) + o + fmt.substr(fmt.length-rres));
  }
  if((r = fmt.match(/^00,000\.([#0]*0)$/))) {
    return val < 0 ? "-" + write_num_int(type, fmt, -val) : commaify(""+val).replace(/^\d,\d{3}$/,"0$&").replace(/^\d*$/,function($$) { return "00," + ($$.length < 3 ? pad0(0,3-$$.length) : "") + $$; }) + "." + pad0(0,r[1].length);
  }
  switch(fmt) {
    case "#,###": var x = commaify(""+aval); return x !== "0" ? sign + x : "";
    default:
  }
  throw new Error("unsupported format |" + fmt + "|");
}

最后的函数只是派发。

return function write_num(type/*:string*/, fmt/*:string*/, val/*:number*/)/*:string*/ {
  return (val|0) === val ? write_num_int(type, fmt, val) : write_num_flt(type, fmt, val);
};})();

评估格式化字符串

var abstime = /\[[HhMmSs]*\]/;
function eval_fmt(fmt/*:string*/, v/*:any*/, opts/*:any*/, flen/*:number*/) {
  var out = [], o = "", i = 0, c = "", lst='t', q, dt, j, cc;
  var hr='H';
  /* Tokenize */
  while(i < fmt.length) {
    switch((c = fmt.charAt(i))) {

LO格式有时会泄漏 "GENERAL "或 "General "来代表一般格式。

      case 'G': /* 一般的 */
        if(!isgeneral(fmt, i)) throw new Error('unrecognized character ' + c + ' in ' +fmt);
        out[out.length] = {t:'G', v:'General'}; i+=7; break;

双引号之间的文本按字面意思处理,单个字符如果前面有斜线,则按字面意思处理。

由于 LO 生成的可能未终止的字符串,添加了额外的 i < fmt.length

      case '"': /* 文字文本 */
        for(o="";(cc=fmt.charCodeAt(++i)) !== 34 && i < fmt.length;) o += String.fromCharCode(cc);
        out[out.length] = {t:'t', v:o}; ++i; break;
      case '\\': var w = fmt[++i], t = (w === "(" || w === ")") ? w : 't';
        out[out.length] = {t:t, v:w}; ++i; break;

下划线字符代表一个字面的空格。很明显,它也标志着下一个字符是垃圾。因此,读指针被移动了2。

      case '_': out[out.length] = {t:'t', v:" "}; i+=2; break;

'@'符号指的是原始文本。ECMA的规范并不完整,但Excel不允许'@'和非文字的文本出现在同一格式中。似乎他们只支持一种模式。(显然这是excel模式的一个TODO,但我不相信这是正确的方法)

      case '@': /* 文本占位符 */
        out[out.length] = {t:'T', v:v}; ++i; break;

B1B2 指定使用哪个日历,而 b 是佛教年份。它的作用与 y 类似,只是年份发生了变化:

      case 'B': case 'b':
        if(fmt[i+1] === "1" || fmt[i+1] === "2") {
          if(dt==null) { dt=parse_date_code(v, opts, fmt[i+1] === "2"); if(dt==null) return ""; }
          out[out.length] = {t:'X', v:fmt.substr(i,2)}; lst = c; i+=2; break;
        }
        /* 掉线 */

日期代码 m,d,y,h,s 是标准的。有一些特殊的格式,例如 e / g (时代年),在日文/中文语言环境中具有不同的行为。

      case 'M': case 'D': case 'Y': case 'H': case 'S': case 'E':
        c = c.toLowerCase();
        /* 掉线 */
      case 'm': case 'd': case 'y': case 'h': case 's': case 'e': case 'g':

负面的日期立即被抛出。

        if(v < 0) return "";

将 "mmmm "或 "hh "等字符串合并为一个区块。

        if(dt==null) { dt=parse_date_code(v, opts); if(dt==null) return ""; }
        o = c; while(++i<fmt.length && fmt[i].toLowerCase() === c) o+=c;

这里只做了正向修正。反向修正将在以后进行。

        if(c === 'm' && lst.toLowerCase() === 'h') c = 'M'; /* m = 分钟 */
        if(c === 'h') c = hr;
        out[out.length] = {t:c, v:o}; lst = c; break;

A/PAM/PM 的(记录不充分)规则是,如果它们以格式显示,则 h所有实例都被认为是 12 小时而不是 24 小时格式(即使在像 hh AM/PM hh hh hh 呵呵)。

但是,未记录的 HHH 似乎确实重置了 AM/PM 指示器。目前还没有实施,因为我不能 100% 确定 HH/hh 爵士乐的规则。TODO:进一步调查。

      case 'A':
        q={t:c, v:"A"};
        if(dt==null) dt=parse_date_code(v, opts);
        if(fmt.substr(i, 3) === "A/P") { if(dt!=null) q.v = dt.H >= 12 ? "P" : "A"; q.t = 'T'; hr='h';i+=3;}
        else if(fmt.substr(i,5) === "AM/PM") { if(dt!=null) q.v = dt.H >= 12 ? "PM" : "AM"; q.t = 'T'; i+=5; hr='h'; }
        else { q.t = "t"; ++i; }
        if(dt==null && q.t === 'T') return "";
        out[out.length] = q; lst = c; break;

条件和颜色块应该在一个点处理(TODO)。伪类型 Z 用于捕获绝对时间块:

      case '[':
        o = c;
        while(fmt[i++] !== ']' && i < fmt.length) o += fmt[i];
        if(o.substr(-1) !== ']') throw 'unterminated "[" block: |' + o + '|';
        if(o.match(abstime)) {
          if(dt==null) { dt=parse_date_code(v, opts); if(dt==null) return ""; }
          out[out.length] = {t:'Z', v:o.toLowerCase()};
        } else { o=""; }
        break;

数字块(遵循一般模式 [0#?][0#?.,E+-%]* )被组合在一起。文字连字符也被吞下。由于 .000 是一个有效术语(十分之一/百分之一/千分之一秒),因此必须单独处理:

      /* 数字 */
      case '.':
        if(dt != null) {
          o = c; while((c=fmt[++i]) === "0") o += c;
          out[out.length] = {t:'s', v:o}; break;
        }
        /* 掉线 */
      case '0': case '#':
        o = c; while("0#?.,E+-%".indexOf(c=fmt[++i]) > -1 || c=='\\' && fmt[i+1] == "-" && "0#".indexOf(fmt[i+2])>-1) o += c;
        out[out.length] = {t:'n', v:o}; break;

分数问号字符提出了自己的挑战。例如, |??| / |???| |???| foo|15432| / |125| | | foo

      case '?':
        o = c; while(fmt[++i] === c) o+=c;
        q={t:c, v:o}; out[out.length] = q; lst = c; break;

由于CSV生成的方式,星号字符被丢弃了。TODO:以某种方式沟通这一点,可能用一个选项

      case '*': ++i; if(fmt[i] == ' ' || fmt[i] == '*') ++i; break; // **

打开和关闭括号 () 也有特殊含义(对于负数):

      case '(': case ')': out[out.length] = {t:(flen===1?'t':c), v:c}; ++i; break;

非零位数显示在分数分母中。

      case '1': case '2': case '3': case '4': case '5': case '6': case '7': case '8': case '9':
        o = c; while("0123456789".indexOf(fmt[++i]) > -1) o+=fmt[i];
        out[out.length] = {t:'D', v:o}; break;

ECMA376的18.8.30-31小节中列出了默认的魔法字符。

      case ' ': out[out.length] = {t:c, v:c}; ++i; break;
      default:
        if(",$-+/():!^&'~{}<>=€acfijklopqrtuvwxz".indexOf(c) === -1) throw new Error('unrecognized character ' + c + ' in ' + fmt);
        out[out.length] = {t:'t', v:c}; ++i; break;
    }
  }

为了识别像 MMSS 这样的情况,其中这是一分钟的事实出现在分钟之后,请向后扫描。同时,我们可以确定最小的时间单位(0 = 无时间,1 = 小时,2 = 分钟,3 = 秒)和亚秒所需的位数:

  var bt = 0, ss0 = 0, ssm;
  for(i=out.length-1, lst='t'; i >= 0; --i) {
    switch(out[i].t) {
      case 'h': case 'H': out[i].t = hr; lst='h'; if(bt < 1) bt = 1; break;
      case 's':
        if((ssm=out[i].v.match(/\.0+$/))) ss0=Math.max(ss0,ssm[0].length-1);
        if(bt < 3) bt = 3;
      /* 掉线 */
      case 'd': case 'y': case 'M': case 'e': lst=out[i].t; break;
      case 'm': if(lst === 's') { out[i].t = 'M'; if(bt < 2) bt = 2; } break;
      case 'X': if(out[i].v === "B2");
        break;
      case 'Z':
        if(bt < 1 && out[i].v.match(/[Hh]/)) bt = 1;
        if(bt < 2 && out[i].v.match(/[Mm]/)) bt = 2;
        if(bt < 3 && out[i].v.match(/[Ss]/)) bt = 3;
    }
  }

在确定了最小的时间单位后,要适当地取整。

  switch(bt) {
    case 0: break;
    case 1:
      /*::if(!dt) break;*/
      if(dt.u >= 0.5) { dt.u = 0; ++dt.S; }
      if(dt.S >=  60) { dt.S = 0; ++dt.M; }
      if(dt.M >=  60) { dt.M = 0; ++dt.H; }
      break;
    case 2:
      /*::if(!dt) break;*/
      if(dt.u >= 0.5) { dt.u = 0; ++dt.S; }
      if(dt.S >=  60) { dt.S = 0; ++dt.M; }
      break;
  }

由于字符串中的数字组应被视为同一整体的一部分,因此将它们分组来构建实数字符串。

  /* 替换字段 */
  var nstr = "", jj;
  for(i=0; i < out.length; ++i) {
    switch(out[i].t) {
      case 't': case 'T': case ' ': case 'D': break;
      case 'X': out[i].v = ""; out[i].t = ";"; break;
      case 'd': case 'm': case 'y': case 'h': case 'H': case 'M': case 's': case 'e': case 'b': case 'Z':
        /*::if(!dt) 抛出“无法访问”;*/
        out[i].v = write_date(out[i].t.charCodeAt(0), out[i].v, dt, ss0);
        out[i].t = 't'; break;
      case 'n': case '(': case '?':
        jj = i+1;
        while(out[jj] != null && (
          (c=out[jj].t) === "?" || c === "D" ||
          (c === " " || c === "t") && out[jj+1] != null && (out[jj+1].t === '?' || out[jj+1].t === "t" && out[jj+1].v === '/') ||
          out[i].t === '(' && (c === ' ' || c === 'n' || c === ')') ||
          c === 't' && (out[jj].v === '/' || '$€'.indexOf(out[jj].v) > -1 || out[jj].v === ' ' && out[jj+1] != null && out[jj+1].t == '?')
        )) {
          out[i].v += out[jj].v;
          out[jj] = {v:"", t:";"}; ++jj;
        }
        nstr += out[i].v;
        i = jj-1; break;
      case 'G': out[i].t = 't'; out[i].v = general_fmt(v,opts); break;
    }
  }

接下来,处理完整的数字字符串。

  var vv = "", myv, ostr;
  if(nstr.length > 0) {
    myv = (v<0&&nstr.charCodeAt(0) === 45 ? -v : v); /* '-' */
    ostr = write_num(nstr.charCodeAt(0) === 40 ? '(' : 'n', nstr, myv); /* '(' */
    jj=ostr.length-1;

找到第一个小数点。

    var decpt = out.length;
    for(i=0; i < out.length; ++i) if(out[i] != null && out[i].v.indexOf(".") > -1) { decpt = i; break; }
    var lasti=out.length;

如果没有小数点或指数,算法是直接的。

    if(decpt === out.length && ostr.indexOf("E") === -1) {
      for(i=out.length-1; i>= 0;--i) {
        if(out[i] == null || 'n?('.indexOf(out[i].t) === -1) continue;
        if(jj>=out[i].v.length-1) { jj -= out[i].v.length; out[i].v = ostr.substr(jj+1, out[i].v.length); }
        else if(jj < 0) out[i].v = "";
        else { out[i].v = ostr.substr(0, jj+1); jj = -1; }
        out[i].t = 't';
        lasti = i;
      }
      if(jj>=0 && lasti<out.length) out[lasti].v = ostr.substr(0,jj+1) + out[lasti].v;
    }

否则我们就得做一些更棘手的事情。

    else if(decpt !== out.length && ostr.indexOf("E") === -1) {
      jj = ostr.indexOf(".")-1;
      for(i=decpt; i>= 0; --i) {
        if(out[i] == null || 'n?('.indexOf(out[i].t) === -1) continue;
        j=out[i].v.indexOf(".")>-1&&i===decpt?out[i].v.indexOf(".")-1:out[i].v.length-1;
        vv = out[i].v.substr(j+1);
        for(; j>=0; --j) {
          if(jj>=0 && (out[i].v[j] === "0" || out[i].v[j] === "#")) vv = ostr[jj--] + vv;
        }
        out[i].v = vv;
        out[i].t = 't';
        lasti = i;
      }
      if(jj>=0 && lasti<out.length) out[lasti].v = ostr.substr(0,jj+1) + out[lasti].v;
      jj = ostr.indexOf(".")+1;
      for(i=decpt; i<out.length; ++i) {
        if(out[i] == null || 'n?('.indexOf(out[i].t) === -1 && i !== decpt ) continue;
        j=out[i].v.indexOf(".")>-1&&i===decpt?out[i].v.indexOf(".")+1:0;
        vv = out[i].v.substr(0,j);
        for(; j<out[i].v.length; ++j) {
          if(jj<ostr.length) vv += ostr[jj++];
        }
        out[i].v = vv;
        out[i].t = 't';
        lasti = i;
      }
    }
  }

下一行的神奇之处在于,当负数前面有明确的连字符时,确保负数作为正数传递(例如 #,##0.0;-#,##0.0 ):

  for(i=0; i<out.length; ++i) if(out[i] != null && 'n(?'.indexOf(out[i].t)>-1) {
    myv = (flen >1 && v < 0 && i>0 && out[i-1].v === "-" ? -v:v);
    out[i].v = write_num(out[i].t, out[i].v, myv);
    out[i].t = 't';
  }

现在我们只需要把这些元素结合起来

  var retval = "";
  for(i=0; i !== out.length; ++i) if(out[i] != null) retval += out[i].v;
  return retval;
}
SSF._eval = eval_fmt;

m 字符有一些重载。根据规范:

如果 "m "或 "mm "代码紧接在 "h "或 "hh "代码(用于小时)之后或紧接在 "ss "代码(用于秒)之前使用,应用程序将显示分钟而不是月份。

/*jshint -W086 */
function write_date(type/*:number*/, fmt/*:string*/, val, ss0/*:?number*/)/*:string*/ {
  var o="", ss=0, tt=0, y = val.y, out, outl = 0;
  switch(type) {

b 年移动了 543 ( y 1900 == b 2443):

    case 98: /* 'b' 佛教年 */
      y = val.y + 543;
      /* 掉线 */

yyyyyyyyyyyyyyyyyyyy 是 4 位数年份

    case 121: /* 'y' 年 */
    switch(fmt.length) {
      case 1: case 2: out = y % 100; outl = 2; break;
      default: out = y % 10000; outl = 4; break;
    } break;

mmmmmmmmmmmmmmmmmmmm 被视为完整的月份名称:

    case 109: /* 'm' 月 */
    switch(fmt.length) {
      case 1: case 2: out = val.m; outl = fmt.length; break;
      case 3: return months[val.m-1][1];
      case 5: return months[val.m-1][0];
      default: return months[val.m-1][2];
    } break;

dddddddddddddddddddd 被视为全天名称:

    case 100: /* 'd' 日 */
    switch(fmt.length) {
      case 1: case 2: out = val.d; outl = fmt.length; break;
      case 3: return days[val.q][0];
      default: return days[val.q][1];
    } break;

异常的小时和分钟被拒绝。

    case 104: /* 'h' 12 小时 */
    switch(fmt.length) {
      case 1: case 2: out = 1+(val.H+11)%12; outl = fmt.length; break;
      default: throw 'bad hour format: ' + fmt;
    } break;
    case 72: /* 'H' 24 小时 */
    switch(fmt.length) {
      case 1: case 2: out = val.H; outl = fmt.length; break;
      default: throw 'bad hour format: ' + fmt;
    } break;
    case 77: /* 'M' 分钟 */
    switch(fmt.length) {
      case 1: case 2: out = val.M; outl = fmt.length; break;
      default: throw 'bad minute format: ' + fmt;
    } break;

不幸的是,实际的亚秒级字符串是基于其他术语的存在。这是通过 ss0 参数传递的:

    case 115: /* 's' seconds */
    if(val.u === 0) switch(fmt) {
      case 's': case 'ss': return pad0(val.S, fmt.length);
      case '.0': case '.00': case '.000':
    }
    switch(fmt) {
      case 's': case 'ss': case '.0': case '.00': case '.000':
        /*::if(!ss0) ss0 = 0; */
        if(ss0 >= 2) tt = ss0 === 3 ? 1000 : 100;
        else tt = ss0 === 1 ? 10 : 1;
        ss = Math.round((tt)*(val.S + val.u));
        if(ss >= 60*tt) ss = 0;
        if(fmt === 's') return ss === 0 ? "0" : ""+ss/tt;
        o = pad0(ss,2 + ss0);
        if(fmt === 'ss') return o.substr(0,2);
        return "." + o.substr(2,fmt.length-1);
      default: throw 'bad second format: ' + fmt;
    }

Z 类型是指绝对时间度量:

    case 90: /* 'Z' 绝对时间 */
    switch(fmt) {
      case '[h]': case '[hh]': out = val.D*24+val.H; break;
      case '[m]': case '[mm]': out = (val.D*24+val.H)*60+val.M; break;
      case '[s]': case '[ss]': out = ((val.D*24+val.H)*60+val.M)*60+Math.round(val.S+val.u); break;
      default: throw 'bad abstime format: ' + fmt;
    } outl = fmt.length === 3 ? 1 : 2; break;

excel 中的 e 格式行为与规范不同。它声称 ee 应该是两位数的年份,但excel中的 ee 实际上是四位数的年份:

    case 101: /* 'e' 时代 */
      out = y; outl = 1;

最终触发默认行为的函数没有输入:它不会被导出,并且仅在类型为 ymdhHMsZe 时调用

  }
  if(outl > 0) return pad0(out, outl); else return "";
}
/*jshint +W086 */

根据该值, choose_fmt 选择正确的格式字符串。如果格式具有明确的负规范,则这些值应作为正传递:

function choose_fmt(f/*:string*/, v) {
  var fmt = split_fmt(f);
  var l = fmt.length, lat = fmt[l-1].indexOf("@");
  if(l<4 && lat>-1) --l;
  if(fmt.length > 4) throw new Error("cannot find right format for |" + fmt.join("|") + "|");

如果有"@",则使用最后一种格式,以短路字符串的情况。

  if(typeof v !== "number") return [4, fmt.length === 4 || lat>-1?fmt[fmt.length-1]:"@"];
  switch(fmt.length) {

在一种格式的情况下,如果它包含一个"@",那么它就是一种文本格式。关于如何最好地处理这种情况,这里有一个很大的TODO。

    case 1: fmt = lat>-1 ? ["General", "General", "General", fmt[0]] : [fmt[0], fmt[0], fmt[0], "@"]; break;

在 2 或 3 格式的情况下,如果 @ 出现在格式的最后一个字段中,则将其视为文本格式

    case 2: fmt = lat>-1 ? [fmt[0], fmt[0], fmt[0], fmt[1]] : [fmt[0], fmt[1], fmt[0], "@"]; break;
    case 3: fmt = lat>-1 ? [fmt[0], fmt[1], fmt[0], fmt[2]] : [fmt[0], fmt[1], fmt[2], "@"]; break;
    case 4: break;
  }

在这里,我们必须对条件进行扫描。请注意,语法中排除了小数,但在实践中它们是公平的。

var cfregex = /\[[=<>]/;
var cfregex2 = /\[([=<>]*)(-?\d+\.?\d*)\]/;
function chkcond(v, rr) {
  if(rr == null) return false;
  var thresh = parseFloat(rr[2]);
  switch(rr[1]) {
    case "=":  if(v == thresh) return true; break;
    case ">":  if(v >  thresh) return true; break;
    case "<":  if(v <  thresh) return true; break;
    case "<>": if(v != thresh) return true; break;
    case ">=": if(v >= thresh) return true; break;
    case "<=": if(v <= thresh) return true; break;
  }
  return false;
}

主函数检查条件运算符并采取相应的行动。

  var ff = v > 0 ? fmt[0] : v < 0 ? fmt[1] : fmt[2];
  if(fmt[0].indexOf("[") === -1 && fmt[1].indexOf("[") === -1) return [l, ff];
  if(fmt[0].match(cfregex) != null || fmt[1].match(cfregex) != null) {
    var m1 = fmt[0].match(cfregex2);
    var m2 = fmt[1].match(cfregex2);
    return chkcond(v, m1) ? [l, fmt[0]] : chkcond(v, m2) ? [l, fmt[1]] : [l, fmt[m1 != null && m2 != null ? 2 : 1]];
  }
  return [l, ff];
}

最后,格式包装器将一切都集中在一起。

function format(fmt/*:string|number*/,v/*:any*/,o/*:?any*/) {
  fixopts(o != null ? o : (o=[]));

字符串的格式被保存在一个不同的变量中。

  var sfmt = "";
  switch(typeof fmt) {
    case "string": sfmt = fmt; break;
    case "number": sfmt = (o.table != null ? (o.table/*:any*/) : table_fmt)[fmt]; break;
  }

LibreOffice似乎发出了 "GENERAL "的格式,表示一般。

  if(isgeneral(sfmt,0)) return general_fmt(v, o);
  var f = choose_fmt(sfmt, v);
  if(isgeneral(f[1])) return general_fmt(v, o);

布尔值TRUE和FALSE的格式化,就像它们是大写的文本一样。

  if(v === true) v = "TRUE"; else if(v === false) v = "FALSE";

空字符串应该总是发出空信号,即使有其他字符。

  else if(v === "" || v == null) return "";
  return eval_fmt(f[1], v, o, f[0]);
}

以下划线开头的方法可能会有变化,不应直接在程序中使用。

SSF._table = table_fmt;
SSF.load = function load_entry(fmt/*:string*/, idx/*:number*/) { table_fmt[idx] = fmt; };
SSF.format = format;

为了支持多个SSF表。

SSF.get_table = function get_table() { return table_fmt; };
SSF.load_table = function load_table(tbl/*:{[n:number]:string}*/) { for(var i=0; i!=0x0188; ++i) if(tbl[i] !== undefined) SSF.load(tbl[i], i); };

Fraction Library

实现来自我们的 frac 库

function frac(x, D, mixed) {
  var sgn = x < 0 ? -1 : 1;
  var B = x * sgn;
  var P_2 = 0, P_1 = 1, P = 0;
  var Q_2 = 1, Q_1 = 0, Q = 0;
  var A = Math.floor(B);
  while(Q_1 < D) {
    A = Math.floor(B);
    P = A * P_1 + P_2;
    Q = A * Q_1 + Q_2;
    if((B - A) < 0.0000000005) break;
    B = 1 / (B - A);
    P_2 = P_1; P_1 = P;
    Q_2 = Q_1; Q_1 = Q;
  }
  if(Q > D) { Q = Q_1; P = P_1; }
  if(Q > D) { Q = Q_2; P = P_2; }
  if(!mixed) return [0, sgn * P, Q];
  if(Q===0) throw "Unexpected state: "+P+" "+P_1+" "+P_2+" "+Q+" "+Q_1+" "+Q_2;
  var q = Math.floor(sgn * P/Q);
  return [q, sgn*P - q*Q, Q];
}

JS Boilerplate

/* ssf.js (C) 2013 年至今的 SheetJS -- http://sheetjs.com */
/*jshint -W041 */
var SSF = {};
var make_ssf = function make_ssf(SSF){
};
make_ssf(SSF);
/*全局模块*/
/*:: 声明 var DO_NOT_EXPORT_SSF: any; */
if(typeof module !== 'undefined' && typeof DO_NOT_EXPORT_SSF === 'undefined') module.exports = SSF;

.vocrc 和后置命令

#!/bin/bash
npm install
echo "SSF.version = '"`grep version package.json | awk '{gsub(/[^0-9\.]/,"",$2); print $2}'`"';" > tmp/01_version.js
cat tmp/*.js > ssf.js
{
  "post": "bash tmp/post.sh"
}