Documentation/Calc Functions/IMARGUMENT/en

Function name:
IMARGUMENT

Category:
Add-in

Summary:
Calculates the principal value of the argument of a complex number.

Syntax:
IMARGUMENT(ComplexNumber)

Returns:
Returns a real number in the range -&pi; < φ ≤ &pi; which is the argument (in radians) of the specified complex number.

Arguments:
ComplexNumber is a string (in quotation marks) representing a complex number in the form a+bi or a+bj, or a reference to a cell containing that string, whose argument is to be calculated. a and b are real numbers.


 * If ComplexNumber does not have an imaginary part (b equal to 0), the real part can be passed to IMARGUMENT as a number rather than a string.
 * If both real and imaginary parts of ComplexNumber are 0, IMARGUMENT reports an invalid argument error (Err:502).
 * If ComplexNumber is not a valid complex number, IMARGUMENT reports an invalid argument error (Err:502).

Details specific to IMARGUMENT function
A complex number of the form a+bi can be written in trigonometric form as a+bi = r(cosφ+isinφ), where r is the absolute value or modulus of the complex number and φ is its argument.

IMARGUMENT calculates the argument of the complex number using the formula: and then if b < 0, φ = -φ.

For more information about arguments of complex numbers, visit Wikipedia's Argument (complex analysis) page.

Related LibreOffice functions:
IMABS

IMAGINARY

IMREAL

ODF standard:
Section 6.8.5, part 2

Equivalent Excel functions:
IMARGUMENT