Benchmark: JS Date libraries 3

HTML Preparation code:

<script src="https://cdn.jsdelivr.net/npm/luxon@1.26.0/build/global/luxon.min.js"></script>
<script src="https://unpkg.com/dayjs@1.8.21/dayjs.min.js"></script>
<script src="https://unpkg.com/dayjs@1.8.21/plugin/isBetween.js"></script>

Script Preparation code:

dayjs.extend(window.dayjs_plugin_isBetween)
window.__date__ = new Date('2000-01-06T03:24:11');
window.__another_date__ = new Date('2000-01-30T03:24:11');
window.__another_month__ = new Date('2000-02-01T00:00:00');
window.__another_year__ = new Date('1999-01-06T03:24:11');
window.__saturday__ = new Date('2021-05-01T03:24:11');
window.__sunday__ = new Date('2021-05-02T03:24:11');
window._expected_string = '2000/01/06';
window._expected_start = '2000/01/01';
window._expected_end = '2000/01/31';
window._expected_day_of_week = 1;

window.unix = (date) => {
    return date.valueOf() / 1000;
  }

window.diffDate = (date1, date2, unit) => {
    const date1Unix = unix(date1);
    const date2Unix = unix(date2);

    switch (unit) {
      case "minute":
        return (date1Unix - date2Unix) / 60;
      case "hour":
        return (date1Unix - date2Unix) / 3600;
      case "day":
        return (date1Unix - date2Unix) / 86400;
      case "week":
        return (date1Unix - date2Unix) / 604800;
    }
  }

Tests:

luxon
var date1 = luxon.DateTime.fromJSDate(__date__); var date2 = luxon.DateTime.fromJSDate(__another_date__); date1.diff(date2, "minute"); date1.diff(date2, "hour"); date1.diff(date2, "day"); date1.diff(date2, "week");
dayjs
var date1 = dayjs(__date__); var date2 = dayjs(__another_date__); date1.diff(date2, "minute"); date1.diff(date2, "hour"); date1.diff(date2, "day"); date1.diff(date2, "week");
vanilla
var date1 = __date__; var date2 = __another_date__; diffDate(date1, date2, "minute"); diffDate(date1, date2, "hour"); diffDate(date1, date2, "day"); diffDate(date1, date2, "week");

Rendered benchmark preparation results:

Suite status: <idle, ready to run>

Previous results

Test case name	Result
luxon
dayjs
vanilla

Fastest: N/A

Slowest: N/A

Autogenerated LLM Summary (model gpt-4o-mini, generated 7 days ago):

LLMs can make mistakes. Check important info.

The benchmark defined in the provided JSON files compares the performance of two JavaScript date libraries: **Luxon** and **Day.js**. Specifically, it focuses on measuring how efficiently each library can calculate the difference between two dates.

### Libraries and Their Purpose

1. **Luxon**:
   - Luxon is a modern JavaScript library for working with dates and times. It offers a comprehensive API for handling various date and time operations, including parsing, formatting, and manipulation of dates. One of its strengths is built-in support for time zones and internationalization.

2. **Day.js**:
   - Day.js is a lightweight date manipulation library that offers a similar API to Moment.js but in a smaller package. It is designed to be simple and efficient, with a minimalistic approach to managing dates. Day.js provides methods for parsing, formatting, and manipulating dates, and it also supports plugins for extended functionality.

### Benchmark Details

The benchmark consists of two primary test cases:

- **Test Case for Luxon**: 
  - In this test, two DateTime objects are created from JavaScript Date objects using `luxon.DateTime.fromJSDate()`. The benchmark then calculates the difference between these two dates in both minutes and days using the `diff()` method.

- **Test Case for Day.js**: 
  - Similarly, two Day.js objects are instantiated from JavaScript Date objects. The test measures the difference between these two dates in minutes and days using the `diff()` method.

### Performance Metrics

The benchmark results indicate the number of executions per second achieved by each of the two libraries:

- **Luxon**: ~115,990 executions per second
- **Day.js**: ~114,871 executions per second

### Pros and Cons

#### Luxon:
- **Pros**:
  - Richer feature set with time zone support and robust formatting options.
  - Provides a modern API that can handle complex date and time manipulations.
  
- **Cons**:
  - Larger in size compared to Day.js, which may affect load times in web applications.
  
#### Day.js:
- **Pros**:
  - Very lightweight and quick, making it ideal for applications where performance and size are critical.
  - Simple and intuitive API, easing the learning curve for new users.

- **Cons**:
  - Lacks some of the more advanced features that Luxon offers, such as comprehensive time zone handling.
  - Time zone support requires additional plugins.

### Other Considerations
When deciding between these libraries, developers should consider their application's specific needs. For simpler tasks where performance and size are crucial, Day.js may be more suitable. However, if your application requires extensive date manipulation, including time zones and localization, Luxon could provide the necessary functionality.

### Alternatives
Other popular JavaScript date libraries that could be alternative options include:

- **Moment.js**: Once a standard for date manipulation in JavaScript, it has seen a decline in usage due to its large size and is considered essentially "legacy" as the community is encouraged to move to more efficient libraries like Luxon or Day.js.
- **date-fns**: This library offers a functional programming approach with modular imports, allowing developers to only include the functions they need, which can be more efficient in terms of bundle size.
- **JS-Joda**: This is a date and time library that mimics Java 8's time API, making it a precise alternative with strong handling of date/time without the issues of mutable state.

In conclusion, the benchmark provides a clear comparison of how Luxon and Day.js perform in terms of executing date difference calculations, allowing developers to make informed decisions based on their application's requirements.

Latest run results:

Run details: (Test run date: 7 days ago)

User agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36

Browser/OS: Chrome 130 on Mac OS X 10.15.7

View result in a separate tab

Test name	Executions per second
luxon	50875.0 Ops/sec
dayjs	59406.8 Ops/sec
vanilla	2251942.0 Ops/sec

Related benchmarks:

JS Date libraries 3 (version: 3)

Comparing performance of: luxon vs dayjs vs vanilla

Created: 8 days ago by: Registered User

Jump to the latest result

luxon

dayjs

vanilla

Suite status: <idle, ready to run>

Experimental features:

Fastest: N/A

Slowest: N/A

Autogenerated LLM Summary (model gpt-4o-mini, generated 7 days ago):