From c40a5fe5348c79e0c8641e5493b71776a90f88db Mon Sep 17 00:00:00 2001 From: gimy Date: Sat, 25 May 2024 09:26:07 +0800 Subject: [PATCH] chore: release v1.0.0-draft.5 --- README.md | 2 +- content.typ | 129 ++++++++++++++++++++++++++------------------------- package.json | 2 +- 3 files changed, 69 insertions(+), 64 deletions(-) diff --git a/README.md b/README.md index a2f85de..6728c86 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ This is the home repo for the Hijri Week Calendar Standard. The standard is a proposal for an ISO 8601 counterpart for Hijri week dates. The standard is intended to be used in conjunction with already existing Islamic calendar standards, such as the Umm al-Qura calendar, and is designed to be as compatible as possible with the ISO 8601 calendar. -For more information, see the [proposal](https://github.com/khawarizmus/hijri-week-calendar-proposal/releases/download/v1.0.0-draft.4/main.pdf). +For more information, see the [proposal](https://github.com/khawarizmus/hijri-week-calendar-proposal/releases/download/v1.0.0-draft.5/main.pdf). ## Implementation diff --git a/content.typ b/content.typ index 98af004..964fe7f 100644 --- a/content.typ +++ b/content.typ @@ -3,13 +3,13 @@ = Introduction -The Hijri week calendar (HWC) is a leap week date system based on the fundamentals of the ISO 8601 week date system. +The HWC (HWC) is a leap week date system based on the fundamentals of the ISO 8601 week date system. The HWC specifies a week of year atop any of the compatible Hijri calendars by defining a notation for ordinal weeks of the year. The HWC is a standard representation of the underlying Hijri calendar and therefore shares the accuracy of the underlying Hijri calendar. The resulting Hijri week date may be different depending on the underlying Hijri calendar used. Therefore, it is important to reference the Hijri calendar with the HWC representation when in need of interoperability. Because the HWC is designed to work with many types of Hijri calendars, implementers of the HWC may need to create seperate implementations for each Hijri calendar. This should not be seen as a limitation but rather as a versatile feature allowing the HWC to be used with any Hijri calendar that may be introduced in the future. -The HWC and its rules are not limited to just the tabular varieties of Hijri calendars. This includes compatibility with calendars such as the Umm Al-Qura calendar. For more information on compatible and non-compatible Hijri calendars, see @compatible-calendars. +The HWC and its rules are not limited to just the tabular varieties of Hijri calendars. This includes compatibility with calendars such as the Umm Al-Qura calendar. For more information on compatible and non-compatible Hijri calendars. See @compatible-calendars. // The week numbering scheme of the Hijri-Week Calendar System introduced in this document closely follows that introduced by the ISO 8601 with minor deviations which are specific to the nature of the Hijri calendars. @@ -143,31 +143,31 @@ The #text(style: "italic")[islamic-civil] and #text(style: "italic")[islamic-tbl Usage of #text(style: "italic")[islamic] and #text(style: "italic")[islamic-rgsa] calendars from the ICU is not recommended, even when using the HWC until such time the ICU implementation is fixed. -= Structural Elements of the Hijri Week Calendar += Structural Elements of the Hijri Week Calendar (HWC) -The following sections defines the structural elements and foundational constructs of the Hijri week calendar. This calendar system, is comprised of various components and rules that collectively define its operational framework. +The following sections define the structural elements and foundational constructs of the HWC. This calendar system is comprised of various components and rules that collectively define how it operates. == Hijri Week and Weekdays -The Hijri calendar defines a week as a cycle of seven days. This cycle commences on Saturday, designated as day 1, and concludes on Friday, marked as day 7. Accordingly, the weekdays are numerically represented as follows: Saturday (1), Sunday (2), Monday (3), Tuesday (4), Wednesday (5), Thursday (6), and Friday (7). +The HWC defines a week as a cycle of seven days. This cycle commences on Saturday, designated as day 1, and concludes on Friday, designated as day 7. Accordingly, the weekdays are numerically represented as follows: Saturday (1), Sunday (2), Monday (3), Tuesday (4), Wednesday (5), Thursday (6), and Friday (7). This structure presents a variation from the ISO standard, where the week starts on Monday (day 1) and ends on Sunday (day 7). -The conversion from ISO weekday numbering to Hijri weekday numbering involves a simple arithmetic transformation followed by a conditional adjustment to align the start and end of the week with Hijri calendar conventions. The process is as follows: +The conversion from ISO weekday numbering to HWC weekday numbering involves a simple arithmetic transformation followed by a conditional adjustment to align the start and end of the week with HWC conventions. The process is as follows: -+ *Addition:* Begin by adding 2 to the ISO weekday number. This step shifts the start of the week from Monday (ISO) to Saturday (Hijri). ++ *Addition:* Begin by adding 2 to the ISO weekday number. This step shifts the start of the week from Monday (ISO) to Saturday (HWC). + *Modulo Operation:* Apply the modulo operation with 7 to the result of the addition. This operation ensures that the resulting numbers stay within the range of 1 to 7, corresponding to the days of the week. + *Adjustment for Friday:* Since the modulo operation maps Friday to 0 (due to the addition in step 1), a final adjustment is necessary. If the result of the modulo operation is 0, it is replaced with 7 to correctly represent Friday as the last day of the Hijri week. -This methodical approach effectively recalibrates the ISO weekday numbering to align with the Hijri calendar's structure, ensuring that each day of the week is accurately represented in the context of the Hijri week calendar. +This methodical approach effectively recalibrates the ISO weekday numbering to align with the HWC's structure, ensuring that each day of the week is accurately represented in the context of the HWC. -The followin table outlines the relationship between Hijri and ISO weekday numbering systems. +The followin table outlines the relationship between HWC and ISO weekday numbering systems. #tablex( columns: 6, - [Weekday], [Hijri Day Number], [ISO Day Number], [Add 2 to ISO], [MOD 7], [logical OR with 7], + [Weekday], [HWC Day Number], [ISO Day Number], [Add 2 to ISO], [MOD 7], [logical OR with 7], [Saturday], [1], [6], [6+2 = 8], [1], [1], [Sunday], [2], [7], [7+2 = 9], [2], [2], [Monday], [3], [1], [1+2 = 3], [3], [3], @@ -179,80 +179,85 @@ The followin table outlines the relationship between Hijri and ISO weekday numbe == Week Numbering -In the Hijri week calendar system, a year is categorized as either 'short' or 'long' based on the total count of weeks it comprises. Specifically: +// TODO: make sure that all quotes are the same (double vs single) -- A short year consists of 50 full weeks, summing up to 350 days. -- A long year encompasses 51 full weeks, totaling 357 days. +In the HWC system, a year is categorized as either being 'short' or 'long' based on the total count of weeks it comprises. Specifically: -This structure contrasts with the typical Hijri year, which generally spans 354 or 355 days. The delineation into short and long years is instrumental for maintaining temporal alignment within the Hijri week calendar system, accommodating variations in the lunar cycle over extended periods. +- A short year consists of 50 full weeks, totaling 350 days. +- A long year consists of 51 full weeks, totaling 357 days. + +This structure contrasts with the typical Hijri year, which generally spans 354 or 355 days. The delineation into short and long years is instrumental for maintaining temporal alignment within the HWC system, accommodating variations in the lunar cycle over extended periods. == Weeks Numbering Rules -The Hijri week calendar system adopts a week numbering methodology equivalant to the ISO 8601 standard, with a pivotal modification centered around the definition of the first and last calendar weeks of the year. The rules are as follows: +The HWC system adopts a week numbering methodology equivalant to the ISO 8601 standard, with a pivotal modification centered around the definition of the first and last calendar weeks of the year. The rules are as follows: -- *First calendar week (Week 01):* This is defined as the week that encompasses the first Tuesday of the Hijri year. It marks the commencement of the Hijri-week-year and its week numbering sequence. -- *Last calendar week:* This is the week immediately preceding the first calendar week of the subsequent Hijri-week-year, effectively closing the Hijri-week-year week numbering sequence. +- *First calendar week (Week 01):* This is defined as the week that encompasses the first Tuesday of the Hijri year. It marks the commencement of the HWC year and its week numbering sequence. +- *Last calendar week:* This is the week immediately preceding the first calendar week of the subsequent HWC year, effectively closing the HWC year week numbering sequence. -The primary distinction from the ISO 8601 standard lies in the selection of the central day of the week. While ISO 8601 considers Thursday as the middle day, the Hijri week calendar system designates *Tuesday* as the pivotal day around which week boundaries are determined. +The primary distinction from the ISO 8601 standard lies in the selection of the pivotal day of the week. While ISO 8601 considers Thursday as the pivotal day, the HWC system designates *Tuesday* as the pivotal day around which week boundaries are determined. -This adjustment ensures that each Hijri week calendar year aligns consistently with the characteristic of the temporal structure of the Hijri calendar, honoring its unique cultural and religious context. +This adjustment ensures that each HWC year aligns consistently with the characteristic of the temporal structure of the Hijri calendar, honoring its unique cultural and religious context. // we chose tuesday because weeks should start on saturday // weeks should start on satruday beacuse of relegious conciderations (friday last day) -== Formatting the Hijri Week Date System +== Formatting the Hijri Week Date System -In the Hijri week calendar, dates are structured to ensure clarity and standardization, closely paralleling the format utilized by the ISO week-numbering system. The format components are as follows: +In the HWC, dates are structured to ensure clarity and standardization, closely paralleling the format utilized by the ISO 8601 week-numbering system. The format components are as follows: -- *Year (YYYY):* The calendar year is denoted with four digits. -- *Week Number (ww):* This is a two-digit representation of the week within the year, ranging from 01 to 50/51, depending on the year's length (short or long). It is prefixed by the letter 'W' to denote the week number. -- *Weekday Number (d):* This is a single digit ranging from 1 to 7, starting with Saturday as 1 and concluding with Friday as 7. +- *Year (`YYYY`):* The calendar year is denoted with four digits. +- *Week Number (`ww`):* This is a two-digit representation of the week within the year, ranging from 01 to 50/51, depending on the year's length (short or long). It is prefixed by the capital letter 'W' to denote the week number. +- *Weekday Number (`d`):* This is a single digit ranging from 1 to 7, with 1 representing Saturday and 7 representing Friday. Hence, a complete Hijri week date is represented in the extended format as YYYY-Www-d. For more compact communication, the date can be condensed into the format YYYYWwwd. -For instance, the Hijri (Islamic) date *Thursday, 15 Jumad II 1445* translates to the 6th day (Thursday) of the 23rd week in the year 1445. This date is formally expressed in the extended format as *1445-W23-6* and in the compact format as *1445W236*. +// TODO: check what calendar is this date using under the hood and specefy it +For instance, the Hijri (Islamic) date *Thursday, 15 Jumada II 1445* translates to the 6th day (Thursday) of the 23rd week in the year 1445. This date is formally expressed in the extended format as *`1445-W23-6`* and in the compact format as *`1445W236`*. -== Disambiguating Hijri Year from Hijri-Week Year +== Disambiguating Hijri Year from HWC Year -In the context of date notation, it's essential to distinguish clearly between the Hijri year and the Hijri week year, as they represent different temporal frameworks. The convention for this distinction is as follows: +In the context of date notation, it's essential to distinguish clearly between the Hijri year and the HWC year, as they represent different temporal frameworks. The convention for this distinction is as follows: - *Hijri year:* Denoted as a numerical year followed by the suffix 'AH' (Anno Hegirae), indicating the traditional lunar Hijri calendar year. For example, the year 1445 in the Hijri calendar is expressed as *1445 AH*. -- *Hijri week year:* Similar to the Hijri Year but differentiated by appending a 'W' before the 'AH' suffix. This signifies adherence to the Hijri week calendar system. Thus, the Hijri week year corresponding to 1445 AH would be denoted as *1445W AH*. +- *HWC year:* Similar to the Hijri year but differentiated by appending a 'W' immediatly after the year before the 'AH' suffix. This signifies adherence to the HWC system. Thus, the HWC year corresponding to 1445 AH would be denoted as *`1445W AH`*. + +This notation ensures unambiguous communication by clearly differentiate the conventional Hijri calendar from the HWC system. + +== Calendar Awareness for Hijri Week Dates -This notation ensures unambiguous communication by clearly demarcating the conventional Hijri calendar from the Hijri week calednar system. +When working with different systems that use the HWC or when using different Hijri calendars within a system that uses the HWC, it is essential to specify the underlying Hijri calendar for any specific Hijri week date to ensure accurate date conversion from a Hijri week date to a Hijri date. The mapping of the Hijri week date to its underlying Hijri calendar is as follows: -== Encoding the Hijri Week Date With the Underlying Hijri Calendar +- *Hijri Week Date (`YYYY-Www-d` or `YYYYWwwd`):* Expressed in the format `YYYY-Www-d` or the compact format `YYYYWwwd`. See @formatting-the-hijri-week-date-system. +- *Underlying Hijri Calendar (`[u-ca=]`):* The specific Hijri calendar used to determine the corresponding Hijri date. This information is crucial for accurate conversion from the Hijri week date to the designated Hijri date. the suffix key `u-ca` is allocated to indicate the underlying Hijri calendar in which the Hijri week date should be presented. Possible values for the calendar identifier include the ICU Hijri calendar identifiers that are compatible with the HWC such as `islamic-civil`, `islamic-tbla`, and `islamic-umalqura`. See @compatible-calendars. -When working with different systems that use the Hijri week calendar or when using different Hijri calendars withing the a system that uses the Hijri week calendar, it is essential to specify the underlying Hijri calendar for any specefic Hijri week date to ensure accurate date conversion from a Hijri week date to a Hijri date. The encoding of the Hijri week date with the underlying Hijri calendar is as follows: +By associating the Hijri week date with the underlying Hijri calendar, the corresponding Hijri date can be determined precisely, ensuring consistency and accuracy in date representation across different systems and contexts. -- *Hijri Week Date:* Expressed in the format YYYY-Www-d or YYYYWwwd. -- *Underlying Hijri Calendar:* The specific Hijri calendar used to determine the corresponding Hijri date. This information is crucial for accurate conversion from the Hijri week date to the Hijri date. +// TODO: check if we can reference the standard hint: https://datatracker.ietf.org/doc/html/rfc9557 +For example, the Hijri week date *`1445-W23-6[u-ca=islamic-umalqura]`* specifies that the underlying Hijri calendar used is the Umm Al-Qura calendar. -By associating the Hijri week date with the underlying Hijri calendar, one can precisely determine the corresponding Hijri date, ensuring consistency and accuracy in date representation across different systems and contexts. -For example, the Hijri week date *1445-W23-6[cu-a=islamic-umalqura]* must be accompanied by the underlying Hijri calendar, such as the Umm Al-Qura calendar, to accurately ascertain the corresponding Hijri date. +When working with Hijri week dates across different Hijri calendars, it is essential to convert the Hijri week date to the corresponding Hijri date in the specified calendar before converting it to another Hijri calendar. This is due to the absence of direct conversion between Hijri calendars in the HWC system. == Significance of Muharram's 4th Day in Week Numbering -Within the Hijri week calendar, the 4th weekday, being Tuesday, holds a central position, akin to Thursday in the ISO Week. This alignment underscores the symmetry in the structure of both calendars, each spanning seven days per week. Specifically, the 4th day of Muharram, marking the start of the Hijri year, is designated as the #text(weight: "bold")[first week pivot day]. This pivotal day bears resemblance to the 4th of January in the ISO calendar, delineating a key temporal marker with the following characteristics: +The 4th day of Muharram is designated as the #text(weight: "bold")[first week pivot day]. This pivotal day bears resemblance to the 4th of January in the ISO calendar, delineating a key temporal marker. This day does not manifest in any other week besides week 01 of the HWC year, ensuring its role as a singular reference point for the beginning of the annual cycle. -- *Week 01 Exclusivity:* It exclusively falls within the first week (Week 01) of the Hijri-Week Year, mirroring the structural initiation point of the year. -- *Uniqueness:* This day does not manifest in any other week, ensuring its role as a singular reference point for the onset of the annual cycle. -*Note on Week 01 Initiation:* To ascertain the commencement of Week 01 in any given Hijri-Week Year, one identifies the weekday corresponding to the 4th of Muharram. Subsequently, the nearest preceding Saturday is determined, marking the start date of Week 01. +To establish the beginning of week 01 in any given HWC year, one identifies the weekday corresponding to the 4th of Muharram. Subsequently, if that day isn't Saturday, the nearest preceding Saturday is determined, marking the start date of week 01. Otherwise that Saturday becomes the start of week 01. == Tuesday's Pivotal Role in Week Number Calculation // This section is for us to know the week number. previously named The Middle Weekday (Tuesday) -Tuesday, as the central day of the week, assumes a significant role within the Hijri week calendar system, characterized by the following attributes: +As the central day of the week, Tuesday assumes a significant role within the HWC system, characterized by the following attributes: -- It invariably represents the mid-point of the Hijri Week. +- It represents the mid-point of the Hijri week. - It is designated as weekday number 4. -- The initial Tuesday of the Hijri year invariably falls within Week 01. -- The concluding Tuesday of a given Hijri year falls within the final week, either Week 50 or Week 51. +- The first Tuesday of the Hijri year always falls within week 01. // is this true? yes verified +- The concluding Tuesday of a given Hijri year falls within the final week, either week 50 or week 51. - Dates falling on a Tuesday are always positioned in the middle of a week. -- Each Tuesday within a Hijri year is part of the corresponding Hijri-Week Year. Consequently, a Hijri year comprising 50 Tuesdays equates to a Hijri-Week Year with 50 weeks; similarly, 51 Tuesdays correspond to a Hijri-Week Year with 51 weeks. +- Each Tuesday within a Hijri year is part of the corresponding HWC year. Consequently, a Hijri year comprising 50 Tuesdays equates to a HWC year with 50 weeks; similarly, 51 Tuesdays correspond to a HWC year with 51 weeks. - The allocation of days to weeks is guided by proximity to Tuesday. Specifically, Wednesday, Thursday, and Friday are grouped with the preceding Tuesday, while Saturday, Sunday, and Monday align with the succeeding Tuesday. To pinpoint the specific week for a given Hijri date, one should first locate the nearest Tuesday to that date. This is achieved by adjusting the date's weekday number by subtracting the weekday number from 4, and then adding the resultant offset to the weekday number of the date. Next, determine the yearly ordinal date for that Tuesday, counting from the start of the Hijri year. Dividing this ordinal number by 7 and rounding up yields the week number. @@ -284,7 +289,7 @@ this means that Wedensday 18 Shaʿbān occurs on the 33rd week of 1445 AH accord // this section is for us to know the total weeks in a hijri year and the one after it. previously named First Day of the Hijri Year -The first day of the Hijri year directly determines the number of weeks in the corresponding Hijri-Week Year. The week count varies based on whether it's a common or leap year and the weekday of the year's first day: +The first day of the Hijri year directly determines the number of weeks in the corresponding HWC year. The week count varies based on whether it's a common or leap year and the weekday of the year's first day: *Common Hijri Year:* @@ -300,28 +305,28 @@ The first day of the Hijri year directly determines the number of weeks in the c - If the next Hijri Year begins on Sun, Mon, or Tue (days 2-4) (or on Mon or Tue in a leap year), the current year will have 50 weeks. Otherwise, it will have 51 weeks. -The starting day of the Hijri Year is critical for defining the total weeks in the Hijri-Week Year, aligning with the Hijri lunar calendar's structure. +The starting day of the Hijri Year is critical for defining the total weeks in the HWC year, aligning with the Hijri lunar calendar's structure. == Characteristics of The First Week (Week 01) -The First Week (Week 01) of the Hijri-Week Year is characterized by specific temporal properties that establish its position and duration within the calendar system. These properties are: +The First Week (Week 01) of the HWC year is characterized by specific temporal properties that establish its position and duration within the calendar system. These properties are: - *Inclusion of the First Tuesday:* Week 01 invariably encompasses the first Tuesday of the Hijri Year, marking it as a significant week. -- *Minimum Duration:* This week is the earliest in the Hijri-Week Year that contains at least four days, aligning with the structural requirements of the calendar. +- *Minimum Duration:* This week is the earliest in the HWC year that contains at least four days, aligning with the structural requirements of the calendar. - *Commencement Date Variability:* Depending on the year's structure: - For a year ending on the 29th of Dhu al-Hijja (year-ending-29), Week 01 can start as early as the 27th of Dhu al-Hijja of the preceding Hijri year. - For a year concluding on the 30th of Dhu al-Hijja (year-ending-30), this week can commence as early as the 28th of Dhu al-Hijja of the preceding Hijri year. - *Latest Conclusion Date:* The week can extends up to the 4th of Muharram of the subsequent Hijri year. - *Guaranteed Span:* Regardless of the starting point, Week 01 always spans a minimum of four days within the starting Hijri year. -These characteristics ensure that Week 01 serves as a foundational segment in the Hijri-Week Year, establishing the framework for subsequent weeks and their numbering. +These characteristics ensure that Week 01 serves as a foundational segment in the HWC year, establishing the framework for subsequent weeks and their numbering. == Concluding Week Dynamics: Week 50 or 51 The #link()[Hijri week year] concludes with either Week 50 or Week 51. This final week plays a key role in bridging the transition between years and has a number of characteristics: -- *Preceding Week 01:* This week directly precedes Week 01 of the succeeding Hijri-Week Year. +- *Preceding Week 01:* This week directly precedes Week 01 of the succeeding HWC year. - *Inclusion of the Last Tuesday:* The year's final Tuesday is always within this week, marking its significance. - *Tuesday's Position:* The middle day of this week, Tuesday, consistently occurs in the ending year, ensuring alignment with the weekly structure. - *Conclusion on Friday:* The week terminates on the Friday that is closest to the conclusion of the last month of the preceding year. @@ -338,40 +343,40 @@ The #link()[Hijri week year] con - The final day can be as late as the 3rd of Muharram of the subsequent Hijri year. - The central weekday, Tuesday, is always within the concluding Hijri year, maintaining consistency with the week's structure. -== Characteristics of the Final Tuesday in Hijri-Week Year +== Characteristics of the Final Tuesday in HWC year -The Last Tuesday of the Hijri Year invariably aligns with the final week of the Hijri-Week Year, either Week 50 or Week 51. This day is characterized by the following properties: +The Last Tuesday of the Hijri Year invariably aligns with the final week of the HWC year, either Week 50 or Week 51. This day is characterized by the following properties: -- It marks the conclusion of Tuesdays in both the Hijri Year and the Hijri-Week Year. -- It occurs during the ultimate week of the Hijri-Week Year, which is designated as Week 50 or Week 51. +- It marks the conclusion of Tuesdays in both the Hijri Year and the HWC year. +- It occurs during the ultimate week of the HWC year, which is designated as Week 50 or Week 51. These attributes establish the Last Tuesday as a significant temporal marker within the Hijri-Week calendar system, delineating the transition between annual cycles. -== Final Day's Placement in the Hijri-Week Year +== Final Day's Placement in the HWC year The Last Day of the Hijri Year, either the 29th or 30th of Dhu al-Hijja, delineates the year's end with distinct features: - The date falls on either the 29th or the 30th of the 12th month (Dhu al-Hijja), regardless of it being a common or leap year. -- It is positioned within Week 51 or Week 01 of the Hijri-Week Year. It does not occur in Week 50. -- For common years concluding on a Tuesday, Wednesday, Thursday, or Friday (days 4, 5, 6, or 7), or for leap years ending on a Saturday, Tuesday, Wednesday, Thursday, or Friday (days 1, 4, 5, 6, or 7), the Hijri-Week Year comprises 51 weeks. -- Conversely, for common years ending on a Saturday, Sunday, or Monday (days 1, 2, or 3), or for leap years concluding on a Sunday or Monday (days 2 or 3), the Hijri-Week Year contains 50 weeks. +- It is positioned within Week 51 or Week 01 of the HWC year. It does not occur in Week 50. +- For common years concluding on a Tuesday, Wednesday, Thursday, or Friday (days 4, 5, 6, or 7), or for leap years ending on a Saturday, Tuesday, Wednesday, Thursday, or Friday (days 1, 4, 5, 6, or 7), the HWC year comprises 51 weeks. +- Conversely, for common years ending on a Saturday, Sunday, or Monday (days 1, 2, or 3), or for leap years concluding on a Sunday or Monday (days 2 or 3), the HWC year contains 50 weeks. == Properties of the Last Week Pivot Day -The last week pivot day marks a critical reference point in the Hijri week calendar, occurring three days prior to the year's conclusion. Its characteristics are as follows: +The last week pivot day marks a critical reference point in the HWC, occurring three days prior to the year's conclusion. Its characteristics are as follows: -- It consistently occurs during the final week of the Hijri-Week Year, either Week 50 or Week 51. +- It consistently occurs during the final week of the HWC year, either Week 50 or Week 51. - It is precisely seven days prior to the 4th of Muharram in the subsequent year. - If the Hijri year concludes on the 29th of Dhu al-Hijja (year-ending-29), the Last Week Pivot Day falls on the 26th of Dhu al-Hijja (26th of Dhu al-Hijja). - If the Hijri year ends on the 30th of Dhu al-Hijja (year-ending-30), this day is observed on the 27th of Dhu al-Hijja (27th of Dhu al-Hijja). -*Note:* The Last Week Pivot Day's occurrence within the final week of the Hijri-Week Year facilitates the determination of the total number of weeks in that year. This can be achieved by calculating the difference in days between the start of the Hijri Year and the Last Week Pivot Day, then dividing this number by 7 and applying a ceiling function to round up to the nearest whole number. +*Note:* The Last Week Pivot Day's occurrence within the final week of the HWC year facilitates the determination of the total number of weeks in that year. This can be achieved by calculating the difference in days between the start of the Hijri Year and the Last Week Pivot Day, then dividing this number by 7 and applying a ceiling function to round up to the nearest whole number. // = Other Days in the First Month of the Hijri Year == Week Allocation for Initial Days of Muharram -The initial days of Muharram, the first month of the Hijri Year, have a structured and predictable placement within the Hijri week calendar: +The initial days of Muharram, the first month of the Hijri Year, have a structured and predictable placement within the HWC: - The 4th of Muharram invariably falls in Week 01. - The 11th of Muharram invariably falls in Week 02. diff --git a/package.json b/package.json index d6399d8..4db9c33 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "hijri-week-calendar-standard", - "version": "1.0.0-draft.4", + "version": "1.0.0-draft.5", "description": "", "main": "index.js", "scripts": {