کتابخانه‌ی استاندارد · زمان و همروندی

تقویم calendar

تقویم جلالی، هجری قمری و میلادی: تبدیل، حساب روزها، نام ماه‌ها و منطقه‌های زمانی.

واردسازی تقویم

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

این بسته با سه تقویم کار می‌کند: جلالی (هجری شمسی، تقویم رسمی ایران و افغانستان)، هجری قمری و میلادی. هر تاریخ یک ساختار ساده با سال، ماه و روز است و هر تقویم تابع‌های تبدیل، اعتبارسنجی، حساب روز و نام ماه خودش را دارد.

تقویم هجری این بسته حسابی است: ماه‌ها یکی در میان ۳۰ و ۲۹ روزند و با دیدن ماه تنظیم نمی‌شوند؛ پس ممکن است یک روز با تقویم رسمی کشورها فرق کند.

برای تبدیل لحظه به تاریخ، سه راه هست: زمان به جلالی و همتاهایش به وقت محلی رایانه، تاریخ جلالی محلی با یک منطقه‌ی زمانی ثابت مثل تهران، و بارگذاری منطقه برای منطقه‌هایی که ساعت تابستانی دارند.

از این بسته برای نشان دادن تاریخ به شکلی که مردم ایران، افغانستان یا کشورهای عربی می‌خوانند، برای گرفتن تاریخ جلالی از یک فرم و برای تبدیل ساعت یک جلسه در یک شهر به ساعت شهر دیگر استفاده کنید. لحظه‌ها، مدت‌ها و خود ساعت در بسته‌ی زمان هستند؛ لحظه‌ها را همان‌جا ذخیره کنید و فقط برای نمایش به تقویم تبدیل کنید. برای رقم‌های فارسی در خروجی، بین‌المللی‌سازی را ببینید.

اشتباه‌های رایج:

  • گرفتن تاریخ امروز روی سرور با امروز جلالی یا زمان به جلالی. این‌ها منطقه‌ی زمانی دستگاه را به کار می‌برند و سروری که روی وقت جهانی است تا ساعت ۳:۳۰ بامداد تهران هنوز در روز قبل است. تاریخ جلالی محلی(زمان.اکنون()، منطقه زمانی تهران()) را به کار ببرید.
  • قاطی کردن دو شماره‌گذاری روزهای هفته. شماره روز هفته جلالی یک شماره‌ی روز ژولینی می‌گیرد و از شنبه با صفر می‌شمارد؛ روز هفته، روز هفته جلالی و دیگر تابع‌های روز هفته از یکشنبه با صفر می‌شمارند.
  • تبدیل ورودی بررسی‌نشده. تابع‌های تبدیل ورودی را بررسی نمی‌کنند، پس ۳۱ اسفند یا ماه ۱۳ به‌جای خطا تاریخ نادرستی می‌دهد. اول با تاریخ جلالی معتبر است و همتاهایش بررسی کنید.
  • انتظار این‌که تاریخ‌های هجری روز به روز با تقویم رسمی یکی باشند، یا منطقه‌های ثابت لندن و نیویورک ساعت تابستانی را دنبال کنند. چنین نیست؛ برای آن بارگذاری منطقه را به کار ببرید.

تبدیل جلالی همان روش حسابی رایج است (مثل کتابخانه‌های jalaali) که برای سال‌های ۶۱- تا ۳۱۷۷ کار می‌کند و برای سال‌های امروزی با تقویم رسمی ایران یکی است.

تولد و سالگرد به تقویم جلالی

تاریخ‌ها ساختارهای ساده‌اند، پس منطق تاریخ همان کد معمولی است: تاریخ را در سال جاری بسازید، با مقایسه تاریخ جلالی آن را با امروز بسنجید و اگر گذشته بود به سال بعد بروید. روزهای بین جلالی روزهای میان دو تاریخ را می‌شمارد و جلالی به میلادی همان روز را در تقویم دیگر می‌دهد.

calendar-guide-birthday.salam
واردسازی تقویم

تابع تولد بعدی(زادروز: تقویم.تاریخ جلالی، امروز: تقویم.تاریخ جلالی): تقویم.تاریخ جلالی:
    ناپایا سال هدف := امروز.سال
    ناپایا روز هدف := زادروز.روز
    اگر زادروز.ماه == ۱۲ و روز هدف == ۳۰ و وارونه تقویم.سال کبیسه جلالی(سال هدف):
        روز هدف = ۲۹
    پایان
    ناپایا بعدی := تقویم.تاریخ جلالی { سال = سال هدف، ماه = زادروز.ماه، روز = روز هدف }
    اگر تقویم.مقایسه تاریخ جلالی(بعدی، امروز) < ۰:
        سال هدف++
        روز هدف = زادروز.روز
        اگر زادروز.ماه == ۱۲ و روز هدف == ۳۰ و وارونه تقویم.سال کبیسه جلالی(سال هدف):
            روز هدف = ۲۹
        پایان
        بعدی = تقویم.تاریخ جلالی { سال = سال هدف، ماه = زادروز.ماه، روز = روز هدف }
    پایان
    برگشت بعدی
پایان

تابع ریشه:
    امروز := تقویم.تاریخ جلالی { سال = ۱۴۰۵، ماه = ۷، روز = ۲۵ }
    زادروز := تقویم.تاریخ جلالی { سال = ۱۳۷۰، ماه = ۹، روز = ۳ }
    ناپایا سن := امروز.سال - زادروز.سال
    تولد امسال := تقویم.تاریخ جلالی { سال = امروز.سال، ماه = زادروز.ماه، روز = زادروز.روز }
    اگر تقویم.مقایسه تاریخ جلالی(تولد امسال، امروز) > ۰:
        سن--
    پایان
    بعدی := تولد بعدی(زادروز، امروز)
    سرچاپ "سن:"، سن
    سرچاپ "تولد بعدی:"، تقویم.قالب جلالی(بعدی)، "(" + تقویم.نام ماه جلالی(بعدی.ماه) + ")"
    سرچاپ "روزهای مانده:"، تقویم.روزهای بین جلالی(امروز، بعدی)
    سرچاپ "به تقویم میلادی:"، تقویم.قالب میلادی(تقویم.جلالی به میلادی(بعدی))
    کبیسه := تقویم.تاریخ جلالی { سال = ۱۴۰۳، ماه = ۱۲، روز = ۳۰ }
    سرچاپ "زاده‌ی ۳۰ اسفند ۱۴۰۳، جشن تولدش در ۱۴۰۵:"، تقویم.قالب جلالی(تولد بعدی(کبیسه، امروز))
پایان
خروجیسن: 34 تولد بعدی: 1405-09-03 (آذر) روزهای مانده: 38 به تقویم میلادی: 2026-11-24 زاده‌ی ۳۰ اسفند ۱۴۰۳، جشن تولدش در ۱۴۰۵: 1405-12-29

یک حالت دقت می‌خواهد: ۳۰ اسفند فقط در سال کبیسه هست. پیش از ساختن تاریخی در سال دیگر، آن را با سال کبیسه جلالی یا تاریخ جلالی معتبر است بسنجید؛ نمونه چنین تولدی را به ۲۹ اسفند می‌برد. وقتی فقط می‌خواهید تاریخ را جابه‌جا کنید، افزودن سال جلالی و افزودن ماه جلالی همین کار را خودشان انجام می‌دهند.

کشیدن یک ماه

نمای ماه دو عدد لازم دارد: روز هفته‌ی نخستین روز ماه و طول ماه. شماره روز هفته جلالی روزها را از شنبه با ۰ شماره می‌زند، همان‌طور که تقویم‌های فارسی چیده می‌شوند، و روزهای ماه جلالی طول ماه را می‌دهد.

calendar-guide-month.salam
واردسازی تقویم
واردسازی رشته

