WebGAP Format Utils
README
This is the format utilities module for WebGAP. Contains formatter for Dates, String, Numbers, Bytes and Percentage.
Dependencies
Loads default configuration using @webgap/configuration.
Depends on String for string format.
Depends on Numeral for number format.
Requirements
A configuration file must exist (check @webgap/configuration documentation).
API
Installation
npm install @webgap/format-utils --save
Usage
var format = require('@webgap/format-utils').format();
...
// using default options will output:
format.bytes(256000); // returns 256KB
format.percentage(1); // returns 100.00%
format.number(10); // returns 10.00
format.currentDateTimeUnix(); // returns e.g 1318781876406
format.date(1318781876406); // returns 2011-10-16 +00:00
format.dateTime(1318781876406); // returns 2011-10-16T16:17:56 +00:00
format.dateFromNow(1318781876406); // returns e.g. 4 years ago
format.truncate('This is a long string that should be truncated...lets make it a bit longer...and a bit longer...', 20); //
Options
var options = {
dateFormat: "YYYY-MM-DD Z",
dateTimeFormat: "YYYY-MM-DDTHH:mm:ss Z",
timeFormat: "HH:mm:ss Z",
decimalFormat: "0,0.00",
percentageFormat: "0.00%",
byteFormat: "0.0b"
};
var format = require('@webgap/format-utils').format(options);
...
format.percentage(1); // 100.00%
...
Check tests for more examples.
License
Apache License, Version 2.0