WorksheetFunction.TInv Method

Excel Developer Reference

Returns the t-value of the Student's t-distribution as a function of the probability and the degrees of freedom.

Syntax

expression.TInv(Arg1, Arg2)

expression   A variable that represents a WorksheetFunction object.

Parameters

Name Required/Optional Data Type Description
Arg1 Required Double Probability - the probability associated with the two-tailed Student's t-distribution.
Arg2 Required Double Degrees_freedom - the number of degrees of freedom with which to characterize the distribution.

Return Value
Double

Remarks

  • If either argument is nonnumeric, TINV returns the #VALUE! error value.

  • If probability < 0 or if probability > 1, TINV returns the #NUM! error value.

  • If degrees_freedom is not an integer, it is truncated.

  • If degrees_freedom < 1, TINV returns the #NUM! error value.

  • TINV returns that value t, such that P(|X| > t) = probability where X is a random variable that follows the t-distribution and P(|X| > t) = P(X < -t or X > t).

  • A one-tailed t-value can be returned by replacing probability with 2*probability. For a probability of 0.05 and degrees of freedom of 10, the two-tailed value is calculated with TINV(0.05,10), which returns 2.28139. The one-tailed value for the same probability and degrees of freedom can be calculated with TINV(2*0.05,10), which returns 1.812462.

    Bb239804.vs_note(en-us,office.12).gif  Note
    In some tables, probability is described as (1-p).

    Given a value for probability, TINV seeks that value x such that TDIST(x, degrees_freedom, 2) = probability. Thus, precision of TINV depends on precision of TDIST. TINV uses an iterative search technique. If the search has not converged after 100 iterations, the function returns the #N/A error value.

See Also