تابع ریشه:
    سال نمایش := ۱۴۰۵
    ماه نمایش := ۷
    نخستین := تقویم.تاریخ جلالی { سال = سال نمایش، ماه = ماه نمایش، روز = ۱ }
    سرچاپ تقویم.نام ماه جلالی(ماه نمایش)، سال نمایش
    سرچاپ " ش  ی  د  س  چ  پ  ج"
    جابه‌جایی := تقویم.شماره روز هفته جلالی(تقویم.جلالی به روز ژولیانی(نخستین))
    ناپایا خط := ""
    تکرار جابه‌جایی:
        خط += "   "
    پایان
    روزها := تقویم.روزهای ماه جلالی(سال نمایش، ماه نمایش)
    تکرار ۱ تا روزها در ر:
        اگر ر < ۱۰:
            خط += " "
        پایان
        خط += رشته.از عدد(ر)
        اگر (جابه‌جایی + ر) % ۷ == ۰:
            سرچاپ خط
            خط = ""
        وگرنه:
            خط += " "
        پایان
    پایان
    اگر خط != "":
        سرچاپ خط.پیراست()
    پایان
    سرچاپ "آغاز در"، تقویم.قالب طولانی جلالی(نخستین)، "برابر"، تقویم.قالب میلادی(تقویم.جلالی به میلادی(نخستین))
پایان
خروجیمهر 1405 ش ی د س چ پ ج 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 آغاز در 1 مهر 1405 برابر 2026-09-23

برای هفته‌ای که از یکشنبه یا دوشنبه شروع می‌شود، از روز هفته جلالی یا روز هفته میلادی استفاده کنید که از یکشنبه با ۰ شماره می‌زنند، و به اندازه‌ی روزی که می‌خواهید اول بیاید جابه‌جا کنید.

یک ماه قمری در تقویم‌های دیگر

برای رمضان یا محرم معمولاً می‌خواهید تاریخ‌های قمری را به میلادی و جلالی برگردانید. روزهای ماه هجری طول ماه را می‌دهد و افزودن روز هجری از روز نخست تا روز آخر پیش می‌رود.

calendar-guide-ramadan.salam
واردسازی تقویم

تابع ریشه:
    آغاز := تقویم.تاریخ هجری قمری { سال = ۱۴۴۸، ماه = ۹، روز = ۱ }
    روزها := تقویم.روزهای ماه هجری(آغاز.سال، آغاز.ماه)
    آخرین := تقویم.افزودن روز هجری(آغاز، روزها - ۱)
    عید := تقویم.افزودن روز هجری(آخرین، ۱)
    سرچاپ تقویم.نام ماه هجری قمری(آغاز.ماه)، آغاز.سال، "دارای"، روزها، "روز است"
    سرچاپ "روز نخست:"، تقویم.قالب میلادی(تقویم.هجری به میلادی(آغاز))، "="، تقویم.قالب جلالی(تقویم.هجری به جلالی(آغاز))
    سرچاپ "روز آخر: "، تقویم.قالب میلادی(تقویم.هجری به میلادی(آخرین))، "="، تقویم.قالب جلالی(تقویم.هجری به جلالی(آخرین))
    سرچاپ "عید فطر:  "، تقویم.قالب میلادی(تقویم.هجری به میلادی(عید))، تقویم.نام روز هفته فارسی(تقویم.روز هفته هجری(عید))
    سرچاپ "به فارسی:"، تقویم.قالب طولانی هجری فارسی(عید)
پایان
خروجیرمضان 1448 دارای 30 روز است روز نخست: 2027-02-08 = 1405-11-19 روز آخر: 2027-03-09 = 1405-12-18 عید فطر: 2027-03-10 چهارشنبه به فارسی: 1 شوال 1448

یادتان باشد که این تقویم قمری حسابی است. آغاز رسمی هر ماه به رؤیت ماه بستگی دارد، ممکن است یک روز زودتر یا دیرتر باشد و میان کشورها فرق کند؛ پس این تاریخ‌ها را به‌عنوان تخمین نشان دهید.

یک جلسه، چند شهر

برای برنامه‌ریزی میان منطقه‌های زمانی، تاریخ و ساعت محلی یک منطقه را با محلی به زمان مطلق به یک لحظه تبدیل کنید و بعد همان لحظه را در هر منطقه‌ی دیگر نشان دهید. بارگذاری منطقه پایگاه داده‌ی منطقه‌های زمانی سیستم را می‌خواند، پس ساعت تابستانی هم حساب می‌شود: لندن در ۲۵ مارس ۲۰۲۶ روی GMT است و یک هفته بعد روی BST، در حالی که نیویورک پیش‌تر به EDT رفته بود.

calendar-guide-meeting.salam
واردسازی تقویم

تابع نمایش(برچسب: رشته، لحظه: صحیح۶۴، نام منطقه: رشته):
    ناپایا م := تقویم.بارگذاری منطقه(نام منطقه)
    ز := تقویم.منطقه زمانی در(م، لحظه)
    ت := تقویم.تاریخ میلادی محلی(لحظه، ز)
    س := تقویم.ساعت محلی(لحظه، ز)
    سرچاپ برچسب، تقویم.قالب میلادی(ت)، تقویم.قالب ساعت(س)، تقویم.نماد منطقه(م، لحظه)
    تقویم.آزادسازی منطقه(م)
پایان

تابع ریشه:
    ناپایا تهران := تقویم.بارگذاری منطقه("Asia/Tehran")
    روز جلسه := تقویم.تاریخ میلادی { سال = ۲۰۲۶، ماه = ۳، روز = ۲۵ }
    ساعت := تقویم.زمان ساعت { ساعت = ۱۸، دقیقه = ۳۰ }
    جلسه := تقویم.محلی به زمان مطلق(روز جلسه، ساعت، تهران)
    تقویم.آزادسازی منطقه(تهران)
    نمایش("تهران:   "، جلسه، "Asia/Tehran")
    نمایش("لندن:    "، جلسه، "Europe/London")
    نمایش("نیویورک: "، جلسه، "America/New_York")
    نمایش("توکیو:   "، جلسه، "Asia/Tokyo")
    نمایش("یک هفته بعد در لندن:"، جلسه + ۷ * ۸۶۴۰۰، "Europe/London")
پایان
خروجیتهران: 2026-03-25 18:30:00 +0330 لندن: 2026-03-25 15:00:00 GMT نیویورک: 2026-03-25 11:00:00 EDT توکیو: 2026-03-26 00:00:00 JST یک هفته بعد در لندن: 2026-04-01 16:00:00 BST

بارگذاری منطقه پرونده‌های منطقه‌ای را لازم دارد که لینوکس و مک در /usr/share/zoneinfo نگه می‌دارند؛ ok نتیجه را بسنجید. برای منطقه‌ای با اختلاف ثابت، مثل تهران از وقتی ایران ساعت تابستانی را کنار گذاشت، منطقه زمانی تهران() یا منطقه زمانی ثابت همراه تاریخ جلالی محلی هیچ پرونده‌ای نمی‌خواهد. منطقه‌ی بارگذاری‌شده را وقتی کارتان تمام شد با آزادسازی منطقه آزاد کنید.

کدام تابع برای کدام کار

کاراز این استفاده کنید
تبدیل میان تقویم‌هامیلادی به جلالی، جلالی به میلادی، هجری به جلالی و بقیه
تاریخ امروزامروز جلالی، امروز میلادی، امروز هجری
تاریخ از روی لحظه‌ی ذخیره‌شدهتاریخ جلالی محلی(لحظه، منطقه زمانی تهران())، یا زمان به جلالی برای ساعت محلی
جابه‌جا کردن تاریخافزودن روز جلالی، افزودن ماه جلالی، افزودن سال جلالی
مقایسه یا شمردن روزهامقایسه تاریخ جلالی، روزهای بین جلالی
بررسی ورودی کاربرتاریخ جلالی معتبر است، تاریخ میلادی معتبر است، تاریخ هجری معتبر است
نمایش تاریخقالب جلالی، قالب طولانی جلالی، قالب طولانی هجری عربی، قالب طولانی میلادی
منطقه‌های دارای ساعت تابستانیبارگذاری منطقه، محلی به زمان مطلق، منطقه زمانی در

