Monday 15th July 2024 | Ithnain 8th Muharram 1446 [?]
Introduction

The iOS/iPhone version of the Hijri Calendar Widgets (v1.1) is now live on the Apple App Store, See description below for more details.

Apple App Store Description
iOS1 HijriCalendar En iOS2 HijriCalendar En iOS3 HijriCalendar En iOS4 HijriCalendar En iOS5 HijriCalendar En iOS6 HijriCalendar Ar iOS7 HijriCalendar Ar iOS8 HijriCalendar Ar

How to add ICOUK Hijri Widgets to iPhone: https://youtu.be/rFAnw0sC3iw (from v1.1.0)

The Islamic Crescents Observation for the UK (ICOUK) Hijri Calendar Widgets are based on verified Moon Sighting reports by the human eye (Muhaqaq Ruyat Al-Basari), which makes it a unique product of its kind. It will automatically synchronise the dates in the background on a regular basis with our database servers via the Internet but it will continue to work off-line when are is no internet connection. There are two Widgets provided, one for the Daily Hijri date (which is fixed to the device date) and the other one for the Monthly Calendar (which changes with the forward/reverse buttons).

The Widgets also provides future monthly dates based on predicted moon sighting (Imkan Al-Ruyat) for planning purposes (e.g. holiday and travel bookings), but the dates are synchronised on the 29th lunar date of each month (or refreshed on-demand) if it differs from the predicted month start dates. The predicted dates have been tested over 10 years (since 2008) by the ICOUK observers and have been found to be highly accurate with actual sighting dates, so it is an excellent planning tool, too.

Even though by default the Hijri Dates are based on actual Moon Signing in the UK to Morocco region, it can be used from outside this Region and hence the Widgets can be adjusted with the local Hijri calendar with up to +/- 2 days differences. In the vast majority of the cases, only +/- 1 day adjustment will be sufficient to make the App usable effectively throughout the whole world (since it is based on the centre of the world map), so there should not be any need to use a local calendar-based App by travellers from the UK/Morocco region to other countries.

The above adjustments will allow it to easily match it with the Saudi Dating System (Ummul Qura) or with Moon Sighting news from the Southern Hemisphere. It is provided in both the English and the Arabic languages to meet the demands of most users.

The summary of the Widget features are provided in the following list:

  • Hijri dates are based on verified moon sighting reports by the human eye
  • All the Hijri dates and settings are synchronised with online servers
  • Future Hijri dates are provided based on predicted sightings (Imkan Al-Ruyat)
  • Both the Hijri and the Gregorian dates are provided on the same calendar
  • Past and future monthly calendars can be easily viewed with navigation buttons
  • Day and Month Adjustments are provided for users from outside the UK
  • Hijri dates and help-texts can be viewed in both English and Arabic languages
  • Islamic Holidays and Events will appear on the relevant Hijri date as reminders
  • The Fore and Background colours can be adjusted to match the device theme/wall-paper
  • Daily and Monthly Hijri dates can be used separately (with the Day Adjust displayed)

We have provided ample help-text in English and Arabic to make it easier for you to get the best use of our ICOUK Hijri Calendar Widgets. If you have any difficulties using it, please contact us before leaving any negative comments. Your positive feedback ratings will encourage us to add more useful features in the future versions (such as daily prayer times), InShaAllah.

How to use the Widget

The following function descriptions refer to the numerical labels on both the Hijri Calendar Widgets (Daily and Monthly Dates) shown in Figure 1 and 2 below. The No. 1 - 3 refers to Daily Date widget and No. 4 - 15 refers to the Monthly Calendar widgets.

iOS21 HijriCalUsage En
Figure 1
No Main Calendar Functions
1 The Arabic name of the current day and date
2 & 6 The Hijri name of the month and the year
3 & 9 The Day Adjust setting of the calendar. The default is ICOUK+0 (✓)
4 Clicking Today brings the calendar to current month and date (see 5&7)
5 The left arrow (<) reverses the calendar to back to previous months
7 The right arrow (>) forwards the calendar to future months (at least 12 months). Note that light orange background shade of the calendar indicates future (predicted) dates
8 The cogwheel opens the Setting Screen for additional functions
10 The current date is indicated by a dark orange square border
11 Any date clicked by the user is indicated by a light blue background
12 Any event (or holiday) on the date selected is shown on the calendar's bottom border
  Event markers (triangles) have been added on the relevant date from v1.1.0 update (9/2019)

 

