date-fns の Common Helpers：min 関数で日付操作をもっと便利に

date-fns の Common Helpers における min 関数

min 関数は、複数の Date オブジェクトを受け取り、最も早い日付を返します。

使い方

import { min } from 'date-fns';

// 2つの日付オブジェクトを比較
const date1 = new Date(2024, 3, 19);
const date2 = new Date(2024, 3, 20);
const earliestDate = min(date1, date2);

console.log(earliestDate); // 2024-03-19T00:00:00.000Z

// 複数の Date オブジェクトを比較
const dates = [
  new Date(2024, 3, 15),
  new Date(2024, 3, 18),
  new Date(2024, 3, 17),
  new Date(2024, 3, 20),
];
const minDate = min(...dates);

console.log(minDate); // 2024-03-15T00:00:00.000Z

注意点

• min 関数は、Date オブジェクトのみを受け取ります。
• 比較される日付オブジェクトの時分秒は考慮されません。
• すべての Date オブジェクトが Invalid Date の場合は、min 関数は Invalid Date を返します。

応用例

• 締め切り日のリストから最も早い日付を取得する
• 予定の開始時間のリストから最も早い時間を取得する
• 複数のイベントの日程候補から最も早い日程を取得する

date-fns の min 関数を使ったサンプルコード

import { min } from 'date-fns';

const deadlines = [
  new Date(2024, 3, 25),
  new Date(2024, 3, 20),
  new Date(2024, 3, 22),
  new Date(2024, 3, 18),
];

const earliestDeadline = min(...deadlines);

console.log(earliestDeadline); // 2024-03-18T00:00:00.000Z

予定の開始時間のリストから最も早い時間を取得する

import { min } from 'date-fns';

const eventStartTimes = [
  new Date(2024, 3, 19, 10, 0),
  new Date(2024, 3, 19, 9, 30),
  new Date(2024, 3, 19, 11, 0),
  new Date(2024, 3, 19, 10, 30),
];

const earliestStartTime = min(...eventStartTimes);

console.log(earliestStartTime); // 2024-03-19T09:30:00.000Z

複数のイベントの日程候補から最も早い日程を取得する

import { min } from 'date-fns';

const eventDates = [
  new Date(2024, 4, 1),
  new Date(2024, 3, 25),
  new Date(2024, 4, 5),
  new Date(2024, 3, 20),
];

const earliestEventDate = min(...eventDates);

console.log(earliestEventDate); // 2024-03-20T00:00:00.000Z

特定の条件に合致する日付のリストから最も早い日付を取得する

import { min } from 'date-fns';
import { isWeekend } from 'date-fns';

const dates = [
  new Date(2024, 3, 20),
  new Date(2024, 3, 21),
  new Date(2024, 3, 22),
  new Date(2024, 3, 23),
];

const earliestWeekday = min(...dates.filter(date => !isWeekend(date)));

console.log(earliestWeekday); // 2024-03-20T00:00:00.000Z

比較する日付オブジェクトに時分秒を含める

import { min } from 'date-fns';

const date1 = new Date(2024, 3, 19, 10, 0);
const date2 = new Date(2024, 3, 19, 9, 30);

const earliestDate = min(date1, date2, {
  // 時分秒も比較する
  unit: 'second',
});

console.log(earliestDate); // 2024-03-19T09:30:00.000Z

すべての Date オブジェクトが Invalid Date の場合

import { min } from 'date-fns';

const dates = [
  new Date('invalid'),
  new Date('not a date'),
];

const minDate = min(...dates);

console.log(minDate); // Invalid Date

date-fns の min 関数以外の方法

手動で比較する

const date1 = new Date(2024, 3, 19);
const date2 = new Date(2024, 3, 20);

let earliestDate;

if (date1 < date2) {
  earliestDate = date1;
} else {
  earliestDate = date2;
}

console.log(earliestDate); // 2024-03-19T00:00:00.000Z

Array.prototype.sort() を使う

const dates = [
  new Date(2024, 3, 15),
  new Date(2024, 3, 18),
  new Date(2024, 3, 17),
  new Date(2024, 3, 20),
];

const sortedDates = dates.sort((a, b) => a - b);
const earliestDate = sortedDates[0];

console.log(earliestDate); // 2024-03-15T00:00:00.000Z

Lodash の minBy 関数を使う

import _ from 'lodash';

const dates = [
  new Date(2024, 3, 15),
  new Date(2024, 3, 18),
  new Date(2024, 3, 17),
  new Date(2024, 3, 20),
];

const earliestDate = _.minBy(dates, date => date);

console.log(earliestDate); // 2024-03-15T00:00:00.000Z

Moment.js の min 関数を使う

import moment from 'moment';

const dates = [
  moment('2024-03-15'),
  moment('2024-03-18'),
  moment('2024-03-17'),
  moment('2024-03-20'),
];

const earliestDate = moment.min(dates);

console.log(earliestDate.toDate()); // 2024-03-15T00:00:00.000Z

これらの方法はそれぞれ異なる長所と短所があります。

• 手動で比較する方法は最もシンプルですが、比較する日付オブジェクトの数が多い場合は時間がかかります。
• Array.prototype.sort() を使う方法は比較的シンプルで効率的ですが、ソートアルゴリズムの知識が必要です。
• Lodash や Moment.js などのライブラリを使う方法は、コードが簡潔になりますが、ライブラリの追加読み込みが必要です。