گونه‌ها

منطقه زمانی TimeZone

ساختار منطقه زمانی
منطقه‌ی زمانی با اختلاف ثابت از وقت جهانی.
نامانگلیسیگونهتوضیح
نامnameرشته = "UTC"نام منطقه، مثل Asia/Tehran.
اختلاف دقیقه‌ایoffset_minutesصحیح = 0اختلاف با وقت جهانی بر حسب دقیقه؛ برای تهران ۲۱۰.
calendar-TimeZone.salam
واردسازی تقویم

تابع ریشه:
    ت := ۱۷۱۰۹۴۳۵۰۹
    تهران := تقویم.منطقه زمانی تهران()
    سرچاپ تهران.نام، تهران.اختلاف دقیقه‌ای
    سرچاپ تقویم.قالب جلالی(تقویم.تاریخ جلالی محلی(ت، تهران))، تقویم.قالب ساعت(تقویم.ساعت محلی(ت، تهران))
    سرچاپ تقویم.قالب میلادی(تقویم.تاریخ میلادی محلی(ت، تقویم.منطقه زمانی توکیو()))، تقویم.قالب ساعت(تقویم.ساعت محلی(ت، تقویم.منطقه زمانی توکیو()))
    سرچاپ تقویم.قالب هجری(تقویم.تاریخ هجری محلی(ت، تقویم.منطقه زمانی مکه()))
    هر منطقه در [تقویم.منطقه زمانی جهانی()، تقویم.منطقه زمانی کابل()، تقویم.منطقه زمانی ریاض()، تقویم.منطقه زمانی دبی()، تقویم.منطقه زمانی استانبول()، تقویم.منطقه زمانی لندن()، تقویم.منطقه زمانی نیویورک()]:
        سرچاپ منطقه.نام، منطقه.اختلاف دقیقه‌ای، تقویم.قالب ساعت(تقویم.ساعت محلی(ت، منطقه))
    پایان
    م := تقویم.تاریخ میلادی { سال = ۲۰۲۴، ماه = ۳، روز = ۲۰ }
    س := تقویم.زمان ساعت { ساعت = ۲۳، دقیقه = ۰، ثانیه = ۰ }
    سرچاپ تقویم.میلادی محلی به زمان مطلق(م، س، تهران)
    سرچاپ تقویم.قالب میلادی(تقویم.تبدیل میلادی بین مناطق زمانی(م، س، تهران، تقویم.منطقه زمانی توکیو()))، تقویم.قالب ساعت(تقویم.تبدیل ساعت بین مناطق زمانی(م، س، تهران، تقویم.منطقه زمانی توکیو()))
    ثابت := تقویم.منطقه زمانی ثابت("UTC+05:30"، ۳۳۰)
    سرچاپ ثابت.نام، تقویم.قالب ساعت(تقویم.ساعت محلی(ت، ثابت))
    محلی := تقویم.منطقه زمانی محلی(ت)
    سرچاپ محلی.نام، محلی.اختلاف دقیقه‌ای == تقویم.اختلاف زمانی محلی(ت)
پایان
خروجیAsia/Tehran 210 1403-01-01 17:35:09 2024-03-20 23:05:09 1445-09-10 UTC 0 14:05:09 Asia/Kabul 270 18:35:09 Asia/Riyadh 180 17:05:09 Asia/Dubai 240 18:05:09 Europe/Istanbul 180 17:05:09 Europe/London 0 14:05:09 America/New_York -300 09:05:09 1710963000 2024-03-21 04:30:00 UTC+05:30 19:35:09 Local true

تاریخ میلادی GregorianDate

ساختار تاریخ میلادی
تاریخ میلادی.
نامانگلیسیگونهتوضیح
سالyearصحیح = 1970سال.
ماهmonthصحیح = 1ماه، از ۱.
روزdayصحیح = 1روز ماه، از ۱.
calendar-Convert.salam
واردسازی تقویم

تابع ریشه:
    م := تقویم.تاریخ میلادی { سال = ۲۰۲۴، ماه = ۳، روز = ۲۰ }
    ج := تقویم.میلادی به جلالی(م)
    ه := تقویم.میلادی به هجری(م)
    سرچاپ تقویم.قالب میلادی(م)، تقویم.قالب جلالی(ج)، تقویم.قالب هجری(ه)
    سرچاپ تقویم.قالب طولانی جلالی(ج)
    سرچاپ تقویم.قالب طولانی هجری فارسی(ه)
    سرچاپ تقویم.قالب طولانی هجری عربی(ه)
    سرچاپ تقویم.قالب طولانی میلادی(م)
    سرچاپ تقویم.قالب میلادی(تقویم.جلالی به میلادی(تقویم.تاریخ جلالی { سال = ۱۴۰۳، ماه = ۱، روز = ۱ }))
    سرچاپ تقویم.قالب میلادی(تقویم.هجری به میلادی(تقویم.تاریخ هجری قمری { سال = ۱۴۴۵، ماه = ۹، روز = ۱ }))
    سرچاپ تقویم.قالب هجری(تقویم.جلالی به هجری(ج))، تقویم.قالب جلالی(تقویم.هجری به جلالی(ه))
    ر := تقویم.میلادی به روز ژولیانی(م)
    سرچاپ ر، تقویم.جلالی به روز ژولیانی(ج)، تقویم.هجری به روز ژولیانی(ه)
    سرچاپ تقویم.قالب میلادی(تقویم.روز ژولیانی به میلادی(ر + ۱))، تقویم.قالب جلالی(تقویم.روز ژولیانی به جلالی(ر + ۱))، تقویم.قالب هجری(تقویم.روز ژولیانی به هجری(ر + ۱))
پایان
خروجی2024-03-20 1403-01-01 1445-09-10 1 فروردین 1403 10 رمضان 1445 10 رمضان 1445 March 20, 2024 2024-03-20 2024-03-11 1445-09-10 1403-01-01 2460390 2460390 2460390 2024-03-21 1403-01-02 1445-09-11

تاریخ جلالی JalaliDate

ساختار تاریخ جلالی
تاریخ جلالی (هجری شمسی).
نامانگلیسیگونهتوضیح
سالyearصحیح = 1سال.
ماهmonthصحیح = 1ماه، از ۱ (فروردین).
روزdayصحیح = 1روز ماه، از ۱.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

تاریخ هجری قمری HijriDate

ساختار تاریخ هجری قمری
تاریخ هجری قمری.
نامانگلیسیگونهتوضیح
سالyearصحیح = 1سال.
ماهmonthصحیح = 1ماه، از ۱ (محرم).
روزdayصحیح = 1روز ماه، از ۱.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

زمان ساعت ClockTime

ساختار زمان ساعت
ساعت روز.
نامانگلیسیگونهتوضیح
ساعتhourصحیح = 0ساعت، ۰ تا ۲۳.
دقیقهminuteصحیح = 0دقیقه.
ثانیهsecondصحیح = 0ثانیه.
calendar-Epoch.salam
واردسازی تقویم
واردسازی زمان

