# mf275/persiancalendar architecture

> Architecture diagram of the GitHub repository mf275/persiancalendar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mf275/persiancalendar
- Repository: https://github.com/mf275/persiancalendar
- Video tour (about a minute): https://gitdiagram.com/mf275/persiancalendar/video

## Overview

Persian Calendar is a Java/Android date and time library offering standard and fast Solar Hijri calendars, date conversion, formatting/parsing, and calendar utilities. The principal workflow is a caller supplying or parsing a date, a calendar implementation computing Persian/Gregorian fields, and a formatter rendering the result; conversion and optional Hijri data are supporting stages. The graph distinguishes pure-Java and Android variants. Connections come from README statements and SOURCE INDEX references; unsampled modules are shown without speculative call flows.

Main entry points: [`pcalendar/src/main/java/com/farashian/pcalendar/PersianCalendar.java`](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/PersianCalendar.java) (Persian calendar), [`pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java) (Fast calendar), [`fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`](https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java) (Android fast calendar), [`pcalendar/src/main/java/com/farashian/pcalendar/PersianDateFormat.java`](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/PersianDateFormat.java) (Date formatting)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_java["Java Calendar APIs"]
  node_java_calendar["Persian calendar"]
  node_java_format["Date formatting"]
end

subgraph group_fast["Fast Calendar APIs"]
  node_fast_calendar["Fast calendar"]
  node_fast_format["Fast formatting"]
  node_fast_date_utils["Fast date utilities<br/>[FDateUtils.java]"]
end

subgraph group_android["Android Calendar APIs"]
  node_android_calendar["Android Persian calendar"]
  node_android_format["Android date formatting"]
  node_android_fast["Android fast calendar"]
  node_android_fast_format["Android fast formatting"]
  node_android_convert["Android conversion"]
  node_android_hijri["Android Hijri conversion"]
  node_android_numbers["Android number conversion"]
  node_android_date_utils["Android date utilities<br/>[DateUtils.java]"]
  node_fast_android_convert["Fast Android conversion"]
  node_fast_android_hijri["Fast Android Hijri"]
  node_fast_android_numbers["Fast Android numbers"]
  node_fast_android_constants["Fast Android constants<br/>[PCConstants.java]"]
  node_fast_android_ymd["Fast Android date value<br/>[YMD.java]"]
  node_fast_android_date_utils["Fast Android utilities<br/>[DateUtils.java]"]
end

subgraph group_mechanics["Conversion And Formatting"]
  node_java_convert["Date conversion"]
  node_java_hijri["Hijri conversion"]
  node_java_numbers["Number conversion"]
  node_constants["Calendar constants<br/>[PCConstants.java]"]
  node_ymd["Date value<br/>[YMD.java]"]
  node_date_utils["Date utilities<br/>[DateUtils.java]"]
  node_is_date_utils["Date checks<br/>[IsDateUtils.java]"]
  node_text_utils["Text utilities<br/>[TextUtils.java]"]
  node_log["Logging helper<br/>[Log.java]"]
end

node_caller(("Library caller"))

node_caller -->|"supplies date"| node_java_calendar
node_caller -->|"uses alternative"| node_fast_calendar
node_caller -->|"formats or parses"| node_java_format
node_java_calendar -->|"converts dates"| node_java_convert
node_java_calendar -->|"uses Hijri conversion"| node_java_hijri
node_java_calendar -->|"uses digits"| node_java_numbers
node_java_calendar -->|"uses calendar constants"| node_constants
node_java_format -->|"formats calendar"| node_java_calendar
node_java_format -->|"converts digits"| node_java_numbers
node_java_format -->|"uses calendar utilities"| node_java_convert
node_fast_calendar -->|"uses date utilities"| node_java_convert
node_fast_calendar -->|"uses Hijri conversion"| node_java_hijri
node_fast_calendar -->|"uses digits"| node_java_numbers
node_fast_calendar -->|"uses date value"| node_ymd
node_fast_format -->|"formats calendar"| node_fast_calendar
node_fast_format -->|"converts digits"| node_java_numbers
node_fast_format -->|"uses calendar utilities"| node_java_convert
node_date_utils -->|"references calendar"| node_java_calendar
node_date_utils -->|"references formatter"| node_java_format
node_android_calendar -->|"uses Hijri conversion"| node_android_hijri
node_android_calendar -->|"uses digits"| node_android_numbers
node_android_calendar -->|"uses date utilities"| node_android_convert
node_android_format -->|"uses digits"| node_android_numbers
node_android_format -->|"uses calendar utilities"| node_android_convert
node_android_fast -->|"uses date utilities"| node_fast_android_convert
node_android_fast -->|"uses Hijri conversion"| node_fast_android_hijri
node_android_fast -->|"uses digits"| node_fast_android_numbers
node_android_fast -->|"uses constants"| node_fast_android_constants
node_android_fast -->|"uses date value"| node_fast_android_ymd
node_android_fast_format -->|"uses date value"| node_fast_android_ymd
node_android_fast_format -->|"uses digits"| node_fast_android_numbers
node_android_fast_format -->|"uses calendar utilities"| node_fast_android_convert
node_fast_date_utils -->|"references calendar"| node_fast_calendar
node_fast_date_utils -->|"references formatter"| node_fast_format

click node_java_calendar "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/PersianCalendar.java"
click node_java_format "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/PersianDateFormat.java"
click node_fast_calendar "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java"
click node_fast_format "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianDateFormat.java"
click node_fast_date_utils "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/fast/FDateUtils.java"
click node_android_calendar "https://github.com/mf275/persiancalendar/blob/main/pcalendar-android/src/main/java/com/farashian/pcalendar/PersianCalendar.java"
click node_android_format "https://github.com/mf275/persiancalendar/blob/main/pcalendar-android/src/main/java/com/farashian/pcalendar/PersianDateFormat.java"
click node_android_fast "https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java"
click node_android_fast_format "https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianDateFormat.java"
click node_java_convert "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/PCalendarUtils.java"
click node_java_hijri "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/HijriConvertor.java"
click node_java_numbers "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/NumberConvertor.java"
click node_constants "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/PCConstants.java"
click node_ymd "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/YMD.java"
click node_date_utils "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/DateUtils.java"
click node_is_date_utils "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/IsDateUtils.java"
click node_text_utils "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/TextUtils.java"
click node_log "https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/Log.java"
click node_android_convert "https://github.com/mf275/persiancalendar/blob/main/pcalendar-android/src/main/java/com/farashian/pcalendar/PCalendarUtils.java"
click node_android_hijri "https://github.com/mf275/persiancalendar/blob/main/pcalendar-android/src/main/java/com/farashian/pcalendar/HijriConvertor.java"
click node_android_numbers "https://github.com/mf275/persiancalendar/blob/main/pcalendar-android/src/main/java/com/farashian/pcalendar/NumberConvertor.java"
click node_android_date_utils "https://github.com/mf275/persiancalendar/blob/main/pcalendar-android/src/main/java/com/farashian/pcalendar/DateUtils.java"
click node_fast_android_convert "https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/PCalendarUtils.java"
click node_fast_android_hijri "https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/HijriConvertor.java"
click node_fast_android_numbers "https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/NumberConvertor.java"
click node_fast_android_constants "https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/PCConstants.java"
click node_fast_android_ymd "https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/YMD.java"
click node_fast_android_date_utils "https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/DateUtils.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_java_calendar,node_java_format toneBlue
class node_fast_calendar,node_fast_format,node_fast_date_utils toneAmber
class node_android_calendar,node_android_format,node_android_fast,node_android_fast_format,node_android_convert,node_android_hijri,node_android_numbers,node_android_date_utils,node_fast_android_convert,node_fast_android_hijri,node_fast_android_numbers,node_fast_android_constants,node_fast_android_ymd,node_fast_android_date_utils toneMint
class node_java_convert,node_java_hijri,node_java_numbers,node_constants,node_ymd,node_date_utils,node_is_date_utils,node_text_utils,node_log toneRose
class node_caller toneIndigo
```

## Components

### Java Calendar APIs

- [Persian calendar](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/PersianCalendar.java): `pcalendar/src/main/java/com/farashian/pcalendar/PersianCalendar.java`
- [Date formatting](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/PersianDateFormat.java): `pcalendar/src/main/java/com/farashian/pcalendar/PersianDateFormat.java`

### Fast Calendar APIs

- [Fast calendar](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java): `pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`
- [Fast formatting](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianDateFormat.java): `pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianDateFormat.java`
- [Fast date utilities](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/fast/FDateUtils.java): `pcalendar/src/main/java/com/farashian/pcalendar/fast/FDateUtils.java`

### Android Calendar APIs

- [Android Persian calendar](https://github.com/mf275/persiancalendar/blob/main/pcalendar-android/src/main/java/com/farashian/pcalendar/PersianCalendar.java): `pcalendar-android/src/main/java/com/farashian/pcalendar/PersianCalendar.java`
- [Android date formatting](https://github.com/mf275/persiancalendar/blob/main/pcalendar-android/src/main/java/com/farashian/pcalendar/PersianDateFormat.java): `pcalendar-android/src/main/java/com/farashian/pcalendar/PersianDateFormat.java`
- [Android fast calendar](https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java): `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`
- [Android fast formatting](https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianDateFormat.java): `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianDateFormat.java`
- [Android conversion](https://github.com/mf275/persiancalendar/blob/main/pcalendar-android/src/main/java/com/farashian/pcalendar/PCalendarUtils.java): `pcalendar-android/src/main/java/com/farashian/pcalendar/PCalendarUtils.java`
- [Android Hijri conversion](https://github.com/mf275/persiancalendar/blob/main/pcalendar-android/src/main/java/com/farashian/pcalendar/HijriConvertor.java): `pcalendar-android/src/main/java/com/farashian/pcalendar/HijriConvertor.java`
- [Android number conversion](https://github.com/mf275/persiancalendar/blob/main/pcalendar-android/src/main/java/com/farashian/pcalendar/NumberConvertor.java): `pcalendar-android/src/main/java/com/farashian/pcalendar/NumberConvertor.java`
- [Android date utilities](https://github.com/mf275/persiancalendar/blob/main/pcalendar-android/src/main/java/com/farashian/pcalendar/DateUtils.java): `pcalendar-android/src/main/java/com/farashian/pcalendar/DateUtils.java`
- [Fast Android conversion](https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/PCalendarUtils.java): `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/PCalendarUtils.java`
- [Fast Android Hijri](https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/HijriConvertor.java): `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/HijriConvertor.java`
- [Fast Android numbers](https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/NumberConvertor.java): `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/NumberConvertor.java`
- [Fast Android constants](https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/PCConstants.java): `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/PCConstants.java`
- [Fast Android date value](https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/YMD.java): `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/YMD.java`
- [Fast Android utilities](https://github.com/mf275/persiancalendar/blob/main/fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/DateUtils.java): `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/util/DateUtils.java`

### Conversion And Formatting

- [Date conversion](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/PCalendarUtils.java): `pcalendar/src/main/java/com/farashian/pcalendar/util/PCalendarUtils.java`
- [Hijri conversion](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/HijriConvertor.java): `pcalendar/src/main/java/com/farashian/pcalendar/util/HijriConvertor.java`
- [Number conversion](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/NumberConvertor.java): `pcalendar/src/main/java/com/farashian/pcalendar/util/NumberConvertor.java`
- [Calendar constants](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/PCConstants.java): `pcalendar/src/main/java/com/farashian/pcalendar/PCConstants.java`
- [Date value](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/YMD.java): `pcalendar/src/main/java/com/farashian/pcalendar/YMD.java`
- [Date utilities](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/DateUtils.java): `pcalendar/src/main/java/com/farashian/pcalendar/util/DateUtils.java`
- [Date checks](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/IsDateUtils.java): `pcalendar/src/main/java/com/farashian/pcalendar/util/IsDateUtils.java`
- [Text utilities](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/TextUtils.java): `pcalendar/src/main/java/com/farashian/pcalendar/util/TextUtils.java`
- [Logging helper](https://github.com/mf275/persiancalendar/blob/main/pcalendar/src/main/java/com/farashian/pcalendar/util/Log.java): `pcalendar/src/main/java/com/farashian/pcalendar/util/Log.java`

### Other components

- **Library caller**

## Connections

- Library caller → Persian calendar: supplies date (evidence: `README.md`)
- Library caller → Fast calendar: uses alternative (evidence: `README.md`)
- Library caller → Date formatting: formats or parses (evidence: `README.md`)
- Persian calendar → Date conversion: converts dates (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/PersianCalendar.java`)
- Persian calendar → Hijri conversion: uses Hijri conversion (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/PersianCalendar.java`)
- Persian calendar → Number conversion: uses digits (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/PersianCalendar.java`)
- Persian calendar → Calendar constants: uses calendar constants (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/PersianCalendar.java`)
- Date formatting → Persian calendar: formats calendar (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/PersianDateFormat.java`)
- Date formatting → Number conversion: converts digits (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/PersianDateFormat.java`)
- Date formatting → Date conversion: uses calendar utilities (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/PersianDateFormat.java`)
- Fast calendar → Date conversion: uses date utilities (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`)
- Fast calendar → Hijri conversion: uses Hijri conversion (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`)
- Fast calendar → Number conversion: uses digits (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`)
- Fast calendar → Date value: uses date value (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`)
- Fast formatting → Fast calendar: formats calendar (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianDateFormat.java`)
- Fast formatting → Number conversion: converts digits (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianDateFormat.java`)
- Fast formatting → Date conversion: uses calendar utilities (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/fast/FastPersianDateFormat.java`)
- Date utilities → Persian calendar: references calendar (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/util/DateUtils.java`)
- Date utilities → Date formatting: references formatter (evidence: `pcalendar/src/main/java/com/farashian/pcalendar/util/DateUtils.java`)
- Android Persian calendar → Android Hijri conversion: uses Hijri conversion (evidence: `pcalendar-android/src/main/java/com/farashian/pcalendar/PersianCalendar.java`)
- Android Persian calendar → Android number conversion: uses digits (evidence: `pcalendar-android/src/main/java/com/farashian/pcalendar/PersianCalendar.java`)
- Android Persian calendar → Android conversion: uses date utilities (evidence: `pcalendar-android/src/main/java/com/farashian/pcalendar/PersianCalendar.java`)
- Android date formatting → Android number conversion: uses digits (evidence: `pcalendar-android/src/main/java/com/farashian/pcalendar/PersianDateFormat.java`)
- Android date formatting → Android conversion: uses calendar utilities (evidence: `pcalendar-android/src/main/java/com/farashian/pcalendar/PersianDateFormat.java`)
- Android fast calendar → Fast Android conversion: uses date utilities (evidence: `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`)
- Android fast calendar → Fast Android Hijri: uses Hijri conversion (evidence: `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`)
- Android fast calendar → Fast Android numbers: uses digits (evidence: `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`)
- Android fast calendar → Fast Android constants: uses constants (evidence: `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`)
- Android fast calendar → Fast Android date value: uses date value (evidence: `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianCalendar.java`)
- Android fast formatting → Fast Android date value: uses date value (evidence: `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianDateFormat.java`)
- Android fast formatting → Fast Android numbers: uses digits (evidence: `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianDateFormat.java`)
- Android fast formatting → Fast Android conversion: uses calendar utilities (evidence: `fpcalendar-android/src/main/java/com/farashian/pcalendar/fast/FastPersianDateFormat.java`)
- Fast date utilities → Fast calendar: references calendar
- Fast date utilities → Fast formatting: references formatter
