Skip to content

mean (Lodash 互換性)

es-toolkitのmeanを使用してください

この mean 関数は型変換とnull/undefined処理により動作が遅くなります。

代わりに、より高速で現代的な es-toolkitmean を使用してください。

配列の平均値を計算します。

typescript
const average = mean(array);

参照

mean(array)

数値配列の平均値を計算します。

typescript
import { mean } from 'es-toolkit/compat';

// 数値配列
mean([1, 2, 3, 4, 5]);
// Returns: 3

mean([10, 20, 30]);
// Returns: 20

mean([1.5, 2.5, 3.5]);
// Returns: 2.5

空の配列はNaNを返します。

typescript
import { mean } from 'es-toolkit/compat';

mean([]);
// Returns: NaN

mean(null);
// Returns: NaN

mean(undefined);
// Returns: NaN

無効な値は0として扱われ、計算に含まれます。

typescript
import { mean } from 'es-toolkit/compat';

mean([1, undefined, 2, null, 3]);
// Returns: 1.2 (1 + 2 + 3) / 5 = 1.2

文字列は連結されます。

typescript
import { mean } from 'es-toolkit/compat';

mean(['1', '2', '3']);
// Returns: 41 (123 / 3 = 41)

パラメータ

  • array (ArrayLike<any> | null | undefined): 平均を計算する数値が含まれる配列です。

戻り値

(number): 配列の平均値を返します。空の配列の場合は NaN を返します。

MIT ライセンスの下で配布されています。