تابع ریشه:
    ت := ۱۷۱۰۹۴۳۵۰۹
    منطقه := تقویم.منطقه زمانی محلی(ت)
    م := تقویم.زمان به میلادی(ت)
    سرچاپ تقویم.مقایسه تاریخ میلادی(م، تقویم.تاریخ میلادی محلی(ت، منطقه)) == ۰
    سرچاپ تقویم.مقایسه تاریخ جلالی(تقویم.زمان به جلالی(ت)، تقویم.تاریخ جلالی محلی(ت، منطقه)) == ۰
    سرچاپ تقویم.مقایسه تاریخ هجری(تقویم.زمان به هجری(ت)، تقویم.تاریخ هجری محلی(ت، منطقه)) == ۰
    سرچاپ تقویم.قالب ساعت(تقویم.زمان به ساعت(ت)) == تقویم.قالب ساعت(تقویم.ساعت محلی(ت، منطقه))
    ج := تقویم.تاریخ جلالی { سال = ۱۴۰۳، ماه = ۱، روز = ۱ }
    سرچاپ تقویم.جلالی به زمان یونیکس(ج، ۱۴، ۵، ۹) == ت
    سرچاپ تقویم.میلادی به زمان یونیکس(تقویم.تاریخ میلادی { سال = ۲۰۲۴، ماه = ۳، روز = ۲۰ }، ۱۴، ۵، ۹)
    سرچاپ تقویم.هجری به زمان یونیکس(تقویم.تاریخ هجری قمری { سال = ۱۴۴۵، ماه = ۹، روز = ۱۰ }، ۰، ۰، ۰)
    سرچاپ تقویم.مقایسه تاریخ میلادی(تقویم.امروز میلادی()، تقویم.زمان به میلادی(زمان.اکنون())) >= ۰، تقویم.امروز میلادی().سال >= ۲۰۲۴، تقویم.امروز جلالی().سال >= ۱۴۰۳، تقویم.امروز هجری().سال >= ۱۴۴۵
    س := تقویم.ساعت اکنون()
    سرچاپ س.ساعت < ۲۴، س.دقیقه < ۶۰، س.ثانیه < ۶۱
پایان
خروجیtrue true true true true 1710943509 1710892800 true true true true true true true

منطقه Zone

ساختار منطقه
منطقه‌ی زمانی کامل از پایگاه داده‌ی منطقه‌ها (tzdata)، با تاریخچه‌ی اختلاف‌ها و ساعت تابستانی.
نامانگلیسیگونهتوضیح
نامnameرشته = "UTC"نام منطقه.
بارگذاری شدokمنطقی = نادرستآیا منطقه بارگذاری شد.
اختلاف نوع‌هاtype_offsetوکتور<صحیح>اختلاف هر گونه‌ی زمان بر حسب ثانیه.
تابستانی نوع‌هاtype_isdstوکتور<منطقی>آیا هر گونه ساعت تابستانی است.
نماد نوع‌هاtype_abbrevوکتور<رشته>نماد هر گونه، مثل EST.
لحظه‌های تغییرtimesوکتور<صحیح۶۴>لحظه‌های تغییر اختلاف.
نوع پس از تغییرtype_atوکتور<صحیح>گونه‌ی زمان پس از هر تغییر.
نوع پایهbase_typeصحیح = 0گونه‌ی پیش از نخستین تغییر.
قاعدهrulePosixTZقاعده‌ی POSIX برای سال‌های پس از آخرین تغییر ثبت‌شده.
calendar-Zone.salam
واردسازی تقویم

تابع ریشه:
    ناپایا ز := تقویم.بارگذاری منطقه("America/New_York")
    سرچاپ ز.نام، ز.بارگذاری شد
    زمستان := ۱۷۰۴۰۶۷۲۰۰
    تابستان := ۱۷۱۹۷۹۲۰۰۰
    سرچاپ تقویم.اختلاف دقیقه منطقه(ز، زمستان)، تقویم.اختلاف دقیقه منطقه(ز، تابستان)، تقویم.اختلاف ثانیه منطقه(ز، تابستان)
    سرچاپ تقویم.ساعت تابستانی منطقه(ز، زمستان)، تقویم.ساعت تابستانی منطقه(ز، تابستان)
    سرچاپ تقویم.نماد منطقه(ز، زمستان)، تقویم.نماد منطقه(ز، تابستان)
    م := تقویم.منطقه زمانی در(ز، تابستان)
    سرچاپ م.نام، م.اختلاف دقیقه‌ای
    سرچاپ تقویم.منطقه در("Asia/Tehran"، زمستان).اختلاف دقیقه‌ای
    ر := تقویم.محلی به زمان مطلق(تقویم.تاریخ میلادی { سال = ۲۰۲۴، ماه = ۶، روز = ۳۰ }، تقویم.زمان ساعت { ساعت = ۲۰ }، ز)
    سرچاپ ر == تابستان
    تقویم.آزادسازی منطقه(ز)
    سرچاپ تقویم.بارگذاری منطقه("Mars/Olympus").بارگذاری شد
    ناپایا ل := تقویم.منطقه محلی()
    سرچاپ ل.بارگذاری شد یا وارونه ل.بارگذاری شد
    تقویم.آزادسازی منطقه(ل)
پایان
خروجیAmerica/New_York true -300 -240 -14400 false true EST EDT EDT -240 210 true false true

تابع‌ها

منطقه زمانی ثابت FixedOffsetZone

تابع منطقه زمانی ثابت(name: رشته، offsetMinutes: صحیح): منطقه زمانی
منطقه‌ای با نام و اختلاف دلخواه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

منطقه زمانی جهانی TZUTC

تابع منطقه زمانی جهانی(): منطقه زمانی
وقت جهانی (اختلاف صفر).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

منطقه زمانی تهران TZTehran

تابع منطقه زمانی تهران(): منطقه زمانی
منطقه‌ی تهران، با اختلاف ثابت ۲۱۰ دقیقه (۳:۳۰).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

منطقه زمانی کابل TZKabul

تابع منطقه زمانی کابل(): منطقه زمانی
منطقه‌ی کابل، با اختلاف ثابت ۲۷۰ دقیقه (۴:۳۰).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

منطقه زمانی ریاض TZRiyadh

تابع منطقه زمانی ریاض(): منطقه زمانی
منطقه‌ی ریاض، با اختلاف ثابت ۱۸۰ دقیقه (۳:۰۰).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

منطقه زمانی مکه TZMecca

تابع منطقه زمانی مکه(): منطقه زمانی
منطقه‌ی مکه، همان منطقه‌ی ریاض، با اختلاف ثابت ۱۸۰ دقیقه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

منطقه زمانی دبی TZDubai

تابع منطقه زمانی دبی(): منطقه زمانی
منطقه‌ی دبی، با اختلاف ثابت ۲۴۰ دقیقه (۴:۰۰).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

منطقه زمانی استانبول TZIstanbul

تابع منطقه زمانی استانبول(): منطقه زمانی
منطقه‌ی استانبول، با اختلاف ثابت ۱۸۰ دقیقه (۳:۰۰).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

منطقه زمانی لندن TZLondon

تابع منطقه زمانی لندن(): منطقه زمانی
منطقه‌ی لندن با اختلاف ثابت صفر. ساعت تابستانی را حساب نمی‌کند؛ برای آن بارگذاری منطقه را به کار ببرید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

منطقه زمانی نیویورک TZNewYork

تابع منطقه زمانی نیویورک(): منطقه زمانی
منطقه‌ی نیویورک با اختلاف ثابت ‎-300 دقیقه. ساعت تابستانی را حساب نمی‌کند؛ برای آن بارگذاری منطقه را به کار ببرید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

منطقه زمانی توکیو TZTokyo

تابع منطقه زمانی توکیو(): منطقه زمانی
منطقه‌ی توکیو، با اختلاف ثابت ۵۴۰ دقیقه (۹:۰۰).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

اختلاف زمانی محلی LocalOffsetMinutes

