IMPOWER in ONLYOFFICE: Complex-number powers with Examples
Learn IMPOWER in ONLYOFFICE Spreadsheet Editor with official syntax, a reproducible complex-number worksheet, checked mathematical examples, troubleshooting and compatibility cautions.
Verification status: See the evidence and test scope described in this guide. How formula examples are checked
Quick answer: IMPOWER raises a complex number to the requested power. The official ONLYOFFICE reference documents the formula =IMPOWER(inumber, number). This article describes mathematical expectations, not results obtained from the ONLYOFFICE application.
Verification: Examples are independently calculated mathematical expectations. Native ONLYOFFICE Desktop and Docs web execution was not performed.
Availability and version history
- Introduced: The original introduction version and date are not established by the official sources checked.
- Availability: Documented in the current ONLYOFFICE Spreadsheet Editor help; no final working-version endpoint is established.
- Scope: Docs and Desktop Editors release separately. This unversioned help does not establish availability in every older build, mobile client or deployment.
- Checked: October 14, 2026, against the official function reference. Documentation check; not a new native test.
Exact syntax, arguments, types and defaults
=IMPOWER(inumber, number)
| Argument | Required? | Meaning and type | Default |
|---|---|---|---|
| inumber | Required | Complex base expressed in x + yi or x + yj form | No default |
| number | Required | Power/exponent to apply to the complex base; numerical exponent | No default |
All arguments shown above are required; the official function page does not describe optional parameters or assumed defaults. inumber is a complex number of the form x+yi or x+yj; the suffix i/j is a lowercase complex unit. Build inputs with COMPLEX(real_num,i_num,[suffix]) rather than typing nonnumeric text into real/imaginary input cells. COMPLEX assumes i if suffix is omitted. The optional square brackets in its documentation mean optional, not literal characters.
ONLYOFFICE documents manual entry with a leading = and comma-separated arguments in its Insert functions instructions. These examples use English names and comma separators; check actual regional settings before copying the formulas into localized environments. The exact tokenized spelling of localized functions and separators has not been tested.
Step-by-step reproducible worksheet
- Open a new empty spreadsheet in ONLYOFFICE Spreadsheet Editor. Type the headings
Scenario,Real,Imaginary,Unit,Exponent,Complex value,Resultin cells A1:G1 respectively. - Enter the data below into A2:E11. Enter real and imaginary coefficients as numbers, not strings. In C10, enter the actual formula
=PI()/2so that row 10 is reproducible to spreadsheet precision. - Type
=COMPLEX(B2,C2,D2)in F2 and fill down through F11. F2 is mathematically3+4i; the exact text serialization may omit zero terms or unit coefficients. - Type the formula indicated below in G2 and fill it down through G11. The examples use the input suffix for notation only; native suffix propagation and output formatting remain unverified.
- Compare results to the mathematical expectations below. A small numerical difference from a decimal approximation can come from floating-point precision, complex-number branch handling or output formatting. Do not claim that the test passed natively until somebody runs it in the target edition.
| Row | Scenario | B: real | C: imaginary | D: suffix | E: power | Mathematical complex input |
|---|---|---|---|---|---|---|
| 2 | Impedance | 3 | 4 | i |
2 | 3+4i |
| 3 | Real unity | 1 | 0 | i |
3 | 1 |
| 4 | Quarter-turn | 0 | 1 | i |
4 | 1i |
| 5 | Negative real | -1 | 0 | i |
3 | -1 |
| 6 | Quadrant II | -2 | 3 | i |
2 | -2+3i |
| 7 | Electrical notation | 0 | -2 | j |
-1 | -2j |
| 8 | Mixed signs | 2 | -1 | j |
2 | 2-1j |
| 9 | Zero input | 0 | 0 | i |
-1 | 0 |
| 10 | Half-pi angle | 0 | =PI()/2 |
i |
2 | 1.5707963268i |
| 11 | Real four | 4 | 0 | i |
0 | 4 |
For G2, enter =IMPOWER(F2,E2). Fill down to G11. Row 9 is a deliberate zero-input edge case; it is not a successful logarithm or negative-power calculation.
Expected mathematical outputs (independent calculations)
| Row | Enter in column G | Mathematical expected result | Calculation context |
|---|---|---|---|
| 2 | =IMPOWER(F2,E2) |
-7+24i |
principal mathematical value, not a confirmed editor output |
| 3 | =IMPOWER(F3,E3) |
1 |
principal mathematical value, not a confirmed editor output |
| 4 | =IMPOWER(F4,E4) |
1 |
principal mathematical value, not a confirmed editor output |
| 5 | =IMPOWER(F5,E5) |
-1 |
principal mathematical value, not a confirmed editor output |
| 6 | =IMPOWER(F6,E6) |
-5-12i |
principal mathematical value, not a confirmed editor output |
| 7 | =IMPOWER(F7,E7) |
0.5j |
principal mathematical value, not a confirmed editor output |
| 8 | =IMPOWER(F8,E8) |
3-4j |
principal mathematical value, not a confirmed editor output |
| 9 | =IMPOWER(F9,E9) |
mathematically undefined (no claimed editor error) | no finite complex logarithm / power; native response unknown |
| 10 | =IMPOWER(F10,E10) |
-2.4674011003 |
principal mathematical value, not a confirmed editor output |
| 11 | =IMPOWER(F11,E11) |
1 |
principal mathematical value, not a confirmed editor output |
Verification method: two independent Python numeric pathways (cmath double-precision and mpmath 65-digit complex arithmetic) agreed within the declared relative/absolute tolerance for every defined example. This checks algebra, not the spreadsheet engine, its display text, exact error messages or formula parser.
Why it works: mathematical explanation
For positive integer exponents, repeated multiplication gives an unambiguous complex power. For noninteger exponents, a mathematical complex power needs a branch convention; the vendor reference does not explain its exact runtime branch behaviour.
For an integer n, multiply the complex base by itself n times (for n<0, take the reciprocal of its positive power, requiring a nonzero base). For a noninteger real exponent p, the conventional principal expectation is exp(p·Log(z)); this is not a verified implementation contract.
For z=3+4i, squaring yields (3+4i)²=9+24i−16=−7+24i. For negative exponent −1, the independent reciprocal is (3−4i)/25.
The equations describe the mathematical operation normally associated with this function. They are not proof of native ONLYOFFICE behaviour at a branch cut or near machine-precision limits. The official vendor reference describes the function purpose and basic syntax but omits some branch/error details.
Advanced use and proposed formula checks
The advanced power examples distinguish ordinary integer algebra from principal-branch mathematical predictions.
| Formula to enter in an unused cell | Independently expected mathematical result | Why it matters |
|---|---|---|
=IMPOWER(COMPLEX(3,4,"i"),2) |
-7+24i |
Square: −7+24i exactly. |
=IMPOWER(COMPLEX(3,4,"i"),3) |
-117+44i |
Cube: −117+44i exactly. |
=IMPOWER(COMPLEX(3,4,"i"),-1) |
0.12-0.16i |
Reciprocal: 3/25−4/25i. |
=IMPOWER(COMPLEX(0,1,"i"),4) |
1 |
Fourth power of i equals 1. |
=IMPOWER(COMPLEX(-1,0,"i"),3) |
-1 |
Negative real cubed. |
=IMPOWER(COMPLEX(1,1,"i"),0) |
1 |
Nonzero base to the power zero. |
=IMPOWER(COMPLEX(4,0,"i"),0.5) |
2 |
Positive real square root; fractional support not confirmed natively. |
=IMPOWER(COMPLEX(-1,0,"i"),0.5) |
1i |
Principal mathematical square root is i; native branch not confirmed. |
=IMPOWER(COMPLEX(2,-1,"j"),2) |
3-4j |
j-notation square: 3−4j. |
=IMPOWER(COMPLEX(2,0,"i"),-2) |
0.25 |
Negative integer exponent gives 0.25. |
=IMPOWER(COMPLEX(0,0,"i"),-1) |
mathematically undefined (no claimed editor error) | Zero to a negative power: undefined mathematically. |
Advanced application and practical interpretation
Integer complex powers appear in polynomial transforms and electrical calculations. Negative integer powers require nonzero inputs. Fractional powers may select a branch, so cross-editor comparisons must check actual native results.
Compare two ways without overstating what is tested
To inspect a complex output numerically, place =IMREAL(G2) and =IMAGINARY(G2) in blank cells. Their official real-component and imaginary-component references describe the operations. Comparing numeric components avoids making assumptions about whether the editor prints i, 1i, j, extra zeros or rounded decimals. This is a recommended future native test, not an executed verification.
Errors, limits and troubleshooting
Input format: A typical input such as 3+4i should be constructed with =COMPLEX(3,4,"i"). 3+4i volts, a mixed i/j string, unquoted suffix arguments and a typed formula lacking = are not shown as valid inputs by the vendor. A cell that visually looks numeric may contain text.
Domain and precision: A zero base with negative exponent is mathematically undefined; zero raised to zero depends on convention and is not assigned an editor result here. Noninteger powers of negative or nonreal inputs require a branch selection.
Boundary caution: Official documentation states the arguments and purpose but not all allowed exponent types, branches, zero cases or exact error codes. Fractional and zero edge cases must be native-tested rather than presented as verified ONLYOFFICE behaviour.
Troubleshooting checklist:
- Confirm the real and imaginary components in B and C are numeric and that D contains the lowercase unit
iorj. - Use the Insert Function window to confirm the target installation recognizes the exact English function name.
- Check the parentheses, leading
=, comma separators and argument order. Test the single-cell literal formula from the advanced table before dragging down a column. - If a result differs from the expected mathematical value, inspect the real and imaginary components separately and compare with a reasonable decimal tolerance.
- For zero-input, negative-real branch-cut, fractional exponent, large-magnitude and regional settings cases, record what the actual target build does. No
#NUM!,#VALUE!or other exact error is claimed without an observed native test. - If recalculation is stale, ONLYOFFICE documents the Calculation control on the Formula tab and F9 for workbook recalculation in its Insert Functions guide; inspect the build-specific UI before assuming identical keyboard shortcuts across systems.
ONLYOFFICE editions and historical versions
The current unversioned ONLYOFFICE Docs Spreadsheet Editor Help Center lists this function and describes its syntax. This is vendor-documentation evidence, not a tested claim that every Docs server, hosted web editor, Desktop Editors version, mobile build or locale supports it. The Docs changelog and the separate Desktop Editors changelog were consulted on 2026-10-13 (UTC), but the inspected material did not establish an attributable first supported release for this function. Therefore minimum Docs/Desktop version: unknown.
Export/import and Excel or Google Sheets compatibility are not established by the ONLYOFFICE help page. Another spreadsheet’s formula behaviour, rounding, error messages or complex-number branch choice cannot serve as ONLYOFFICE execution evidence. Verify in each target application and format before migrating a workbook.
Related resources and links
- IMPOWER official reference — exact documented purpose, English syntax and argument type.
- COMPLEX official reference — construct
i- orj-suffixed complex values for input. - IMREAL official reference — interpret expected real output component.
- IMAGINARY official reference — interpret expected imaginary coefficient.
- IMABS official reference — interpret magnitudes; contains its own separate documentation.
- IMARGUMENT official reference — interpret phase angles in radians.
- ONLYOFFICE function catalogue and entry instructions — category navigation and manual formula entry.
- Docs changelog and Desktop Editors changelog — independently maintained release histories.
Official references and dated claim-level evidence
| Claim | Evidentiary basis | Checked |
|---|---|---|
| Function name, purpose, English syntax and argument descriptions | Official IMPOWER reference | 2026-10-13 (UTC) |
COMPLEX construction and lowercase i/j suffix, default i |
COMPLEX reference | 2026-10-13 (UTC) |
Formula entry with = and commas, access via Formula tab |
Insert functions | 2026-10-13 (UTC) |
| Current Docs versus Desktop release histories are distinct; first supported version not established | Docs changelog, Desktop changelog | 2026-10-13 (UTC) |
| Expected mathematical values (including principal-branch assumptions) | cmath and 65-digit mpmath independent calculations |
2026-10-13 (UTC) |
| Native application execution, localized syntax, exact error codes and historical version matrix | Not tested / not established | Not applicable |