← Back to catalogue
Research draft

Shawwal

vr.tr.shawwal · INF.KNW

Enable an agent to recognise Shawwal, identify a particular year's occurrence under a stated Islamic calendar authority, and support date-dependent decisions without treating local determinations as universal.

Thing Registry Information and virtual systems

Research draft, second pass

A second pass drafted this model: the structure a model of this thing needs, and what is known about it in the world. The line under this one says how the second half was obtained - researched against sources, or recalled without web access, in which case nothing here was read anywhere and every claim is a lead to verify. Unreviewed either way.

recalled by Codex without web access - no source was read

Researched by: Codex

Purpose and description

Enable an agent to recognise Shawwal, identify a particular year's occurrence under a stated Islamic calendar authority, and support date-dependent decisions without treating local determinations as universal.

Shawwal is the tenth month of the Islamic Hijri lunar calendar, following Ramadan and preceding Dhu al-Qadah, with Eid al-Fitr observed on its first day.

It can be Resolve a Shawwal name or spelling variant to the registered month concept.; Identify an annual occurrence using its Hijri year, calendar convention, and applicable community.; Translate a Shawwal date into a conditional Gregorian date or interval.; Compare differing start announcements while preserving each authority's applicability.; Schedule reminders that distinguish provisional calendar estimates from confirmed determinations.; Link Shawwal dates to observance guidance while leaving jurisprudential decisions to attributed sources..

Distinguishing features

Shawwal occupies month position ten, immediately after Ramadan and before Dhu al-Qadah.

The recurring named month is distinct from an occurrence such as Shawwal 1447 AH, which requires a year and calendar convention.

Eid al-Fitr falls on the first day of Shawwal; the festival and the whole month are different things.

Its Gregorian correspondence changes between years and can differ between calendar authorities for the same Hijri year.

The six voluntary fasts associated with Shawwal do not define six universally fixed dates within the month.

Scope

+ Identity, spelling variants, and position of Shawwal in the Hijri month sequence

+ Annual occurrences identified by Hijri year and calendar convention

+ Start and end determinations, including their authority, locality, and evidential basis

+ Conditional correspondence between Shawwal dates and Gregorian dates

+ Relationships to Eid al-Fitr and the six voluntary fasts associated with Shawwal

- The Islamic calendar's complete structure and history

- Ramadan's fasting obligations and religious practices

- Eid al-Fitr as a festival with its own rituals and social organisation

- Comprehensive jurisprudence governing fasting, exemptions, and missed fasts

- Astronomical modelling of lunar motion and crescent visibility

- Government holiday entitlements and workplace leave policies

Characteristics

Hijri month position
10 Distinguishes Shawwal from neighbouring Islamic months.
Hijri year
Integer year in the stated Hijri calendar convention Separates the recurring month concept from a particular occurrence.
Calendar determination convention
Local sighting, acceptance of sightings elsewhere, astronomical calculation, tabular calendar, or another explicitly named convention Explains why different records may assign different boundaries to the same named occurrence.
Determining authority and applicability
Named authority or calendar publisher linked to the community or jurisdiction applying its determination Prevents a local determination from being presented as binding everywhere.
Occurrence boundaries
Start and end under a named convention, with locality, day-boundary interpretation, and provisional or confirmed status Supports dependable scheduling and interpretation of date claims.
Month length
29 or 30 calendar days for a determined occurrence Constrains valid dates and identifies the transition to Dhu al-Qadah.
Observance relationship
First day linked to Eid al-Fitr; month linked to six voluntary fasts, with attributed guidance Supports observance-aware actions without conflating the month with a festival or legal ruling.

Where this came from

wikidata · CC0 1.0

Drafted structure

Bundle to layer to finding to question, as the second pass will find it: 5 bundles · 9 layers · 15 findings · 23 questions.

Shawwal identity Recognises the named month and separates it from its occurrences and associated festival.

