【フロントエンドエンジニア必見】date-fns hoursToMinutesで時間を分に変換する方法

date-fnsのConversion HelpersにおけるhoursToMinutes関数解説

date-fnsライブラリのConversion Helpersは、日付と時刻の操作を簡潔に行うための関数群を提供します。その中のhoursToMinutes関数は、時間数を分に変換する関数です。

使い方

import { hoursToMinutes } from 'date-fns';

const hours = 2;
const minutes = hoursToMinutes(hours); // 120

console.log(minutes); // 120

引数

• hours: 変換したい時間数を表す数値

戻り値

• hoursを分に変換した数値

詳細

• 1時間は60分なので、hoursToMinutes関数は引数として渡された数値に60を掛けて変換を行います。
• 変換結果は整数になります。
• 引数として負の数値を渡すことも可能です。

例

hoursToMinutes(1.5); // 90
hoursToMinutes(-2); // -120

補足

• hoursToMinutes関数は、date-fnsライブラリの他のConversion Helpers関数と組み合わせて使用することができます。
• 例えば、addMinutes関数と組み合わせて、指定された時間数に分の単位で時間を加算することも可能です。

import { hoursToMinutes, addMinutes } from 'date-fns';

const hours = 2;
const minutes = hoursToMinutes(hours);
const newDate = addMinutes(new Date(), minutes);

console.log(newDate); // 現在の時刻に2時間分を加算した日時

hoursToMinutes関数のサンプルコード

単純な変換

import { hoursToMinutes } from 'date-fns';

const hours = 2;
const minutes = hoursToMinutes(hours);

console.log(minutes); // 120

負の時間の変換

const hours = -2;
const minutes = hoursToMinutes(hours);

console.log(minutes); // -120

小数点以下の時間の変換

const hours = 1.5;
const minutes = hoursToMinutes(hours);

console.log(minutes); // 90

addMinutes関数との組み合わせ

import { hoursToMinutes, addMinutes } from 'date-fns';

const hours = 2;
const minutes = hoursToMinutes(hours);
const newDate = addMinutes(new Date(), minutes);

console.log(newDate); // 現在の時刻に2時間分を加算した日時

時間と分の複合的な変換

import { hoursToMinutes, addMinutes, format } from 'date-fns';

const hours = 2;
const minutes = 30;
const totalMinutes = hoursToMinutes(hours) + minutes;
const newDate = addMinutes(new Date(), totalMinutes);

console.log(format(newDate, 'yyyy-MM-dd HH:mm')); // 2024-03-24 03:00

• 上記のコードは、あくまでもサンプルです。必要に応じて修正してください。
• date-fnsライブラリには、他にも様々なConversion Helpers関数があります。詳しくは公式ドキュメントを参照してください。

時間を分に変換する他の方法

手計算

1時間は60分なので、時間を分に変換するには、時間数を60倍します。

例：

• 2時間 = 2 * 60 = 120分
• 3.5時間 = 3.5 * 60 = 210分

JavaScriptの組み込み関数

JavaScriptには、時間を分に変換する組み込み関数は存在しません。

ライブラリの利用

date-fnsライブラリ以外にも、時間を分に変換する機能を提供しているライブラリがあります。

これらのライブラリは、hoursToMinutes関数のような時間変換機能だけでなく、日付と時刻の操作に関する様々な機能を提供しています。

自作関数

必要に応じて、時間を分に変換する自作関数を定義することも可能です。

function hoursToMinutes(hours) {
  return hours * 60;
}

const hours = 2;
const minutes = hoursToMinutes(hours);

console.log(minutes); // 120

• 簡単な変換であれば、手計算で十分です。
• より複雑な変換や、他の日付と時刻の操作を行う場合は、ライブラリの利用を検討すると良いでしょう。
• 独自の機能が必要であれば、自作関数を定義することも可能です。