benchmark-date-formatting

Setup & Run

npm install

Benchmarks V1

• Run node benchmark.js

Results

┌───────────────────────────────────────┬──────────────────────────────────┐
│                (index)                │              Values              │
├───────────────────────────────────────┼──────────────────────────────────┤
│                moment                 │ '2023.03.09T10:18:18,873 -0600'  │
│              date-format              │ '2023.03.09T10:18:18,873 -06:00' │
│              dateFormat               │ '2023.03.09T10:18:18,873 -0600'  │
│           fast-date-format            │ '2023.03.09T10:18:18,873 -06:00' │
│                 fecha                 │ '2023.03.09T10:18:18,873 -0600'  │
│              speed-date               │ '2023.03.09T10:18:18,873 -0600'  │
│              date-fns-tz              │ '2023.03.09T10:18:18,873 -06:00' │
│               date-fns                │ '2023.03.09T10:18:18,873 -06:00' │
│              date-fns/fp              │ '2023.03.09T10:18:18,873 -06:00' │
│       date-fns/fp (precompiled)       │ '2023.03.09T10:18:18,873 -06:00' │
│        date-fns/fp/lightFormat        │    '2023.03.09T10:18:18,873'     │
│ date-fns/fp/lightFormat (precompiled) │    '2023.03.09T10:18:18,873'     │
└───────────────────────────────────────┴──────────────────────────────────┘
moment x 343,344 ops/sec ±0.42% (94 runs sampled)
date-format x 425,305 ops/sec ±0.26% (90 runs sampled)
dateFormat x 190,080 ops/sec ±0.72% (96 runs sampled)
fast-date-format x 1,350,805 ops/sec ±0.38% (96 runs sampled)
fecha x 274,423 ops/sec ±0.50% (94 runs sampled)
speed-date x 1,495,064 ops/sec ±0.28% (95 runs sampled)
date-fns-tz x 123,388 ops/sec ±0.29% (96 runs sampled)
date-fns x 153,037 ops/sec ±0.28% (96 runs sampled)
date-fns/fp x 143,342 ops/sec ±0.44% (92 runs sampled)
date-fns/fp (precompiled) x 140,116 ops/sec ±0.44% (94 runs sampled)
date-fns/fp/lightFormat x 276,697 ops/sec ±0.93% (86 runs sampled)
date-fns/fp/lightFormat (precompiled) x 263,688 ops/sec ±0.83% (91 runs sampled)

🏁 🏁 🏁 'speed-date' is the fastest. 🏁 🏁 🏁

Summary Analysis

• date-fns has a "light" formatter, which is almost 2x faster: https://date-fns.org/v2.29.3/docs/lightFormat
• There's a "precompile" strategy mentioned here: date-fns/date-fns#423
  • This was never implemented has no effect on anything
• https://github.com/gosquared/speed-date is the fastest, every time

Benchmarks (MMM-YYYY)

• Run node benchmark-mmm-yyyy.js

We're testing a specific date format MMM_YYYY that returns Mar_2023.

The custom function is written as

const monthLookup = {
  0: "Jan",
  1: "Feb",
  2: "Mar",
  3: "Apr",
  4: "May",
  5: "Jun",
  6: "Jul",
  7: "Aug",
  8: "Sep",
  9: "Oct",
  10: "Nov",
  11: "Dec",
};

const custom = (date) => {
  const month = date.getMonth();
  const year = date.getFullYear();
  return `${monthLookup[month]}_${year}`;
};

Results

┌──────────────────┬────────────┐
│     (index)      │   Values   │
├──────────────────┼────────────┤
│ fast-date-format │ 'Mar_2023' │
│    speed-date    │ 'Mar_2023' │
│   date-fns/fp    │ 'Mar_2023' │
│      custom      │ 'Mar_2023' │
└──────────────────┴────────────┘
fast-date-format x 3,947,291 ops/sec ±1.06% (88 runs sampled)
speed-date x 3,928,236 ops/sec ±1.05% (91 runs sampled)
date-fns/fp x 361,881 ops/sec ±0.96% (89 runs sampled)
custom x 3,653,285 ops/sec ±2.93% (85 runs sampled)

🏁 🏁 🏁 'fast-date-format,speed-date' is the fastest. 🏁 🏁 🏁

Summary Analysis

• fast-date-format and speed-date run as fast as the custom function

Benchmarks (Q-YYYY)

• Run node benchmark-q-yyyy.js

We're testing a specific date format Q_YYYY that returns 1_2023.

The custom function is written as

const custom = (date) => {
  const month = date.getMonth();
  const year = date.getFullYear();
  const quarter = Math.floor(month / 3) + 1;
  return `${quarter}_${year}`;
};

Results

┌─────────────┬──────────┐
│   (index)   │  Values  │
├─────────────┼──────────┤
│ speed-date  │ '1_2023' │
│ date-fns/fp │ '1_2023' │
│   custom    │ '1_2023' │
└─────────────┴──────────┘
speed-date x 3,932,161 ops/sec ±0.83% (90 runs sampled)
date-fns/fp x 385,284 ops/sec ±1.02% (91 runs sampled)
custom x 3,830,861 ops/sec ±1.02% (88 runs sampled)

🏁 🏁 🏁 'speed-date' is the fastest. 🏁 🏁 🏁

Summary Analysis

• speed-date runs as fast as the custom function
• fast-date-format doesn't support the Q format