A Shawwal reference may denote a month concept, a dated occurrence, or an informal reference to Eid; these require different handling.

Name and sequence

Identifies Shawwal through its names and fixed position in the Hijri month sequence.

Tenth Hijri month

Record whether the reference denotes the month following Ramadan and preceding Dhu al-Qadah, retaining the original spelling.

  1. Does this reference identify the tenth Hijri month, or another entity bearing the name Shawwal? definition
  2. Which language, script, or transliteration convention accounts for the recorded name? provenance

Concept and occurrence

Separates the recurring month from an annual occurrence and from Eid al-Fitr.

Reference resolution

Establish whether a statement concerns Shawwal generally, a specified Hijri year's month, or its opening festival.

  1. Is a Hijri year supplied or recoverable from the reference's context? measurement
  2. Does the statement concern the whole month, its first day, or Eid al-Fitr as a separate observance? boundary
Shawwal boundary determination Records how Ramadan ends, Shawwal begins, and Shawwal gives way to Dhu al-Qadah.

Shawwal's boundaries require a stated convention and applicable authority, especially when announcements differ.

Opening determination

Captures the basis and applicability of the declaration or calculation establishing 1 Shawwal.

Ramadan to Shawwal transition

Record the evidence or calendar rule used to establish the opening of Shawwal and who accepts that determination.

  1. Which sighting decision, calculation, or tabular rule establishes 1 Shawwal for this occurrence? provenance
  2. Which authority issued the determination, and which community or jurisdiction follows it? boundary

Closing determination

Establishes the final valid Shawwal date and transition to the next month.

Length and next month

Record whether the occurrence has 29 or 30 days under the selected convention and whether its closing boundary is settled.

  1. Does the applicable determination give this Shawwal 29 or 30 days? measurement
  2. What determination establishes the start of Dhu al-Qadah and therefore the end of this Shawwal? provenance
Shawwal date resolution Supports date conversion and scheduling when Gregorian representations or community calendars differ.

A bare Gregorian date can conceal both the evening boundary of an Islamic day and disagreement over the beginning of Shawwal.

Gregorian correspondence

Relates a specified Shawwal date to civil dates or time intervals with explicit assumptions.

Day and evening mapping

Distinguish a civil date label from the full religious day interval when resolving a Shawwal date.

  1. Which Hijri year, Shawwal day number, and calendar convention are being converted? measurement
  2. Does the requested output denote a civil date, the preceding evening's start, or the full day interval for a specified locality? boundary

Disagreement and revision

Preserves alternative determinations and tracks changes from forecasts to announcements.

Authority-specific date state

Record whether a Shawwal date is projected or confirmed by its source, and retain competing determinations with their applicability.

  1. Is this date a forecast, a published calculated date, or an announced determination, and when was it issued? provenance
  2. Which existing reminders or date mappings require revision if the applicable authority changes its announcement? action
Shawwal observance links Connects the month to Eid al-Fitr and voluntary fasting while preserving the boundaries of separate observance and jurisprudence models.

Shawwal-specific actions depend on distinguishing its festival day from other dates and attributing fasting guidance to a stated tradition or authority.

Eid opening day

Links 1 Shawwal to Eid al-Fitr without assigning the entire festival or public holiday period to the month model.

First-day festival link

Record Eid al-Fitr's relationship to 1 Shawwal and distinguish that date from locally extended celebrations or statutory holidays.

  1. Which determination of 1 Shawwal supplies the Eid date for the relevant community? provenance
  2. Does a stated Eid period refer to 1 Shawwal, additional celebration days, or a separately established public holiday interval? boundary

Six voluntary fasts

Represents the association between Shawwal and six voluntary fasting days without imposing an unattributed scheduling rule.

Fasting guidance and scheduling

Link proposed fasting dates to guidance on eligible days, continuity, and the relationship to outstanding Ramadan fasts.

  1. Which religious source or authority supports the guidance being applied to the six Shawwal fasts? provenance
  2. Under that guidance, which dates are eligible, and what constraints concern Eid, consecutive days, or outstanding Ramadan fasts? action
