JSPM

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

A module that formats a string based on a pattern

Package Exports

  • format-string-by-pattern

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 (format-string-by-pattern) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

format-string-by-pattern

npm npm codecov dependencies Status gzip size install size

Overview

This module consists on a function that receives a pattern and a value and returns this value formatted according to the pattern. It doesn't work with every pattern, but it works with a lot of use cases, especially if you build functions on top of this module.

Install

yarn add format-string-by-pattern
npm i format-string-by-pattern

UMD

<script src="https://unpkg.com/format-string-by-pattern/dist/format-string-by-pattern.umd.js"></script>

Usage

const formatStringByPattern = require('format-string-by-pattern');

formatStringByPattern('YYYY-MM-DD', '20180508');
// '2018-05-08'

formatStringByPattern('2018-05-08', '20151217');
// '2015-12-17'

const formatOnlyNumbers = (anyString) => {
  const onlyNumbers = anyString.replace(/[^\d]/g, '');

  return formatStringByPattern('999-999-9999', onlyNumbers);
};
formatOnlyNumbers('1A2B3C4D5E6F7G8H9');
// '123-456-789'

// It works with curry too
const someFormat = formatStringByPattern('00.00');
someFormat(1234);
// 12.34

NOTE: The returned value will be sliced to the size of the pattern.

This library is pretty useful with forms, where you need to parse the input values. See the usage with the react-final-form library here.

API

formatStringByPattern(pattern, valueToFormat)

Returns a string.

pattern

Type: string

A string where anything that is not a number or letter will be treated as a separator.

valueToFormat

Type: string or number

A value to be formatted.

License

MIT © Arthur Denner