تابع اختلاف زمانی محلی(epoch: صحیح۶۴): صحیح
اختلاف وقت محلی رایانه با وقت جهانی در آن لحظه، بر حسب دقیقه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

منطقه زمانی محلی TZLocal

تابع منطقه زمانی محلی(epoch: صحیح۶۴): منطقه زمانی
منطقه‌ای به نام Local با اختلاف وقت محلی در آن لحظه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

تاریخ میلادی محلی WallClockGregorian

تابع تاریخ میلادی محلی(epoch: صحیح۶۴، tz: منطقه زمانی): تاریخ میلادی
تاریخ میلادی آن لحظه در منطقه‌ی داده‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

تاریخ جلالی محلی WallClockJalali

تابع تاریخ جلالی محلی(epoch: صحیح۶۴، tz: منطقه زمانی): تاریخ جلالی
تاریخ جلالی آن لحظه در منطقه‌ی داده‌شده؛ مثلاً تاریخ امروزِ تهران، هر جای دنیا که برنامه اجرا شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

تاریخ هجری محلی WallClockHijri

تابع تاریخ هجری محلی(epoch: صحیح۶۴، tz: منطقه زمانی): تاریخ هجری قمری
تاریخ هجری قمری آن لحظه در منطقه‌ی داده‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

ساعت محلی WallClockTime

تابع ساعت محلی(epoch: صحیح۶۴، tz: منطقه زمانی): زمان ساعت
ساعت آن لحظه در منطقه‌ی داده‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

میلادی محلی به زمان مطلق ZonedGregorianToEpoch

تابع میلادی محلی به زمان مطلق(d: تاریخ میلادی، t: زمان ساعت، tz: منطقه زمانی): صحیح۶۴
تاریخ و ساعتِ یک منطقه را به لحظه (ثانیه از مبدأ یونیکس) تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

تبدیل میلادی بین مناطق زمانی ConvertZonedGregorian

تابع تبدیل میلادی بین مناطق زمانی(d: تاریخ میلادی، t: زمان ساعت، from: منطقه زمانی، toTz: منطقه زمانی): تاریخ میلادی
تاریخ و ساعتِ یک منطقه را به منطقه‌ی دیگر می‌برد و تاریخ آنجا را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

تبدیل ساعت بین مناطق زمانی ConvertZonedTime

تابع تبدیل ساعت بین مناطق زمانی(d: تاریخ میلادی، t: زمان ساعت، from: منطقه زمانی، toTz: منطقه زمانی): زمان ساعت
مثل تابع بالا، ولی ساعت منطقه‌ی مقصد را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-TimeZone.salam

میلادی به جلالی GregorianToJalali

تابع میلادی به جلالی(d: تاریخ میلادی): تاریخ جلالی
تاریخ میلادی را به جلالی (هجری شمسی) تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

جلالی به میلادی JalaliToGregorian

تابع جلالی به میلادی(d: تاریخ جلالی): تاریخ میلادی
تاریخ جلالی را به میلادی تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

میلادی به هجری GregorianToHijri

تابع میلادی به هجری(d: تاریخ میلادی): تاریخ هجری قمری
تاریخ میلادی را به هجری قمری تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

هجری به میلادی HijriToGregorian

تابع هجری به میلادی(d: تاریخ هجری قمری): تاریخ میلادی
تاریخ هجری قمری را به میلادی تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

جلالی به هجری JalaliToHijri

تابع جلالی به هجری(d: تاریخ جلالی): تاریخ هجری قمری
تاریخ جلالی را به هجری قمری تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

هجری به جلالی HijriToJalali

تابع هجری به جلالی(d: تاریخ هجری قمری): تاریخ جلالی
تاریخ هجری قمری را به جلالی تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

زمان به میلادی EpochToGregorian

تابع زمان به میلادی(epoch: صحیح۶۴): تاریخ میلادی
تاریخ میلادی آن لحظه به وقت محلی رایانه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Epoch.salam

زمان به جلالی EpochToJalali

تابع زمان به جلالی(epoch: صحیح۶۴): تاریخ جلالی
تاریخ جلالی آن لحظه به وقت محلی رایانه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Epoch.salam

زمان به هجری EpochToHijri

تابع زمان به هجری(epoch: صحیح۶۴): تاریخ هجری قمری
تاریخ هجری قمری آن لحظه به وقت محلی رایانه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Epoch.salam

زمان به ساعت EpochToClockTime

تابع زمان به ساعت(epoch: صحیح۶۴): زمان ساعت
ساعت آن لحظه به وقت محلی رایانه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Epoch.salam

امروز میلادی TodayGregorian

تابع امروز میلادی(): تاریخ میلادی
تاریخ میلادی امروز به وقت محلی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Epoch.salam

امروز جلالی TodayJalali

تابع امروز جلالی(): تاریخ جلالی
تاریخ جلالی امروز به وقت محلی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Epoch.salam

امروز هجری TodayHijri

تابع امروز هجری(): تاریخ هجری قمری
تاریخ هجری قمری امروز به وقت محلی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Epoch.salam

ساعت اکنون NowClockTime

تابع ساعت اکنون(): زمان ساعت
ساعت فعلی به وقت محلی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Epoch.salam

میلادی به زمان یونیکس GregorianToUnixUTC

تابع میلادی به زمان یونیکس(d: تاریخ میلادی، hour: صحیح، minute: صحیح، second: صحیح): صحیح۶۴
تاریخ میلادی و ساعتِ وقت جهانی را به ثانیه از مبدأ یونیکس تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Epoch.salam

جلالی به زمان یونیکس JalaliToUnixUTC

تابع جلالی به زمان یونیکس(d: تاریخ جلالی، hour: صحیح، minute: صحیح، second: صحیح): صحیح۶۴
تاریخ جلالی و ساعتِ وقت جهانی را به ثانیه از مبدأ یونیکس تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Epoch.salam

هجری به زمان یونیکس HijriToUnixUTC

تابع هجری به زمان یونیکس(d: تاریخ هجری قمری، hour: صحیح، minute: صحیح، second: صحیح): صحیح۶۴
تاریخ هجری قمری و ساعتِ وقت جهانی را به ثانیه از مبدأ یونیکس تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Epoch.salam

قالب میلادی FormatGregorian

تابع قالب میلادی(d: تاریخ میلادی): رشته
تاریخ میلادی به شکل 2024-03-20.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

قالب جلالی FormatJalali

تابع قالب جلالی(d: تاریخ جلالی): رشته
تاریخ جلالی به شکل 1403-01-01.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

قالب هجری FormatHijri

تابع قالب هجری(d: تاریخ هجری قمری): رشته
تاریخ هجری قمری به شکل 1445-09-10.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

قالب ساعت FormatClockTime

تابع قالب ساعت(t: زمان ساعت): رشته
ساعت به شکل 14:05:09.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Epoch.salam

قالب طولانی جلالی FormatJalaliLongFa

تابع قالب طولانی جلالی(d: تاریخ جلالی): رشته
تاریخ جلالی با نام ماه، مثل 1 فروردین 1403.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

قالب طولانی هجری عربی FormatHijriLongAr

تابع قالب طولانی هجری عربی(d: تاریخ هجری قمری): رشته
تاریخ هجری با نام عربی ماه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

قالب طولانی هجری فارسی FormatHijriLongFa

تابع قالب طولانی هجری فارسی(d: تاریخ هجری قمری): رشته
تاریخ هجری با نام فارسی ماه، مثل 10 رمضان 1445.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

قالب طولانی میلادی FormatGregorianLongEn

تابع قالب طولانی میلادی(d: تاریخ میلادی): رشته
تاریخ میلادی به انگلیسی، مثل March 20, 2024.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

جلالی به روز ژولیانی JalaliToJDN