Evidence and external alignment What the world already says about this thing, gathered so the model can be checked against it.

A model that cannot be lined up against existing standards, identifiers and practice cannot be adopted by anyone who already uses them.

Reported evidence

Findings from the breadth pass, kept separate from the structural claims.

Check these first

Recalled without web access and unsourced; every item is a lead to verify.

  • This describes the calendar-month sense; Shawwal is a recurring period, not a discipline or field of knowledge.
  • Specific Gregorian equivalents require a Hijri year and a stated calendar convention or relevant authority.
  • Details of voluntary fasting practice should be checked against the relevant Islamic legal tradition.
  1. Which of these check these first hold for the sense of Shawwal this model covers, and on what evidence? provenance

Identifiers and schemes

Recalled without web access and unsourced; every item is a lead to verify.

  • Hijri calendar month numbering - 10 - Identifies the month within a Hijri year, not a unique date.
  1. Which of these identifiers and schemes hold for the sense of Shawwal this model covers, and on what evidence? provenance

Real-world use

Recalled without web access and unsourced; every item is a lead to verify.

  • Dating religious, civil and historical events in the Hijri calendar.
  • Determining the observance of Eid al-Fitr on 1 Shawwal.
  • Providing the period for the six voluntary days of fasting in Shawwal recognized in Sunni Islamic practice; Eid al-Fitr itself is excluded from fasting.
  1. Which of these real-world use hold for the sense of Shawwal this model covers, and on what evidence? provenance

Typical measurements

Recalled without web access and unsourced; every item is a lead to verify.

  • Month duration - 29-30 - days
  1. Which of these typical measurements hold for the sense of Shawwal this model covers, and on what evidence? provenance

Failure modes and hazards

Recalled without web access and unsourced; every item is a lead to verify.

  • Treating Shawwal as a fixed Gregorian date or season produces incorrect conversions.
  • Assuming all communities begin Shawwal on the same date can misalign observances and schedules.
  • Confusing a calculated calendar date with a locally confirmed religious date can create discrepancies.
  1. Which of these failure modes and hazards hold for the sense of Shawwal this model covers, and on what evidence? provenance

Regional variation

Recalled without web access and unsourced; every item is a lead to verify.

  • Communities and authorities differ in their use of local crescent sightings, sightings accepted from elsewhere, or astronomical calculations to determine the month's beginning.
  • Civil calendar dates and religious announcements may differ across jurisdictions.
  1. Which of these regional variation hold for the sense of Shawwal this model covers, and on what evidence? provenance

Neighbouring kinds and how to tell them apart

Recalled without web access and unsourced; every item is a lead to verify.

  • Ramadan - Ramadan is the ninth Hijri month and the month of obligatory fasting; Shawwal immediately follows it.
  • Dhu al-Qadah - Dhu al-Qadah is the eleventh Hijri month and immediately follows Shawwal.
  • Eid al-Fitr - Eid al-Fitr is the festival observed on Shawwal's first day, whereas Shawwal is the entire month.
  • Hijri calendar - The Hijri calendar is the dating system; Shawwal is one of its twelve months.
  1. Which of these neighbouring kinds and how to tell them apart hold for the sense of Shawwal this model covers, and on what evidence? provenance

What the second pass must settle

  • Does an existing Vercy Islamic calendar model already own Shawwal's identity, requiring this registry entry to link to it rather than establish a second source of truth?
  • Which Arabic forms and transliteration variants should the registry recognise as Shawwal aliases?
  • Which authorities and communities must occurrence records cover, and where can their original Shawwal announcements be reliably retrieved?
  • How should historical Shawwal dates be represented when the local determination is unknown and only retrospective calendar conversion is available?
  • Which attributed religious sources should govern optional fasting guidance, particularly differences concerning outstanding Ramadan fasts and scheduling?