{"id":13612228,"url":"https://github.com/msarhan/ummalqura-calendar","last_synced_at":"2026-03-05T16:02:43.327Z","repository":{"id":29822088,"uuid":"33366603","full_name":"msarhan/ummalqura-calendar","owner":"msarhan","description":"Implementation of java.util.Calendar for the Umm Al-Qura calendar system.","archived":false,"fork":false,"pushed_at":"2023-04-06T14:35:28.000Z","size":149,"stargazers_count":164,"open_issues_count":9,"forks_count":53,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-07-20T21:39:43.651Z","etag":null,"topics":["calendar","date","hijrah","hijri","java","ummalqura-calendar"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/msarhan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2015-04-03T14:23:58.000Z","updated_at":"2025-03-18T16:49:24.000Z","dependencies_parsed_at":"2022-08-28T12:51:03.257Z","dependency_job_id":"8188a066-33a6-45d5-8a4a-2efdbbc4c19f","html_url":"https://github.com/msarhan/ummalqura-calendar","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/msarhan/ummalqura-calendar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msarhan%2Fummalqura-calendar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msarhan%2Fummalqura-calendar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msarhan%2Fummalqura-calendar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msarhan%2Fummalqura-calendar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/msarhan","download_url":"https://codeload.github.com/msarhan/ummalqura-calendar/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msarhan%2Fummalqura-calendar/sbom","scorecard":{"id":665280,"data":{"date":"2025-08-11","repo":{"name":"github.com/msarhan/ummalqura-calendar","commit":"fc1c70bfbd29dc28638ae123bf2a02f3ff05230d"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 2/27 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 5 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-21T17:48:10.523Z","repository_id":29822088,"created_at":"2025-08-21T17:48:10.524Z","updated_at":"2025-08-21T17:48:10.524Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30134574,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T15:35:27.018Z","status":"ssl_error","status_checked_at":"2026-03-05T15:35:23.768Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["calendar","date","hijrah","hijri","java","ummalqura-calendar"],"created_at":"2024-08-01T20:00:25.225Z","updated_at":"2026-03-05T16:02:43.304Z","avatar_url":"https://github.com/msarhan.png","language":"Java","funding_links":[],"categories":["أدوات للمطورين","Open Source Projects","日期时间"],"sub_categories":["جافا Java","APIs \u0026 Libraries","语音合成"],"readme":"[![Build Status](https://travis-ci.com/msarhan/ummalqura-calendar.svg?branch=master)](https://travis-ci.com/msarhan/ummalqura-calendar)\n[![Javadoc](https://www.javadoc.io/badge/com.github.msarhan/ummalqura-calendar.svg)](https://www.javadoc.io/doc/com.github.msarhan/ummalqura-calendar)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/msarhan/ummalqura-calendar/blob/master/LICENSE)\n[![Maven Central](https://img.shields.io/maven-central/v/com.github.msarhan/ummalqura-calendar.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.msarhan/ummalqura-calendar)\n[![Supported JVM Versions](https://img.shields.io/badge/JVM-7-brightgreen.svg?style=flat\u0026logo=Java)](https://www.oracle.com/java/technologies/javase/javase7-archive-downloads.html)\n\n# ummalqura-calendar\n\u003e Implementation of [`java.util.Calendar`](https://docs.oracle.com/javase/7/docs/api/java/util/Calendar.html) for the Umm Al-Qura calendar system.\nCalculation used in `version 2.x` was derived from [Java 8](https://docs.oracle.com/javase/8/docs/api/java/time/chrono/HijrahChronology.html).\nThis calculation is valid from **1300H** to **1600H**.\n\n## Table of contents\n  - [Installation](#installation)\n  - [Usage](#usage)\n    - [Using parametrized constructors](#using-parametrized-constructors)\n    - [Get + Set](#get--set)\n    - [Conversion](#conversion)\n      - [From Gregorian to Ummalqura](#from-gregorian-to-ummalqura)\n      - [From Ummalqura to Gregorian](#from-ummalqura-to-gregorian)\n    - [Formatting](#formatting)\n      - [Format using English locale](#format-using-english-locale)\n      - [Format using Arabic locale](#format-using-arabic-locale)\n    - [Parsing](#parsing)\n      - [Parse using English locale](#parse-using-english-locale)\n      - [Parse using Arabic locale](#parse-using-arabic-locale)\n  - [Localization: Add support for additional locales](#localization-add-support-for-additional-locales)\n\n## Installation\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.github.msarhan\u003c/groupId\u003e\n  \u003cartifactId\u003eummalqura-calendar\u003c/artifactId\u003e\n  \u003cversion\u003e[VERSION]\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Usage\n\n```java\n// Suppose current gregorian data/time is: Fri Apr 03 18:12:38 AST 2015\nUmmalquraCalendar cal = new UmmalquraCalendar();\ncal.get(Calendar.YEAR);         // 1436\ncal.get(Calendar.MONTH);        // 5 \u003c=\u003e Jumada al-Akhirah\ncal.get(Calendar.DAY_OF_MONTH); // 14\n```\n\n### Using parametrized constructors\n\n```java\nCalendar cal = new UmmalquraCalendar(1436, UmmalquraCalendar.SHAABAN, 11);\ncal.getTime(); // Fri May 29 00:00:00 AST 2015\n```\n```java\nCalendar cal = new UmmalquraCalendar(1436, UmmalquraCalendar.SHAABAN, 11, 18, 12, 38);\ncal.getTime(); // Fri May 29 18:12:38 AST 2015\n```\n\n### Get + Set\n\n```java\nCalendar cal = new UmmalquraCalendar();\ncal.set(Calendar.YEAR, 1436);\ncal.set(Calendar.MONTH, UmmalquraCalendar.SHAABAN);\ncal.set(Calendar.DAY_OF_MONTH, 11);\n\ncal.getTime(); // Fri May 29 20:57:37 AST 2015\n```\n\n```java\nCalendar cal = new UmmalquraCalendar(1436, UmmalquraCalendar.SHAABAN, 11);\ncal.get(Calendar.YEAR);         // 1436\ncal.get(Calendar.MONTH);        // 7\ncal.get(Calendar.DAY_OF_MONTH); // 11\n```\n\nGet month length in days\n```java\nCalendar cal = new UmmalquraCalendar(1437, UmmalquraCalendar.MUHARRAM, 1);\ncal.lengthOfMonth();                                               // 30\n// Or using static version:\nUmmalquraCalendar.lengthOfMonth(1437, UmmalquraCalendar.MUHARRAM); // 30\nUmmalquraCalendar.lengthOfMonth(1437, UmmalquraCalendar.SAFAR);    // 29\n```\n\nGet year length in days\n```java\nCalendar cal = new UmmalquraCalendar(1437, UmmalquraCalendar.MUHARRAM, 1);\ncal.lengthOfYear();                   // 354\n// Or using static version:\nUmmalquraCalendar.lengthOfYear(1435); // 355\t'Leap year'\nUmmalquraCalendar.lengthOfYear(1436); // 354\nUmmalquraCalendar.lengthOfYear(1437); // 354\n```\n\nRead month or week day name in a given style and `java.util.Locale`.\n```java\nCalendar cal = new UmmalquraCalendar(1436, UmmalquraCalendar.RABI_THANI, 21);\n\ncal.getDisplayName(Calendar.MONTH, Calendar.SHORT, Locale.ENGLISH);         // Rab-II\ncal.getDisplayName(Calendar.MONTH, Calendar.LONG, Locale.ENGLISH);          // Rabi' al-Thani\n\ncal.getDisplayName(Calendar.MONTH, Calendar.SHORT, new Locale(\"ar\"));       // ربيع 2\ncal.getDisplayName(Calendar.MONTH, Calendar.LONG, new Locale(\"ar\"));        // ربيع الثاني\n\ncal.getDisplayName(Calendar.DAY_OF_WEEK, Calendar.SHORT, Locale.ENGLISH);   // Tue\ncal.getDisplayName(Calendar.DAY_OF_WEEK, Calendar.LONG, Locale.ENGLISH);    // Tuesday\n\ncal.getDisplayName(Calendar.DAY_OF_WEEK, Calendar.SHORT, new Locale(\"ar\")); // ث\ncal.getDisplayName(Calendar.DAY_OF_WEEK, Calendar.LONG, new Locale(\"ar\"));  // الثلاثاء\n```\nRead month or week day names as a `java.util.Map` in a given style and `java.util.Locale`.\nWhere entry key will be the field name and entry value will be the corresponding field value.\n```java\nCalendar cal = new UmmalquraCalendar();\n\ncal.getDisplayNames(Calendar.MONTH, Calendar.SHORT, Locale.ENGLISH);\n//{Thul-Q=10, Rab-I=2, Saf=1, Shw=9, Muh=0, Thul-H=11, Sha=7, Rab-II=3, Raj=6, Ram=8, Jum-I=4, Jum-II=5}\ncal.getDisplayNames(Calendar.MONTH, Calendar.LONG, Locale.ENGLISH);\n//{Ramadhan=8, Rajab=6, Jumada al-Ula=4, Thul-Qi'dah=10, Sha'ban=7, Muharram=0, Safar=1, Thul-Hijjah=11, Shawwal=9, Rabi' al-Awwal=2, Jumada al-Akhirah=5, Rabi' al-Thani=3}\n\ncal.getDisplayNames(Calendar.MONTH, Calendar.SHORT, new Locale(\"ar\"));\n//{جمادى 2=5, رمضان=8, جمادى 1=4, ربيع 2=3, ذو القعدة=10, صفر=1, محرم=0, رجب=6, ربيع 1=2, شوال=9, شعبان=7, ذو الحجة=11}\ncal.getDisplayNames(Calendar.MONTH, Calendar.LONG, new Locale(\"ar\"));\n//{جمادى الآخرة=5, رمضان=8, ذو القعدة=10, صفر=1, محرم=0, رجب=6, ربيع الثاني=3, جمادى الأولى=4, شوال=9, شعبان=7, ربيع الأول=2, ذو الحجة=11}\n\ncal.getDisplayNames(Calendar.DAY_OF_WEEK, Calendar.SHORT, Locale.ENGLISH);\n//{Thu=5, Wed=4, Sun=1, Sat=7, Fri=6, Tue=3, Mon=2}\ncal.getDisplayNames(Calendar.DAY_OF_WEEK, Calendar.LONG, Locale.ENGLISH);\n//{Saturday=7, Thursday=5, Monday=2, Tuesday=3, Wednesday=4, Friday=6, Sunday=1}\n\ncal.getDisplayNames(Calendar.DAY_OF_WEEK, Calendar.SHORT, new Locale(\"ar\"));\n//{خ=5, ج=6, ح=1, ث=3, س=7, ر=4, ن=2}\ncal.getDisplayNames(Calendar.DAY_OF_WEEK, Calendar.LONG, new Locale(\"ar\"));\n//{الاثنين=2, الخميس=5, الجمعة=6, الأربعاء=4, الثلاثاء=3, الأحد=1, السبت=7}\n```\n\n### Conversion\n#### From Gregorian to Ummalqura\n\n```java\nGregorianCalendar gCal = new GregorianCalendar(2012, Calendar.FEBRUARY, 12);\nCalendar uCal = new UmmalquraCalendar();\nuCal.setTime(gCal.getTime());\n\nuCal.get(Calendar.YEAR);         // 1433\nuCal.get(Calendar.MONTH);        // 2\nuCal.get(Calendar.DAY_OF_MONTH); // 20\n\nuCal.getDisplayName(Calendar.MONTH, Calendar.SHORT, Locale.ENGLISH);\n```\n\n#### From Ummalqura to Gregorian\n\n```java\nCalendar uCal = new UmmalquraCalendar(1433, UmmalquraCalendar.RABI_AWWAL, 15);\nGregorianCalendar gCal = new GregorianCalendar();\ngCal.setTime(uCal.getTime());\n\ngCal.get(Calendar.YEAR);         // 2012\ngCal.get(Calendar.MONTH);        // 1\ngCal.get(Calendar.DAY_OF_MONTH); // 7\n```\n\n### Formatting\n\nYou can use `java.text.SimpleDateFormat` to format Ummalqura date.\n\n#### Format using English locale\n\n```java\nCalendar uCal = new UmmalquraCalendar(1433, UmmalquraCalendar.RABI_AWWAL, 8, 20, 45, 10);\nSimpleDateFormat dateFormat = new SimpleDateFormat(\"\", Locale.ENGLISH);\ndateFormat.setCalendar(uCal);\n\ndateFormat.applyPattern(\"d\");\ndateFormat.format(uCal.getTime()); // 8\n\ndateFormat.applyPattern(\"dd\");\ndateFormat.format(uCal.getTime()); // 08\n\ndateFormat.applyPattern(\"E\");\ndateFormat.format(uCal.getTime()); // Tue\n\ndateFormat.applyPattern(\"EEEE\");\ndateFormat.format(uCal.getTime()); // Tuesday\n\ndateFormat.applyPattern(\"M\");\ndateFormat.format(uCal.getTime()); // 3\n\ndateFormat.applyPattern(\"MM\");\ndateFormat.format(uCal.getTime()); // 03\n\ndateFormat.applyPattern(\"MMM\");\ndateFormat.format(uCal.getTime()); // Rab-I\n\ndateFormat.applyPattern(\"MMMM\");\ndateFormat.format(uCal.getTime()); // Rabi' al-Awwal\n\ndateFormat.applyPattern(\"y\");\ndateFormat.format(uCal.getTime()); // 1433\n\ndateFormat.applyPattern(\"yy\");\ndateFormat.format(uCal.getTime()); // 33\n\ndateFormat.applyPattern(\"EEEE d MMMM, y\");\ndateFormat.format(uCal.getTime()); // Tuesday 8 Rabi' al-Awwal, 1433\n\ndateFormat.applyPattern(\"y/MM/dd\");\ndateFormat.format(uCal.getTime()); // 1433/03/08\n\ndateFormat.applyPattern(\"y/MM/dd hh:mm a\");\ndateFormat.format(uCal.getTime()); // 1433/03/08 08:45 PM\n```\n\n#### Format using Arabic locale\n\n```java\nCalendar uCal = new UmmalquraCalendar(1433, UmmalquraCalendar.RABI_AWWAL, 8, 20, 45, 10);\nSimpleDateFormat dateFormat = new SimpleDateFormat(\"\", new Locale(\"ar\"));\ndateFormat.setCalendar(uCal);\n\ndateFormat.applyPattern(\"E\");\ndateFormat.format(uCal.getTime()); // ث\n\ndateFormat.applyPattern(\"EEEE\");\ndateFormat.format(uCal.getTime()); // الثلاثاء\n\ndateFormat.applyPattern(\"MMM\");\ndateFormat.format(uCal.getTime()); // ربيع 1\n\ndateFormat.applyPattern(\"MMMM\");\ndateFormat.format(uCal.getTime()); // ربيع الأول\n\ndateFormat.applyPattern(\"EEEE d MMMM, y\");\ndateFormat.format(uCal.getTime()); // الثلاثاء 8 ربيع الأول, 1433\n```\n\n### Parsing\n\nYou can use [`java.text.SimpleDateFormat`](https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html) to parse Ummalqura date.\n\n#### Parse using English locale\n\n```java\nLocale en = Locale.ENGLISH;\nUmmalquraCalendar uCal = new UmmalquraCalendar(en);\n\nSimpleDateFormat dateFormat = new SimpleDateFormat(\"\", en);\ndateFormat.setTimeZone(TimeZone.getTimeZone(\"UTC\"));\ndateFormat.setCalendar(uCal);\nuCal.set(Calendar.YEAR, 1420);                  // Used to properly format 'yy' pattern\ndateFormat.set2DigitYearStart(uCal.getTime());  // Used to properly format 'yy' pattern\n\nCalendar cal = new UmmalquraCalendar(en);\n\ndateFormat.applyPattern(\"d/M/y\");\ncal.setTime(dateFormat.parse(\"4/7/1435\"));\ncal.get(Calendar.YEAR);                                      // 1435\ncal.getDisplayName(Calendar.MONTH, Calendar.LONG, en);       // Rajab\ncal.get(Calendar.DAY_OF_MONTH);                              // 4\n\ndateFormat.applyPattern(\"MMMM d, y\");\ncal.setTime(dateFormat.parse(\"Jumada al-Ula 10, 1436\"));\ncal.get(Calendar.YEAR);                                      // 1436\ncal.getDisplayName(Calendar.MONTH, Calendar.LONG, en);       // Jumada al-Ula\ncal.get(Calendar.DAY_OF_MONTH);                              // 10\n\ndateFormat.applyPattern(\"EEEE, MMMM dd, y\");\ncal.setTime(dateFormat.parse(\"Saturday, Sha'ban 07, 1434\"));\ncal.get(Calendar.YEAR);                                      // 1434\ncal.getDisplayName(Calendar.MONTH, Calendar.LONG, en);       // Sha'ban\ncal.get(Calendar.DAY_OF_MONTH);                              // 7\n\ndateFormat.applyPattern(\"EEEE, MMMM d, yy hh:mm:ss\");\ncal.setTime(dateFormat.parse(\"Saturday, Jumada al-Ula 23, 36 12:19:44\"));\ncal.get(Calendar.YEAR);                                      // 1436\ncal.getDisplayName(Calendar.MONTH, Calendar.LONG, en);       // Jumada al-Ula\ncal.getDisplayName(Calendar.DAY_OF_WEEK, Calendar.LONG, en); // Saturday\ncal.get(Calendar.DAY_OF_MONTH);                              // 23\n```\n\n#### Parse using Arabic locale\n\n```java\nLocale ar = new Locale(\"ar\");\nUmmalquraCalendar uCal = new UmmalquraCalendar(ar);\n\nSimpleDateFormat dateFormat = new SimpleDateFormat(\"\", ar);\ndateFormat.setTimeZone(TimeZone.getTimeZone(\"UTC\"));\ndateFormat.setCalendar(uCal);\n// Used to properly format 'yy' pattern for dates in 14th century\nuCal.set(Calendar.YEAR, 1400);\ndateFormat.set2DigitYearStart(uCal.getTime());\n\nCalendar cal = new UmmalquraCalendar(ar);\n\ndateFormat.applyPattern(\"d/M/y\");\ncal.setTime(dateFormat.parse(\"4/7/1435\");\ncal.get(Calendar.YEAR);                                      // 1435\ncal.getDisplayName(Calendar.MONTH, Calendar.LONG, ar);       // رجب\ncal.get(Calendar.DAY_OF_MONTH);                              // 4\n\ndateFormat.applyPattern(\"MMMM d, y\");\ncal.setTime(dateFormat.parse(\"جمادى الأولى 10, 1436\"));\ncal.get(Calendar.YEAR);                                      // 1436\ncal.getDisplayName(Calendar.MONTH, Calendar.LONG, ar);       // جمادى الأولى\ncal.get(Calendar.DAY_OF_MONTH);                              // 10\n\ndateFormat.applyPattern(\"EEEE, MMMM dd, y\");\ncal.setTime(dateFormat.parse(\"السبت, شعبان 07, 1434\"));\ncal.get(Calendar.YEAR);                                      // 1434\ncal.getDisplayName(Calendar.MONTH, Calendar.LONG, ar);       // شعبان\ncal.get(Calendar.DAY_OF_MONTH);                              // 7\n\ndateFormat.applyPattern(\"EEEE, MMMM d, yy hh:mm:ss\");\ncal.setTime(dateFormat.parse(\"السبت, جمادى الأولى 23, 36 12:19:44\"));\ncal.get(Calendar.YEAR);                                      // 1436\ncal.getDisplayName(Calendar.MONTH, Calendar.LONG, ar);       // جمادى الأولى\ncal.getDisplayName(Calendar.DAY_OF_WEEK, Calendar.LONG, ar); // السبت\ncal.get(Calendar.DAY_OF_MONTH);                              // 23\n```\n\n## Localization: Add support for additional locales\nCurrently, `ummalqura-calendar` supports the following locales: Arabic, English and French.\nYou can add another locale by creating properties file with the following aspects:\n- It should be named `UmmalquraFormatData_[LOCALE].properties`, where `[LOCALE]` should be a language tag. e.g. `tr`, `zh_CN`\n- It should be placed in `com.github.msarhan.ummalqura.calendar.text` package and add it to the classpath.\n\nAs an example, French locale has been added as a [properties file](src/main/resources/com/github/msarhan/ummalqura/calendar/text/UmmalquraFormatData_fr.properties).\n\nPlease note that if properties file contains special characters that cannot be\nrepresented in **ISO-8859-1** encoding; it must be encoded by unicode escapes in the form `\\uXXXX`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsarhan%2Fummalqura-calendar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmsarhan%2Fummalqura-calendar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsarhan%2Fummalqura-calendar/lists"}