📗 SheetJS Community Edition -- Spreadsheet Data Toolkit
Go to file
SheetJS c156693778 version bump 0.6.4: alternate forms with literal -
Some versions of Excel render formats with literal hyphens, like `00000\-0000` that
should be properly handled
2014-04-03 01:11:44 -07:00
bin version bump 0.5.0: cleanup 2014-01-10 14:09:11 -05:00
test version bump 0.6.4: alternate forms with literal - 2014-04-03 01:11:44 -07:00
.npmignore version bump 0.5.2: cleanup 2014-01-20 03:37:48 -05:00
.travis.yml version bump 0.5.4: empty text is empty 2014-01-28 20:02:46 -05:00
index.html added gh-pages demo 2014-02-11 00:46:45 -05:00
LICENSE version bump 0.5.0: cleanup 2014-01-10 14:09:11 -05:00
Makefile coveralls target uses min test 2014-03-27 14:31:10 -07:00
package.json version bump 0.6.4: alternate forms with literal - 2014-04-03 01:11:44 -07:00
README.md adding coveralls badge [ci skip] 2014-02-17 04:28:06 -05:00
ssf.js version bump 0.6.4: alternate forms with literal - 2014-04-03 01:11:44 -07:00
ssf.md version bump 0.6.4: alternate forms with literal - 2014-04-03 01:11:44 -07:00

SSF

SpreadSheet Format (SSF) is a pure-JS library to format data using ECMA-376 spreadsheet format codes (like those used in Microsoft Excel)

This is written in voc -- see ssf.md for code.

To build: voc ssf.md

Setup

In the browser:

<script src="ssf.js"></script>

In node:

var SSF = require('ssf');

The script will manipulate module.exports if available (e.g. in a CommonJS require context). This is not always desirable. To prevent the behavior, define DO_NOT_EXPORT_SSF:

Usage

.load(fmt, idx) sets custom formats (generally indices above 164).

.format(fmt, val, opts) formats val using the format fmt. If fmt is of type number, the internal table (and custom formats) will be used. If fmt is a literal format, then it will be parsed and evaluated.

.parse_date_code(val, opts) parses val as date code and returns object:

  • D,T: Date ([val]) Time ({val})
  • y,m,d: Year, Month, Day
  • H,M,S,u: (0-23)Hour, Minute, Second, Sub-second
  • q: Day of Week (0=Sunday, 1=Monday, ..., 5=Friday, 6=Saturday)

.get_table() gets the internal format table (number to format mapping).

.load_table(table) sets the internal format table.

Notes

Format code 14 in the spec is broken; the correct format is 'mm/dd/yy' (dashes, not spaces)

License

Apache 2.0

Tests

Build Status

Coverage Status

githalytics.com alpha