fdate v0.0.5

⏰ fdate

Light-weight, faster datetime formatter for modern browsers.

fdate is ...

• ⏰ formatter of Date
• 👼 light-weight as a feather (~1kB gzipped!)
• 🦄 very faster than other datetime libraries (e.g. moment)
• 🆕 powered by Template literals

Table of Contents

• Install
• Usage
• Benchmark
• Contribute
• License

Install

npm i --save fdate
# -- OR --
yarn add fdate

-- OR --

<script src="https://unpkg.com/fdate"></script>

Usage

import fdate from 'fdate';
const render = fdate`${'YYYY'}/${'MM'}/${'DD'}`;
console.log(render(new Date()));

// i18n
const dayOfWeekName = ({ d }) => [...'日月火水木金土'][d];
const render = fdate`${'M'}月${'D'}日${dayOfWeekName}曜日`;
console.log(render(new Date()));

See examples.

For Webpack

If you use fdate via webpack, please set alias.

{
  resolve: {
    alias: {
      fdate: require.resolve('fdate'),
    },
  },
}

When using at legacy browser (e.g. IE), please setup loader for transpiling.

(However, fdate will be slow at legacy browser. Please consider using other libraries (e.g. fecha, dayjs).

{
  loader: [
    {
      test: /\.js$/,
      exclude: {
        // Pass fdate to babel-loader when building for legacy browser
        include: /(node_modules|bower_components)/,
        exclude: [/node_modules[\//]fdate/],
      },
      use: ['babel-loader'],
    },
  ],
}

Benchmark

See benchmarks for more details.

Basic usage

• new Date() -> 2000/01/06

Node.js v10.10.0

Chrome 69.0.3497

Firefox 62.0.0

Advanced usage

• new Date() -> 1月6日(木) (written in Japanese)

Node.js v10.10.0

Chrome 69.0.3497

Firefox 62.0.0

Bundle size (Webpack)

Contribute

PRs accepted.

License

MIT (c) 3846masa