IMTAN Function (Calligra Sheets)
Use complex tangent in Calligra Sheets, with radian arguments, quotient checks and explicit large finite values near rounded pole locations.
Verification status: 18 selected formulas were executed through the Calligra Sheets 25.04.2 calculation engine library. Complex outputs are reported as components, not GUI-cell display. Version 26.08.2 was source-checked only. How formula examples are checked
Quick answer: =IMTAN(COMPLEX(3;4)) gives (-0.000187346205,0.999355987381) in the tested Calligra calculation engine. The pair gives the real and imaginary components, not worksheet display text.
Availability and version history
- Introduced: First release not established; the name is present in Calligra 2.4.0 source.
- Supported in: Calligra Sheets 26.08.2, with no retirement established.
- Scope: Desktop Sheets with the Engineering module. Examples use English semicolon-separated formulas.
- Checked: October 14, 2026. Formulas were executed through the official 25.04.2 engine library and checked against source and independent mathematics. This is not GUI-cell or workbook-import evidence; 26.08.2 was source-checked, not executed.
What IMTAN returns
IMTAN returns tan(z), mathematically sin(z)/cos(z) wherever the denominator is nonzero. Complex tangent can have real and imaginary components even when a real tangent analogy is tempting. Its poles occur at real z = π/2 + kπ for integer k. Function help.
Syntax and arguments
=IMTAN(complexValue)
Exactly one complex argument is required. Construct both components with COMPLEX(real;imaginary) when working from numeric cells. A numeric argument is purely real; angles are in radians. Registration and implementation, with versioned help.
Reproducible engine examples
Results are shown as (real,imaginary) component pairs, rounded to twelve decimal places, not a literal cell format. Tiny or very large values use thirteen significant digits in scientific notation. A component rounded to zero is shown as 0; the stored value may still contain a tiny residual or signed zero. NaN means not-a-number; infinity and NaN are not finite results.
| Formula | Engine result |
|---|---|
=IMTAN(COMPLEX(3;4)) |
(-0.000187346205,0.999355987381) |
=IMTAN(COMPLEX(3;-4)) |
(-0.000187346205,-0.999355987381) |
=IMTAN(COMPLEX(-3;4)) |
(0.000187346205,0.999355987381) |
=IMTAN(COMPLEX(-3;-4)) |
(0.000187346205,-0.999355987381) |
=IMTAN(COMPLEX(1;0)) |
(1.557407724655,0) |
=IMTAN(COMPLEX(0;1)) |
(0,0.761594155956) |
=IMTAN(COMPLEX(-1;0)) |
(-1.557407724655,0) |
=IMTAN(COMPLEX(0.5;0.25)) |
(0.504500702699,0.312420692503) |
Practical worksheet
For z = i, tan(i) = i tanh(1), approximately 0+0.761594155956i. The imaginary part is positive even though there is no real input angle. The table also shows the sign changes from conjugate and negated arguments.
With the components in A2:B2, =IMTAN(COMPLEX(A2;B2)) preserves the intended complex input. Do not replace this by TAN(A2)/TAN(B2), which has neither the same definition nor the same domain.
Advanced interpretation and checks
For z = 0.5+0.25i, the executed difference between IMTAN(z) and IMDIV(IMSIN(z);IMCOS(z)) had zero real component and imaginary residual about −2.710505431214E−20. It confirms the quotient relation for this ordinary case, allowing for finite precision.
On the imaginary axis tan(ib)=i tanh(b), which stays below magnitude 1 for finite real b. That special-axis behavior is not a bound on complex tangent everywhere: near a real pole the magnitude can be very large.
The exact advanced-check formula was:
=IMSUB(IMTAN(COMPLEX(0.5;0.25));IMDIV(IMSIN(COMPLEX(0.5;0.25));IMCOS(COMPLEX(0.5;0.25))))
Input boundaries and cautions
IMTAN(PI()/2) returned a large finite real component, approximately 1.633123935320E16. The exact function has a pole at mathematical π/2; the finite value reflects the rounded input’s distance from that pole and must not be treated as a finite exact tangent at the pole.
Invalid or empty text became complex zero, and its tangent became zero without an engine error flag. Wrong argument counts did produce #VALUE!. These are different failure modes.
| Formula | Engine result |
|---|---|
=IMTAN("3+4i") |
(-0.000187346205,0.999355987381) |
=IMTAN("3+4j") |
(-0.000187346205,0.999355987381) |
=IMTAN("abc") |
(0,0) |
=IMTAN("") |
(0,0) |
=IMTAN(TRUE()) |
(1.557407724655,0) |
=IMTAN(0) |
(0,0) |
=IMTAN() |
#VALUE! |
=IMTAN(1;2) |
#VALUE! |
=IMTAN(PI()/2) |
(1.63312393532E+16,0) |
Conversion evidence
The complex conversion helper explains the text and Boolean cases above. The inspected Engineering module and complex converter are byte-identical between 25.04.2 and 26.08.2. That source comparison does not establish every locale, import path or extreme-value case.
Related guides
Use COMPLEX to construct values from numeric components, IMABS for magnitude, and IMARGUMENT for principal phase.