تابع جلالی به روز ژولیانی(d: تاریخ جلالی): صحیح۶۴
شماره‌ی روز ژولیانی تاریخ جلالی. روز ژولیانی شمارش پیوسته‌ی روزهاست و پایه‌ی همه‌ی تبدیل‌های این بسته.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

روز ژولیانی به جلالی JDNToJalali

تابع روز ژولیانی به جلالی(jdn: صحیح۶۴): تاریخ جلالی
تاریخ جلالی یک روز ژولیانی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

سال کبیسه جلالی IsLeapJalali

تابع سال کبیسه جلالی(year: صحیح): منطقی
اگر سال جلالی کبیسه باشد (اسفندش ۳۰ روز)، درست برمی‌گرداند.
calendar-Jalali.salam
واردسازی تقویم

تابع ریشه:
    سرچاپ تقویم.سال کبیسه جلالی(۱۴۰۳)، تقویم.سال کبیسه جلالی(۱۴۰۴)، تقویم.روزهای سال جلالی(۱۴۰۳)
    سرچاپ تقویم.روزهای ماه جلالی(۱۴۰۳، ۱)، تقویم.روزهای ماه جلالی(۱۴۰۳، ۷)، تقویم.روزهای ماه جلالی(۱۴۰۳، ۱۲)، تقویم.روزهای ماه جلالی(۱۴۰۴، ۱۲)
    سرچاپ تقویم.تاریخ جلالی معتبر است(۱۴۰۴، ۱۲، ۳۰)، تقویم.تاریخ جلالی معتبر است(۱۴۰۳، ۱۲، ۳۰)
    سرچاپ تقویم.نام ماه جلالی(۱)، تقویم.نام ماه جلالی به انگلیسی(۱)، تقویم.نام ماه جلالی(۱۲)
    ج := تقویم.تاریخ جلالی { سال = ۱۴۰۳، ماه = ۶، روز = ۳۱ }
    ر := تقویم.جلالی به روز ژولیانی(ج)
    سرچاپ تقویم.شماره روز هفته جلالی(ر)، تقویم.نام روز هفته جلالی(تقویم.شماره روز هفته جلالی(ر))
    سرچاپ تقویم.روز هفته جلالی(ج)، تقویم.نام روز هفته فارسی(تقویم.روز هفته جلالی(ج))
    سرچاپ تقویم.قالب جلالی(تقویم.افزودن روز جلالی(ج، ۱))، تقویم.قالب جلالی(تقویم.افزودن هفته جلالی(ج، ۲))
    سرچاپ تقویم.قالب جلالی(تقویم.افزودن ماه جلالی(ج، ۱))، تقویم.قالب جلالی(تقویم.افزودن سال جلالی(ج، -۱))
    سرچاپ تقویم.قالب جلالی(تقویم.آغاز ماه جلالی(ج))، تقویم.قالب جلالی(تقویم.پایان ماه جلالی(تقویم.افزودن ماه جلالی(ج، ۶)))
    نوروز := تقویم.تاریخ جلالی { سال = ۱۴۰۴، ماه = ۱، روز = ۱ }
    سرچاپ تقویم.روزهای بین جلالی(ج، نوروز)، تقویم.مقایسه تاریخ جلالی(ج، نوروز)، تقویم.مقایسه تاریخ جلالی(نوروز، نوروز)
پایان
خروجیtrue false 366 31 30 30 29 false true فروردین Farvardin اسفند 0 شنبه 6 شنبه 1403-07-01 1403-07-14 1403-07-30 1402-06-31 1403-06-01 1403-12-30 181 -1 0

روزهای ماه جلالی DaysInJalaliMonth

تابع روزهای ماه جلالی(year: صحیح، month: صحیح): صحیح
تعداد روزهای ماه جلالی: شش ماه اول ۳۱، پنج ماه بعد ۳۰ و اسفند ۲۹ یا ۳۰.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

تاریخ جلالی معتبر است IsValidJalaliDate

تابع تاریخ جلالی معتبر است(year: صحیح، month: صحیح، day: صحیح): منطقی
اگر تاریخ جلالی وجود داشته باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

نام ماه جلالی JalaliMonthNameFa

تابع نام ماه جلالی(month: صحیح): رشته
نام فارسی ماه جلالی، از ۱ (فروردین) تا ۱۲ (اسفند).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

نام ماه جلالی به انگلیسی JalaliMonthNameEn

تابع نام ماه جلالی به انگلیسی(month: صحیح): رشته
نام لاتین ماه جلالی، مثل Farvardin.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

شماره روز هفته جلالی JalaliWeekday

تابع شماره روز هفته جلالی(jdn: صحیح۶۴): صحیح
روز هفته از روی روز ژولیانی، با شمارش ایرانی: صفر شنبه تا ۶ جمعه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

نام روز هفته جلالی JalaliWeekdayNameFa

تابع نام روز هفته جلالی(weekday: صحیح): رشته
نام روز هفته برای شماره‌ی شماره روز هفته جلالی؛ صفر شنبه است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

مقایسه تاریخ جلالی CompareJalali

تابع مقایسه تاریخ جلالی(a: تاریخ جلالی، b: تاریخ جلالی): صحیح
مقایسه‌ی دو تاریخ جلالی: ‎-1 اگر اولی زودتر باشد، صفر اگر برابر، ۱ اگر دیرتر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

میلادی به روز ژولیانی GregorianToJDN

تابع میلادی به روز ژولیانی(d: تاریخ میلادی): صحیح۶۴
شماره‌ی روز ژولیانی تاریخ میلادی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

روز ژولیانی به میلادی JDNToGregorian

تابع روز ژولیانی به میلادی(jdn: صحیح۶۴): تاریخ میلادی
تاریخ میلادی یک روز ژولیانی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

سال کبیسه میلادی IsLeapGregorian

تابع سال کبیسه میلادی(year: صحیح): منطقی
اگر سال میلادی کبیسه باشد، درست برمی‌گرداند.
calendar-Gregorian.salam
واردسازی تقویم

تابع ریشه:
    سرچاپ تقویم.سال کبیسه میلادی(۲۰۲۴)، تقویم.سال کبیسه میلادی(۱۹۰۰)، تقویم.روزهای سال میلادی(۲۰۲۴)
    سرچاپ تقویم.روزهای ماه میلادی(۲۰۲۴، ۲)، تقویم.روزهای ماه میلادی(۲۰۲۳، ۲)، تقویم.تاریخ میلادی معتبر است(۲۰۲۳، ۲، ۲۹)
    م := تقویم.تاریخ میلادی { سال = ۲۰۲۴، ماه = ۱، روز = ۳۱ }
    ر := تقویم.روز هفته میلادی(م)
    سرچاپ ر، تقویم.نام روز هفته انگلیسی(ر)، تقویم.نام روز هفته فارسی(ر)، تقویم.نام روز هفته عربی(ر)
    سرچاپ تقویم.روز هفته(تقویم.میلادی به روز ژولیانی(م))، تقویم.نام ماه میلادی(۱)
    سرچاپ تقویم.قالب میلادی(تقویم.افزودن ماه میلادی(م، ۱))، تقویم.قالب میلادی(تقویم.افزودن سال میلادی(تقویم.تاریخ میلادی { سال = ۲۰۲۴، ماه = ۲، روز = ۲۹ }، ۱))
    سرچاپ تقویم.قالب میلادی(تقویم.افزودن روز میلادی(م، ۳۰))، تقویم.قالب میلادی(تقویم.افزودن هفته میلادی(م، -۱))
    سرچاپ تقویم.قالب میلادی(تقویم.آغاز ماه میلادی(م))، تقویم.قالب میلادی(تقویم.پایان ماه میلادی(تقویم.افزودن ماه میلادی(م، ۱)))
    سرچاپ تقویم.قالب میلادی(تقویم.روز هفته بعدی(م، ۵))
    آخر سال := تقویم.تاریخ میلادی { سال = ۲۰۲۴، ماه = ۱۲، روز = ۳۱ }
    سرچاپ تقویم.روزهای بین میلادی(م، آخر سال)، تقویم.مقایسه تاریخ میلادی(آخر سال، م)
