پرش به محتوای اصلی
فهرست مطالب

داده و راستی‌آزمایی

دادهٔ مرجع

۱ دقیقه مطالعهبه‌روزرسانی

این پوشه شامل داده‌های مرجع و راستی‌آزمایی‌شده برای تست هر نوع پیاده‌سازی یا کتابخونهٔ تقویم هجری شمسی (جلالی) است. برای اینکه ببینید چطور می‌تونید با این فایل‌ها کد خودتون رو تست کنید، صفحهٔ ۹. آزمون رو ببینید.

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

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

این فایل‌ها رو دستی ویرایش نکنید. فایل‌های .csv و .txt مستقیما توسط ابزار محاسبات نجومی در tools/calendar-data (با دستور cargo run --release) ساخته می‌شن که قبل از نوشتن خروجی، مطابقت کاملش رو با جدول رسمی مرکز تقویم چک می‌کنه. فایل locale-names.json هم با اسکریپت tools/generate_locale_data.mjs تولید می‌شه.

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