Skip to main content

TINV

Returns the two-tailed inverse of the Student's t-distribution.

Syntax

expression.TINV(arg1, arg2);

expression - A variable that represents a ApiWorksheetFunction class.

Parameters

NameRequired/OptionalData typeDefaultDescription
arg1RequiredApiRange | ApiName | numberThe probability associated with the two-tailed Student's t-distribution, a number between 0 and 1 inclusive.
arg2RequiredApiRange | ApiName | numberA positive integer indicating the number of degrees of freedom to characterize the distribution.

Returns

number

Example

Return the two-tailed inverse of the Student's t-distribution in a spreadsheet.

// Calculate the inverse t-value for a given probability and degrees of freedom.

// Apply the TINV function with probability and degrees of freedom parameters.

let worksheet = Api.GetActiveSheet();
let func = Api.WorksheetFunction;
let result = func.TINV(0.5, 10);
worksheet.GetRange("B2").SetValue(result);