This package has been deprecated

    Author message:

    WARNING: This library has been renamed to lit-date. See https://www.npmjs.com/package/lit-date

    fdate
    TypeScript icon, indicating that this package has built-in type declarations

    0.0.5 • Public • Published

    ⏰ fdate

    NPM filesize

    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

    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

    ops/sec
    fdate 279,762 ops/sec ±1.11% (88 runs sampled)
    time-stamp 247,083 ops/sec ±1.11% (90 runs sampled)
    date-fns 244,455 ops/sec ±1.05% (89 runs sampled)
    moment 241,140 ops/sec ±1.33% (91 runs sampled)
    fecha 232,466 ops/sec ±1.08% (91 runs sampled)
    dayjs 210,611 ops/sec ±0.97% (91 runs sampled)
    luxon 167,198 ops/sec ±1.13% (89 runs sampled)
    dateformat 96,692 ops/sec ±1.05% (86 runs sampled)

    Chrome 69.0.3497

    ops/sec
    fdate 573,465 ops/sec ±1.42% (60 runs sampled)
    time-stamp 387,719 ops/sec ±2.25% (59 runs sampled)
    fecha 375,460 ops/sec ±0.72% (61 runs sampled)
    date-fns 342,209 ops/sec ±1.25% (61 runs sampled)
    moment 325,720 ops/sec ±1.08% (62 runs sampled)
    dayjs 244,039 ops/sec ±4.33% (59 runs sampled)
    luxon 167,208 ops/sec ±1.36% (60 runs sampled)
    dateformat 97,894 ops/sec ±1.90% (60 runs sampled)

    Firefox 62.0.0

    ops/sec
    fdate 1,135,997 ops/sec ±2.55% (59 runs sampled)
    fecha 823,049 ops/sec ±3.11% (57 runs sampled)
    time-stamp 531,863 ops/sec ±4.40% (58 runs sampled)
    date-fns 435,223 ops/sec ±3.51% (59 runs sampled)
    moment 410,513 ops/sec ±3.49% (61 runs sampled)
    dayjs 369,565 ops/sec ±2.85% (59 runs sampled)
    luxon 170,537 ops/sec ±2.88% (61 runs sampled)
    dateformat 63,390 ops/sec ±2.26% (63 runs sampled)

    Advanced usage

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

    Node.js v10.10.0

    ops/sec
    fdate 291,909 ops/sec ±1.26% (88 runs sampled)
    moment 258,888 ops/sec ±1.62% (89 runs sampled)
    fecha 245,678 ops/sec ±0.99% (93 runs sampled)
    date-fns 189,735 ops/sec ±0.89% (90 runs sampled)
    dateformat 96,810 ops/sec ±0.95% (92 runs sampled)
    luxon 688 ops/sec ±1.18% (85 runs sampled)

    Chrome 69.0.3497

    ops/sec
    fdate 536,842 ops/sec ±0.82% (65 runs sampled)
    fecha 394,640 ops/sec ±1.58% (62 runs sampled)
    moment 322,982 ops/sec ±1.25% (61 runs sampled)
    date-fns 254,257 ops/sec ±1.00% (63 runs sampled)
    dateformat 96,633 ops/sec ±0.77% (62 runs sampled)
    luxon 624 ops/sec ±1.42% (44 runs sampled)

    Firefox 62.0.0

    ops/sec
    fdate 1,208,619 ops/sec ±2.43% (63 runs sampled)
    fecha 827,057 ops/sec ±4.89% (57 runs sampled)
    moment 380,293 ops/sec ±3.39% (56 runs sampled)
    date-fns 317,868 ops/sec ±2.57% (61 runs sampled)
    dateformat 62,233 ops/sec ±2.06% (63 runs sampled)
    luxon 864 ops/sec ±2.93% (54 runs sampled)

    Bundle size (Webpack)

    size gzipped
    time-stamp 1.74 KB 861 bytes
    fdate 2.29 KB 943 bytes
    dateformat 3.80 KB 1.81 KB
    fecha 5.50 KB 2.18 KB
    dayjs 7.21 KB 2.76 KB
    date-fns 9.34 KB 3.13 KB
    moment 51.85 KB 16.77 KB
    luxon 60.37 KB 18.45 KB

    Contribute

    PRs accepted.

    License

    MIT (c) 3846masa

    Install

    npm i fdate

    DownloadsWeekly Downloads

    14

    Version

    0.0.5

    License

    MIT

    Unpacked Size

    36.3 kB

    Total Files

    13

    Last publish

    Collaborators

    • 3846masa