JSPM

excel-style-dataformatter

2.0.1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1513
  • Score
    100M100P100Q113847F
  • License MIT

Excel-Style Javascript Data Formatter

Package Exports

  • excel-style-dataformatter

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (excel-style-dataformatter) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Excel-Style Javascript Data Formatter

npm

Current version supports

  • Number formatting (decimal form, fractional form, percents, etc.)
  • Date formatting (elapsed time, am/pm)
  • Predefined excel formats (Fixed, Standard, etc.)
  • Localization

Install

npm install excel-style-dataformatter
bower install excel-style-dataformatter

Usage

CommonJS

import DataFormatter from 'excel-style-dataformatter';
const dataFormatter = new DataFormatter();
const result = dataFormatter.format('99', 'Number', 'Currency');

With locales

import DataFormatter from 'excel-style-dataformatter';
import ru from 'excel-style-dataformatter/lib/ru';

// Create instance with defined locales
const options = { locales: [ru] };
const dataFormatter = new DataFormatter(options);

// Switch locale
dataFormatter.setLocale('ru');

const result = dataFormatter.format('99', 'Number', 'Currency');

Browser

<script src="excel-style-dataformatter/lib/index.js"></script>
<script src="excel-style-dataformatter/lib/locales/ru.js"></script>
<script>
  // Create instance
  var dataFormatter = new window.DataFormatter({
    locales: [window.DataFormatter_ru]
  });

  // Default locale
  document.write(dataFormatter.format('123.44', 'Number', 'Currency').value);

  // Switch to russian
  dataFormatter.setLocale('ru');
  document.write(dataFormatter.format('123.44', 'Number', 'Currency').value);
</script>

AMD

<script>
  require(['excel-style-dataformatter/lib/index', 'excel-style-dataformatter/lib/locales/ru'], function() {

    require(['DataFormatter', 'DataFormatter_ru'], function(DataFormatter, ru) {
      // Create instance
      var dataFormatter = new DataFormatter({ 
        locales: [ru] 
      });

      // Default locale
      document.write(dataFormatter.format('99', 'Number', 'Currency').value);

      // Switch to russian
      dataFormatter.setLocale('ru');
      document.write(dataFormatter.format('99', 'Number', 'Currency').value);
    });

  });
</script>

Available options

locale {string} - default locale
locales {string} - defined locales
UTCOffset {number|null} - UTC offset for dates in minutes
transformCode {function}
debug {boolean}

API

  • .format(value, type, format)
  • .defineLocales(locales)
  • .setLocale(locale)
  • .setUTCOffset(offset)