CSCH Function in ONLYOFFICE Spreadsheet Editor: Syntax, Examples and Compatibility
Use CSCH in ONLYOFFICE with practical numeric examples, SINH reciprocal checks, zero handling, symmetry and numerical limitations.
Verification status: Official documentation referenced; example outcomes independently reasoned or arithmetically checked where stated. Not executed in ONLYOFFICE Spreadsheet Editor. How formula examples are checked
Quick answer: Compute the hyperbolic cosecant, the reciprocal of hyperbolic sine, for a nonzero numeric argument. This guide provides copyable formulas, a small reproducible worksheet, advanced worked uses, restrictions, and vendor-source evidence.
Availability, environment, and scope
The named function and the syntax below are in the current, unversioned English ONLYOFFICE Docs Spreadsheet Editor documentation reviewed on 13 October 2026 (UTC). This is documentary support for the current reference, not a successful execution test in ONLYOFFICE Docs/web or Desktop Editors, and it is not a claim of support in all earlier versions, hosting editions, mobile apps, or imported Excel workbooks. The Docs changelog lists version 10.0.0 dated 10 October 2026; that changelog does not identify these particular functions as newly introduced in 10.0. Desktop release history is maintained separately, and no first-supported Desktop/web version has been established for this function.
Verification labels used in this guide: vendor documented = stated in a linked ONLYOFFICE source; independently calculated expectation = calculated outside ONLYOFFICE using mathematics/Python; native result = none obtained. Illustrations/screenshots were not fabricated or substituted for actual tests.
Exact formula syntax
=CSCH(number)
number(required, numeric): One required numeric argument, documented as a radian-valued angle, with |number| < 2Β²β· in the official ONLYOFFICE reference. No optional arguments and no default.- Argument order: one positional numeric argument only. Optional arguments/defaults: none.
- Return type: numeric real value for an in-domain mathematical input; the exact cell display can vary with number format.
- Mathematical domain: All real nonzero numeric arguments respecting the vendor |number| < 2Β²β· restriction. Zero is a mathematical singularity.
- Principal range / behaviour: For real nonzero inputs, the mathematical value is nonzero, with the sign of the input. Positive values decay toward zero as the input increases, and negative values approach zero from below as input decreases.
- Units: The official reference describes the argument as an angle in radians; mathematical hyperbolic sine typically takes a dimensionless scalar. Do not confuse this with the circular CSC function, which reciprocates SIN.
Mathematical interpretation: csch(x)=1/sinh(x)=2/(e^xβe^(βx)). It is odd: csch(βx)=βcsch(x). Mathematical checks use Python, not ONLYOFFICE execution.
Reproducible worksheet: enter inputs and compare outputs
- Create an empty spreadsheet in the ONLYOFFICE Spreadsheet Editor, using its English formula language for the formulas shown.
- Enter the numbers exactly as shown in the Input in A column below, beginning in A2 and going down one row per example; do not include the units, symbols, or quotation marks as part of the values.
- In B2, enter
=CSCH(A2), press Enter, and fill the formula down the column. Numeric cells can be formatted to show ten decimal places. - Compare your result to the independently calculated expectation, allowing for display rounding and floating-point arithmetic. This guide does not claim that steps 1β3 were executed in either ONLYOFFICE product.
| Cell | Input in A | Formula in B | Expected result (approx.) |
|---|---|---|---|
| A2 β B2 | -3 |
=CSCH(A2) |
-0.0998215697 |
| A3 β B3 | -2 |
=CSCH(A3) |
-0.2757205648 |
| A4 β B4 | -1 |
=CSCH(A4) |
-0.8509181282 |
| A5 β B5 | -0.5 |
=CSCH(A5) |
-1.9190347513 |
| A6 β B6 | 0.5 |
=CSCH(A6) |
1.9190347513 |
| A7 β B7 | 1 |
=CSCH(A7) |
0.8509181282 |
| A8 β B8 | 2 |
=CSCH(A8) |
0.2757205648 |
| A9 β B9 | 3 |
=CSCH(A9) |
0.0998215697 |
| A10 β B10 | 0.69314718056 |
=CSCH(A10) |
1.3333333333 |
Interpreting the table: values are independent mathematical expectations rounded for readability, not screenshots or verified calculations performed in ONLYOFFICE. Values at very small magnitude may display in scientific notation when the worksheet format changes.
Step-by-step advanced examples: CSCH in practical work
1. Validate against SINH
Set up: Enter D2 = 1, use =CSCH(D2) in E2 and =1/SINH(D2) in F2.
Expected output: Both β 0.8509181282 (independently calculated, not native-tested).
Why it works: The independent reciprocal relationship is the easiest manual cross-check.
2. Verify the odd symmetry
Set up: Enter D3 = 2, =CSCH(-D3) in E3 and =-CSCH(D3) in F3.
Expected output: Both β β0.2757205648 (independently calculated, not native-tested).
Why it works: Changing the sign of the input changes the output sign, preserving magnitude.
3. Safe calculation when the variable can be zero
Set up: Set D4 = 0 and enter =IF(D4=0,"undefined at zero",CSCH(D4)) in E4.
Expected output: The intended text branch: undefined at zero (independently calculated, not native-tested).
Why it works: This makes the worksheet readable for users and avoids relying on an untested application-specific error message.
4. A natural-logarithm identity
Set up: Enter =CSCH(LN(2)) in E5.
Expected output: β 1.3333333333 (4/3) (independently calculated, not native-tested).
Why it works: Because sinh(ln 2)=3/4, its reciprocal is 4/3. This is an independent algebraic fixture.
5. Check the reciprocal product
Set up: Enter =CSCH(2)*SINH(2) in E6.
Expected output: 1 within floating-point precision (independently calculated, not native-tested).
Why it works: The product is mathematically 1 for nonzero finite x; tiny rounding differences may occur.
Errors, edge cases, and troubleshooting
| Symptom or situation | Likely mathematical/documentation reason | Suggested check |
|---|---|---|
| Zero input | sinh(0)=0, so its reciprocal does not exist. | Guard with IF; exact editor error messages require native execution. |
| Result shrinks toward zero | Hyperbolic sine grows rapidly with positive x, so CSCH becomes tiny. | Add decimal places or scientific notation; do not treat rounded zero as an exact zero. |
| Unexpected negative result | CSCH is an odd function, preserving the sign of a nonzero input. | Inspect the sign of the source cell. |
| Very large absolute input | Official documentation imposes ABS(number)<2Β²β·; finite floating-point overflow/underflow is also possible. | Avoid extrapolating exact results at extreme magnitudes without native testing. |
| Confusing CSCH with CSC | CSC is reciprocal circular sine; CSCH is reciprocal hyperbolic sine. | Use SINH rather than SIN when independently checking CSCH. |
Error-code caution: ONLYOFFICE documentation for this function does not establish exact error strings for every invalid input, coercion, overflow, or version. Thus this guide does not assert #NUM!, #DIV/0!, or other codes as observed in ONLYOFFICE. Record actual native outputs and version/edition before relying on undocumented error behavior.
Formula language, separators, and compatibility
The examples use English function names, decimal points and (where needed) comma-separated arguments. The official Insert Function guide explains that manual formulas begin with = and that arguments are separated by commas in its English instructions. The Advanced Settings page documents configurable formula language and regional decimal/thousands separators. Neither source establishes how this exact function was spelled or evaluated for every locale. Do not rewrite formulas using a different locale based only on habits from another spreadsheet program.
The vendor distinguishes the web/Docs editor from Desktop Editors and maintains separate release changelogs. The current function page does not state a first-supported version or guarantee parity across historical installations. Version-sensitive behaviour, real error results, large-value precision, workbook imports, mobile editions, and localized syntax therefore require native verification. A release-note mention of a related Spreadsheet Editor improvement must not be mistaken for a function introduction.
Related official documentation (links checked 13 October 2026 UTC)
- SINH function β vendor function reference.
- COSH function β vendor function reference.
- COTH function β vendor function reference.
- IF function β vendor function reference.
- LN function β vendor function reference.
- Insert functions in ONLYOFFICE Spreadsheet Editor β function-selection, autocomplete and entry workflow.
- Spreadsheet Editor advanced settings β formula language, regions, and separators.
Frequently asked questions
What is the difference between CSCH and CSC?
CSCH is 1/SINH(x); CSC is 1/SIN(x). Their values generally differ for the same input.
Can CSCH return a negative number?
Yes. For negative nonzero real input its mathematical output is negative.
What happens when x is zero?
The hyperbolic cosecant is undefined at zero; a native app test is required to document the exact error string.
Official reference and validation ledger
| Claim | Source checked | Verification status |
|---|---|---|
Function purpose and =CSCH(number) syntax |
ONLYOFFICE CSCH reference (checked 2026-10-13) | Vendor documented |
| Input domain, units and vendor-specific argument restrictions | ONLYOFFICE CSCH reference (checked 2026-10-13); independent mathematics for implied singularities | Vendor text plus clearly identified mathematics |
| Related function names and links | SINH, COSH, COTH, IF, LN (checked 2026-10-13) | Vendor pages retrieved |
| Formula insertion and separator instructions | ONLYOFFICE Insert Functions (checked 2026-10-13) | Vendor documented in English context |
| Regional formula language | ONLYOFFICE Advanced Settings (checked 2026-10-13) | Vendor documented |
| Current Docs release chronology, not first support | Docs changelog (checked 2026-10-13); Desktop changelog (checked 2026-10-13) | Release chronology checked; function introduction not verified |
| All numerical results in worked examples | Independent mathematical identities and high-precision calculation | Not native ONLYOFFICE execution |
Verification limitations: Native Docs/web and Desktop execution, localized parsing, extreme-value precision, historical editions and runtime error behavior were not tested.