iOS22 HijriCalUsage En
Figure 2
No Setting Screen Functions
13 Clicking the double-arrow will refresh the calendar data to the default ICOUK date settings
14 Clicking 3-dots menu will open miscellaneous functions as explained below
  Islamic Holidays - will show most common Hijri holiday dates which can be found by using the left and right arrows (also the Gregorian dates of the Islamic Holidays have been added from v1.1.0 update)
  Send Hilal Report - will open the website report form (via the Internet)
  How to use Widget - will open this User Guide page on the website
  Share this Widget - will enable forwarding the App Store link to others (on live Widget only)
  Rate this Widget - will enable open the App Store feedback page (on live Widget only)
  About this Widget - will display the current version, notice, disclaimer and contact information via the website form or from personal email
15 Clicking the (i) symbol will display the help-texts for that function
Adjust Day and Month

The Adjust Month setting is only enabled for when a non-ICOUK Adjust Day option (i.e. ICOUK +/- 1) is chosen, e.g. when using the Widgets from outside the UK. It will let you change the Hijri month length from 29 to 30 days and vice versa (if applicable) from the default ICOUK setting.

See example calendar below for adjusting the ICOUK Hijri Calendar to the Saudi Ummul Qura calendar setting for Rajab (Month 7) to Dhul Hijjah (Month 12).

Day and Month Adjust for UK & Saudi Arabia 1439

Month No Day Adjust ICOUK Month Adjust Shift Direction
7 ICOUK+1 (0) 30 (30) 30-days left shift
8 ICOUK+1 (0) 29 (29) 29-days left shift
9 ICOUK+1 (0) 30 (29) 29-days left shift
10 ICOUK+0 (0) 29 (30) 01-day right shift
11 ICOUK+1 (0) 29 (29) 29-days left shift
12 ICOUK+1 (0) 30 (29) 29-days left shift

iOS26 HijriCalUsage En 1439AH ICOUK HijriCal UQC1b

Note: if the Adjust Day and Month does not update the calendar automatically, simply click on the left (<) and right (>) arrows a few times. To revert back to ICOUK setting, simply click on the Refresh button, as explained in the setting description (13) in the previous section.

Synchronising Widget Dates with Actual Moon Sighting

The Islamic lunar months are 29 or 30 days long. Traditionally, actual moon sighting activities take place after the sunset of 29th lunar date. If verified sighting reports are received then the new month starts from the next day, otherwise, the month is completed as 30 days.

The predicted dates (Imkan Al Ruyat) used in the ICOUK Hijri Calendar Widgets are highly accurate, but on rare occasion, the Widget dates may not match with actual moon sighting decisions. This may happen in borderline cases due to undetermined factors (e.g. Zones of Uncertainty).

iOS27 Auto Refresh EnTherefore, on every 29th lunar date, the Widgets will try to Auto-Refresh the calendar data from the ICOUK Hijri database via the Internet before 12 midnight of the UK local time. If the Widget is unable to contact the web service, it will display a warning message on the bottom of the calendar (“No network connection. Please reconnect and refresh data”) for the user to manually refresh the data (see screenshot on the right). It will also replace ICOUK (✓) with a red question mark (?). See the setting description (13) in the previous section how to manually refresh the calendar data.

It is important to note that the Auto-Refresh function is not valid for those using the Widgets from outside the UK. They must wait until 12-midnight of the UK local time (e.g. after 3 am in Saudi Arabia) before manually refreshing the calendar data and then adjusting the dates for the new month to the local calendar using Adjust Day and Month options (if necessary).

Reasons for changing the Hijri date at Midnight

According to Islamic tradition, the Hijri date is effective from sunset to sunset. However, since the geographical location of the UK is above 48° latitude, which causes sunset to be very late during the summer months (i.e. 9:30 pm - 10 pm), leaving the Hijri date to change at 12-midnight is more prudent as it enables sufficient lead-time to carry out actual moon sighting, verification and decision-making process before updating the results on the ICOUK website database (for remote devices).

Furthermore, the website services are less resource-hungry at midnight than at early evenings, which helps the shared servers provide a more efficient service to many thousands of devices accessing the online database. It is also less confusing for new users to have both the Gregorian and the Hijri dates change at the same time.

Reasons for the start day of the week from Sunday

The names of the week in Arabic are:  Sunday (الأحد), Monday (الإثنين), Tuesday (الثلاثاء), Wednesday (الأربعاء), Thursday (الخميس), Friday (الجمعة) & Saturday (السبت).

The first day of the week being a Sunday (Yawm Al-Ahad, the First day) is also from the Tafsir of the Quran (Tafsir Ibn Kathir, Quran 7:54).

Hence, the Islamic week starts on a Sunday (i.e. not Friday) and ends on a Saturday (the seventh day of the week, as mentioned in above Tafsir). Therefore, the ICOUK Hijri calendar uses Sunday for the start of the week (in both Arabic and English). Note that the day name on the calendar has been abbreviated for space limitation reasons (i.e. to work on small devices).


If you have any comments regarding the above article, please email us via our on-line Contact Us form.