Skip to main content

HARMEAN

Returns the harmonic mean of a data set of positive numbers: the reciprocal of the arithmetic mean of reciprocals.

Syntax​

expression.HARMEAN(args);

expression - A variable that represents a ApiWorksheetFunction class.

Parameters​

NameRequired/OptionalData typeDefaultDescription
argsRequiredApiRange | number[] | ApiNameUp to 255 numeric values for which the harmonic mean will be calculated. Arguments can be numbers, names, ranges, or arrays of numbers.

Returns​

number

Example​

Calculate the harmonic mean of a set of positive numbers in a spreadsheet.

// How do I find the harmonic average for my data in a spreadsheet?

// Get the reciprocal of the average of reciprocals in a spreadsheet.

let worksheet = Api.GetActiveSheet();
let func = Api.WorksheetFunction;
let ans = func.HARMEAN(28, 16, 878, 800, 1650, 2000);
worksheet.GetRange("B2").SetValue(ans);