پایان
خروجیtrue false 366 29 28 false 3 Wednesday چهارشنبه الأربعاء 3 January 2024-02-29 2025-02-28 2024-03-01 2024-01-24 2024-01-01 2024-02-29 2024-02-02 335 1

روزهای ماه میلادی DaysInGregorianMonth

تابع روزهای ماه میلادی(year: صحیح، month: صحیح): صحیح
تعداد روزهای ماه میلادی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

تاریخ میلادی معتبر است IsValidGregorianDate

تابع تاریخ میلادی معتبر است(year: صحیح، month: صحیح، day: صحیح): منطقی
اگر تاریخ میلادی وجود داشته باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

روز هفته Weekday

تابع روز هفته(jdn: صحیح۶۴): صحیح
روز هفته از روی روز ژولیانی: صفر یکشنبه تا ۶ شنبه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

نام روز هفته انگلیسی WeekdayNameEn

تابع نام روز هفته انگلیسی(weekday: صحیح): رشته
نام انگلیسی روز هفته برای شماره‌ی روز هفته.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

نام روز هفته فارسی WeekdayNameFa

تابع نام روز هفته فارسی(weekday: صحیح): رشته
نام فارسی روز هفته برای شماره‌ی روز هفته؛ صفر یکشنبه است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

نام روز هفته عربی WeekdayNameAr

تابع نام روز هفته عربی(weekday: صحیح): رشته
نام عربی روز هفته برای شماره‌ی روز هفته.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

نام ماه میلادی GregorianMonthNameEn

تابع نام ماه میلادی(month: صحیح): رشته
نام انگلیسی ماه میلادی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

مقایسه تاریخ میلادی CompareGregorian

تابع مقایسه تاریخ میلادی(a: تاریخ میلادی، b: تاریخ میلادی): صحیح
مقایسه‌ی دو تاریخ میلادی: ‎-1، صفر یا ۱.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

افزودن روز میلادی AddDaysGregorian

تابع افزودن روز میلادی(d: تاریخ میلادی، n: صحیح): تاریخ میلادی
n روز به تاریخ میلادی اضافه می‌کند؛ n منفی به عقب می‌رود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

افزودن هفته میلادی AddWeeksGregorian

تابع افزودن هفته میلادی(d: تاریخ میلادی، n: صحیح): تاریخ میلادی
n هفته به تاریخ میلادی اضافه می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

افزودن ماه میلادی AddMonthsGregorian

تابع افزودن ماه میلادی(d: تاریخ میلادی، n: صحیح): تاریخ میلادی
n ماه به تاریخ میلادی اضافه می‌کند؛ اگر روز در ماه مقصد نباشد، آخرین روز آن ماه گرفته می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

افزودن سال میلادی AddYearsGregorian

تابع افزودن سال میلادی(d: تاریخ میلادی، n: صحیح): تاریخ میلادی
n سال به تاریخ میلادی اضافه می‌کند؛ روز کبیسه‌ای که در سال مقصد نباشد، به آخر ماه می‌رود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

روزهای بین میلادی DaysBetweenGregorian

تابع روزهای بین میلادی(from: تاریخ میلادی، toDate: تاریخ میلادی): صحیح۶۴
تعداد روزها از from تا toDate؛ اگر دومی زودتر باشد، منفی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

آغاز ماه میلادی StartOfMonthGregorian

تابع آغاز ماه میلادی(d: تاریخ میلادی): تاریخ میلادی
روز اول ماهِ تاریخ میلادی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

پایان ماه میلادی EndOfMonthGregorian

تابع پایان ماه میلادی(d: تاریخ میلادی): تاریخ میلادی
روز آخر ماهِ تاریخ میلادی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

روزهای سال میلادی DaysInGregorianYear

تابع روزهای سال میلادی(year: صحیح): صحیح
تعداد روزهای سال میلادی: ۳۶۵ یا ۳۶۶.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

افزودن روز جلالی AddDaysJalali

تابع افزودن روز جلالی(d: تاریخ جلالی، n: صحیح): تاریخ جلالی
n روز به تاریخ جلالی اضافه می‌کند؛ n منفی به عقب می‌رود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

افزودن هفته جلالی AddWeeksJalali

تابع افزودن هفته جلالی(d: تاریخ جلالی، n: صحیح): تاریخ جلالی
n هفته به تاریخ جلالی اضافه می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

افزودن ماه جلالی AddMonthsJalali

تابع افزودن ماه جلالی(d: تاریخ جلالی، n: صحیح): تاریخ جلالی
n ماه به تاریخ جلالی اضافه می‌کند؛ اگر روز در ماه مقصد نباشد، آخرین روز آن ماه گرفته می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

افزودن سال جلالی AddYearsJalali

تابع افزودن سال جلالی(d: تاریخ جلالی، n: صحیح): تاریخ جلالی
n سال به تاریخ جلالی اضافه می‌کند؛ روز کبیسه‌ای که در سال مقصد نباشد، به آخر ماه می‌رود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

روزهای بین جلالی DaysBetweenJalali

تابع روزهای بین جلالی(from: تاریخ جلالی، toDate: تاریخ جلالی): صحیح۶۴
تعداد روزها از from تا toDate؛ اگر دومی زودتر باشد، منفی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

آغاز ماه جلالی StartOfMonthJalali

تابع آغاز ماه جلالی(d: تاریخ جلالی): تاریخ جلالی
روز اول ماهِ تاریخ جلالی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

پایان ماه جلالی EndOfMonthJalali

تابع پایان ماه جلالی(d: تاریخ جلالی): تاریخ جلالی
روز آخر ماهِ تاریخ جلالی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

روزهای سال جلالی DaysInJalaliYear

تابع روزهای سال جلالی(year: صحیح): صحیح
تعداد روزهای سال جلالی: ۳۶۵ یا ۳۶۶.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

افزودن روز هجری AddDaysHijri

تابع افزودن روز هجری(d: تاریخ هجری قمری، n: صحیح): تاریخ هجری قمری
n روز به تاریخ هجری اضافه می‌کند؛ n منفی به عقب می‌رود.
calendar-Hijri.salam
واردسازی تقویم

تابع ریشه:
    ه := تقویم.تاریخ هجری قمری { سال = ۱۴۴۵، ماه = ۹، روز = ۲۹ }
    سرچاپ تقویم.سال کبیسه هجری(۱۴۴۵)، تقویم.سال کبیسه هجری(۱۴۴۶)
    سرچاپ تقویم.روزهای ماه هجری(۱۴۴۵، ۹)، تقویم.روزهای ماه هجری(۱۴۴۵، ۱۲)، تقویم.روزهای ماه هجری(۱۴۴۶، ۱۲)
    سرچاپ تقویم.تاریخ هجری معتبر است(۱۴۴۵، ۹، ۳۰)، تقویم.تاریخ هجری معتبر است(۱۴۴۵، ۱۰، ۳۰)
    سرچاپ تقویم.نام ماه هجری قمری(۹)، تقویم.نام ماه هجری به عربی(۹)، تقویم.نام ماه هجری به انگلیسی(۹)
    سرچاپ تقویم.قالب هجری(تقویم.افزودن روز هجری(ه، ۱))، تقویم.قالب هجری(تقویم.افزودن هفته هجری(ه، ۱))
    سرچاپ تقویم.قالب هجری(تقویم.افزودن ماه هجری(ه، ۳))، تقویم.قالب هجری(تقویم.افزودن سال هجری(ه، ۱))
    سرچاپ تقویم.قالب هجری(تقویم.آغاز ماه هجری(ه))، تقویم.قالب هجری(تقویم.پایان ماه هجری(ه))
    محرم := تقویم.تاریخ هجری قمری { سال = ۱۴۴۶، ماه = ۱، روز = ۱ }
    سرچاپ تقویم.روزهای بین هجری(ه، محرم)، تقویم.مقایسه تاریخ هجری(ه، محرم)
    سرچاپ تقویم.نام روز هفته فارسی(تقویم.روز هفته هجری(ه))
