Description
Format a supplied surah and ayah number as a reference token.
Textual and archival references depend on the collection, edition, numbering system, date convention and source attribution. A supplied surah/ayah or manuscript partition number is a locator, not verification of canonical limits or content. Permission, beneficiary shares and direction labels require their stated documentary context.
Format a supplied surah and ayah number as a reference token.
When to use this tool
Use Quran Reference Ayah Token when you already have surahNumber, ayahNumber and need to format a supplied surah and ayah number as a reference token.
How to use the tool and how it works
- Enter surahNumber, ayahNumber. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read reference. Use the output convention below.
Require positive safe whole surahNumber/ayahNumber; return surah:ayah.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| surahNumber | Positive supplied integer; no canonical surah count or verse lookup is enforced. | Required. Safe integer; minimum 1. |
| ayahNumber | Ayah Number | Required. Safe integer; minimum 1. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| reference | Reference | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"surahNumber": 2,
"ayahNumber": 255
},
"output": {
"reference": "2:255"
}
}Limitations and assumptions
- The tool does not check canonical surah or verse counts, numbering traditions, editions or textual existence.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Consult the relevant original edition, manuscript, deed or stated authority for an interpretive or rights question. Use a complete calendar, directional or distribution method when computation is required; local locators and supplied labels do not infer those rules.
References
Similar or alternative tools
- Quran Citation Surah Range Boundary
Label a supplied verse range and compare its end with a supplied verse count.
- Hadith Reference Book Number Label
Label supplied book and narration numbers within a stated hadith collection.