# دادهٔ مرجع

این پوشه شامل داده‌های مرجع و راستی‌آزمایی‌شده برای تست هر نوع پیاده‌سازی یا کتابخونهٔ تقویم هجری شمسی (جلالی) است. برای اینکه ببینید چطور می‌تونید با این فایل‌ها کد خودتون رو تست کنید، صفحهٔ [۹. آزمون](https://goudarzjafari.com/fa/persian-calendar/testing/) رو ببینید.

| فایل                                                                                                                   | محتوا                                                                                                                                                         |
| ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`years.csv`](https://goudarzjafari.com/persian-calendar/files/data/years.csv)                                         | اطلاعات کامل سال‌های ۱۱۷۸ تا ۳۰۰۰ ه‍.ش (۱٬۸۲۳ سال): شامل کبیسه بودن، تعداد روزهای سال، تاریخ میلادی نوروز، شمارهٔ روز جولیانی (JDN) نوروز و روز هفتهٔ اول سال |
| [`test-vectors.csv`](https://goudarzjafari.com/persian-calendar/files/data/test-vectors.csv)                           | ۸٬۵۱۰ نمونهٔ تست مرزی برای تبدیل دوطرفهٔ شمسی و میلادی (`jy, jm, jd, gy, gm, gd, jdn, weekday`)                                                               |
| [`leap-years.txt`](https://goudarzjafari.com/persian-calendar/files/data/leap-years.txt)                               | فهرست ۴۴۲ سال کبیسه در بازهٔ ۱۱۷۸ تا ۳۰۰۰ ه‍.ش (هر خط یک سال)                                                                                                 |
| [`corrections.txt`](https://goudarzjafari.com/persian-calendar/files/data/corrections.txt)                             | فهرست ۷۸ سالی که در اون‌ها قاعدهٔ ۳۳ سالهٔ ساده نیاز به اصلاح داره                                                                                            |
| [`locale-names.json`](https://goudarzjafari.com/persian-calendar/files/data/locale-names.json)                         | نام ماه‌ها، روزهای هفته و پسوند تقویم برای ۱۱ زبان و فرهنگ، استخراج‌شده از استاندارد Unicode CLDR 48                                                          |
| [`official/kabise-1206-1498.txt`](https://goudarzjafari.com/persian-calendar/files/data/official/kabise-1206-1498.txt) | نسخهٔ متنی جدول رسمی کبیسه‌های مرکز تقویم دانشگاه تهران برای سال‌های ۱۲۰۶ تا ۱۴۹۸ (تهیه‌شده توسط روزبه پورنادر با مجوز CC0)                                   |

**قراردادهای یکسان در تمام فایل‌ها:** شمارهٔ ماه‌ها از `1` تا `12` (`1` = فروردین)؛ روز هفته از `0` = شنبه تا `6` = جمعه؛ `jdn` برابر با شمارهٔ روز جولیانی؛ تاریخ‌های میلادی بر پایهٔ تقویم میلادی امتدادیافته (Proleptic Gregorian)؛ و انکودینگ فایل‌ها UTF-8 با پایان خط LF (`\n`) است.

**این فایل‌ها رو دستی ویرایش نکنید.** فایل‌های `.csv` و `.txt` مستقیما توسط ابزار محاسبات نجومی در [`tools/calendar-data`](https://goudarzjafari.com/fa/persian-calendar/tools/calendar-data/) (با دستور `cargo run --release`) ساخته می‌شن که قبل از نوشتن خروجی، مطابقت کاملش رو با جدول رسمی مرکز تقویم چک می‌کنه. فایل `locale-names.json` هم با اسکریپت [`tools/generate_locale_data.mjs`](https://github.com/Goudarz/PersianCalendar/blob/main/tools/generate_locale_data.mjs) تولید می‌شه.

**مجوز (License):** تمام فایل‌های تولیدشده و همچنین فایل `official/kabise-1206-1498.txt` با مجوز مالکیت عمومی [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) منتشر شدن و استفاده از اون‌ها در هر پروژه‌ای کاملا آزاده.

---

نشانی صفحه: https://goudarzjafari.com/fa/persian-calendar/data/
مجوز: متن CC BY 4.0، کد MIT، داده CC0 1.0. نسخهٔ 1.0.0 از https://github.com/Goudarz/PersianCalendar