پایان
خروجیtrue false 30 30 29 true false رمضان رمضان Ramadan 1445-09-30 1445-10-06 1445-12-29 1446-09-29 1445-09-01 1445-09-30 91 -1 دوشنبه

افزودن هفته هجری AddWeeksHijri

تابع افزودن هفته هجری(d: تاریخ هجری قمری، n: صحیح): تاریخ هجری قمری
n هفته به تاریخ هجری اضافه می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

افزودن ماه هجری AddMonthsHijri

تابع افزودن ماه هجری(d: تاریخ هجری قمری، n: صحیح): تاریخ هجری قمری
n ماه به تاریخ هجری اضافه می‌کند؛ اگر روز در ماه مقصد نباشد، آخرین روز آن ماه گرفته می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

افزودن سال هجری AddYearsHijri

تابع افزودن سال هجری(d: تاریخ هجری قمری، n: صحیح): تاریخ هجری قمری
n سال به تاریخ هجری اضافه می‌کند؛ روز کبیسه‌ای که در سال مقصد نباشد، به آخر ماه می‌رود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

روزهای بین هجری DaysBetweenHijri

تابع روزهای بین هجری(from: تاریخ هجری قمری، toDate: تاریخ هجری قمری): صحیح۶۴
تعداد روزها از from تا toDate؛ اگر دومی زودتر باشد، منفی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

آغاز ماه هجری StartOfMonthHijri

تابع آغاز ماه هجری(d: تاریخ هجری قمری): تاریخ هجری قمری
روز اول ماهِ تاریخ هجری.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

پایان ماه هجری EndOfMonthHijri

تابع پایان ماه هجری(d: تاریخ هجری قمری): تاریخ هجری قمری
روز آخر ماهِ تاریخ هجری.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

روز هفته میلادی WeekdayGregorian

تابع روز هفته میلادی(d: تاریخ میلادی): صحیح
روز هفته‌ی تاریخ میلادی، با شمارش روز هفته (صفر یکشنبه).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

روز هفته جلالی WeekdayJalali

تابع روز هفته جلالی(d: تاریخ جلالی): صحیح
روز هفته‌ی تاریخ جلالی، با شمارش روز هفته (صفر یکشنبه).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Jalali.salam

روز هفته هجری WeekdayHijri

تابع روز هفته هجری(d: تاریخ هجری قمری): صحیح
روز هفته‌ی تاریخ هجری، با شمارش روز هفته (صفر یکشنبه).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

روز هفته بعدی NextWeekdayOnOrAfter

تابع روز هفته بعدی(d: تاریخ میلادی، weekday: صحیح): تاریخ میلادی
نخستین روزِ از این تاریخ به بعد (خودش هم حساب است) که روز هفته‌اش weekday باشد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Gregorian.salam

هجری به روز ژولیانی HijriToJDN

تابع هجری به روز ژولیانی(d: تاریخ هجری قمری): صحیح۶۴
شماره‌ی روز ژولیانی تاریخ هجری.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

روز ژولیانی به هجری JDNToHijri

تابع روز ژولیانی به هجری(jdn: صحیح۶۴): تاریخ هجری قمری
تاریخ هجری یک روز ژولیانی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Convert.salam

سال کبیسه هجری IsLeapHijri

تابع سال کبیسه هجری(year: صحیح): منطقی
اگر سال هجری قمری کبیسه باشد (ذی‌الحجه‌اش ۳۰ روز)، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

روزهای ماه هجری DaysInHijriMonth

تابع روزهای ماه هجری(year: صحیح، month: صحیح): صحیح
تعداد روزهای ماه هجری: ماه‌های فرد ۳۰ و زوج ۲۹، و ذی‌الحجه در سال کبیسه ۳۰.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

تاریخ هجری معتبر است IsValidHijriDate

تابع تاریخ هجری معتبر است(year: صحیح، month: صحیح، day: صحیح): منطقی
اگر تاریخ هجری وجود داشته باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

نام ماه هجری به عربی HijriMonthNameAr

تابع نام ماه هجری به عربی(month: صحیح): رشته
نام عربی ماه هجری.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

نام ماه هجری قمری HijriMonthNameFa

تابع نام ماه هجری قمری(month: صحیح): رشته
نام فارسی ماه هجری، مثل رمضان.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

نام ماه هجری به انگلیسی HijriMonthNameEn

تابع نام ماه هجری به انگلیسی(month: صحیح): رشته
نام لاتین ماه هجری، مثل Ramadan.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

مقایسه تاریخ هجری CompareHijri

تابع مقایسه تاریخ هجری(a: تاریخ هجری قمری، b: تاریخ هجری قمری): صحیح
مقایسه‌ی دو تاریخ هجری: ‎-1، صفر یا ۱.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Hijri.salam

بارگذاری منطقه LoadZone

تابع بارگذاری منطقه(name: رشته): منطقه
منطقه را با نامش، مثل America/New_York، از پرونده‌های tzdata سیستم می‌خواند. در ویندوز معمولاً این پرونده‌ها نیستند و ok نادرست می‌ماند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Zone.salam

منطقه محلی LocalZone

تابع منطقه محلی(): منطقه
منطقه‌ی محلی رایانه را از متغیر TZ یا /etc/localtime می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Zone.salam

آزادسازی منطقه FreeZone

تابع آزادسازی منطقه(z &: منطقه)
حافظه‌ی منطقه را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Zone.salam

اختلاف ثانیه منطقه ZoneOffsetSeconds

تابع اختلاف ثانیه منطقه(z: منطقه، epoch: صحیح۶۴): صحیح
اختلاف منطقه با وقت جهانی در آن لحظه، بر حسب ثانیه. اگر منطقه بارگذاری نشده باشد، صفر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Zone.salam

اختلاف دقیقه منطقه ZoneOffsetMinutes

تابع اختلاف دقیقه منطقه(z: منطقه، epoch: صحیح۶۴): صحیح
اختلاف منطقه در آن لحظه، بر حسب دقیقه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Zone.salam

ساعت تابستانی منطقه ZoneIsDST

تابع ساعت تابستانی منطقه(z: منطقه، epoch: صحیح۶۴): منطقی
اگر آن لحظه در منطقه ساعت تابستانی باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Zone.salam

نماد منطقه ZoneAbbrevAt

تابع نماد منطقه(z: منطقه، epoch: صحیح۶۴): رشته
نماد منطقه در آن لحظه، مثل EST یا EDT.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Zone.salam

منطقه زمانی در TimeZoneAt

تابع منطقه زمانی در(z: منطقه، epoch: صحیح۶۴): منطقه زمانی
اختلاف منطقه در آن لحظه را به صورت یک منطقه زمانی ثابت برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Zone.salam

منطقه در ZoneAt

تابع منطقه در(name: رشته، epoch: صحیح۶۴): منطقه زمانی
منطقه را با نامش بارگذاری می‌کند و منطقه زمانی آن لحظه را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Zone.salam

محلی به زمان مطلق ZonedToEpoch

تابع محلی به زمان مطلق(d: تاریخ میلادی، t: زمان ساعت، z: منطقه): صحیح۶۴
تاریخ و ساعتِ محلیِ یک منطقه را، با در نظر گرفتن ساعت تابستانی، به لحظه تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: calendar-Zone.salam