DateTim...e::fa_IR(3)

💖 DateTim...e::fa_IR(3) — Persian Iran (fa-IR) locale, bestie edition 💖

okay bestie, welcome to the DateTim...e::fa_IR(3) page from User Contributed Perl Documentation — aka the Persian Iran (fa-IR) locale data examples. This page is literally a whole reference glow-up for the locale, and we’re doing it section by section, no skips, periodt. 🌈✨

🌸 NAME

DateTime::Locale::fa_IR - Locale data examples for the Persian Iran (fa-IR) locale

🦋 DESCRIPTION

This pod file contains examples of the locale data available for the Persian Iran locale. It’s giving reference manual, but make it fashion. 💖

---

🎀 Days

✨ Wide (format)

دوشنبه
سه‌شنبه
چهارشنبه
پنجشنبه
جمعه
شنبه
یکشنبه

✨ Abbreviated (format)

دوشنبه
سه‌شنبه
چهارشنبه
پنجشنبه
جمعه
شنبه
یکشنبه

✨ Narrow (format)

د
س
چ
پ
ج
ش
ی

✨ Wide (stand-alone)

دوشنبه
سه‌شنبه
چهارشنبه
پنجشنبه
جمعه
شنبه
یکشنبه

✨ Abbreviated (stand-alone)

دوشنبه
سه‌شنبه
چهارشنبه
پنجشنبه
جمعه
شنبه
یکشنبه

✨ Narrow (stand-alone)

د
س
چ
پ
ج
ش
ی

---

🌙 Months

✨ Wide (format)

ژانویهٔ
فوریهٔ
مارس
آوریل
مهٔ
ژوئن
ژوئیهٔ
اوت
سپتامبر
اکتبر
نوامبر
دسامبر

✨ Abbreviated (format)

ژانویه
فوریه
مارس
آوریل
مه
ژوئن
ژوئیه
اوت
سپتامبر
اکتبر
نوامبر
دسامبر

✨ Narrow (format)

ژ
ف
م
آ
م
ژ
ژ
ا
س
ا
ن
د

✨ Wide (stand-alone)

ژانویه
فوریه
مارس
آوریل
مه
ژوئن
ژوئیه
اوت
سپتامبر
اکتبر
نوامبر
دسامبر

✨ Abbreviated (stand-alone)

ژانویه
فوریه
مارس
آوریل
مه
ژوئن
ژوئیه
اوت
سپتامبر
اکتبر
نوامبر
دسامبر

✨ Narrow (stand-alone)

ژ
ف
م
آ
م
ژ
ژ
ا
س
ا
ن
د

---

🧚 Quarters

✨ Wide (format)

سهماههٔ اول
سهماههٔ دوم
سهماههٔ سوم
سهماههٔ چهارم

✨ Abbreviated (format)

سم۱
سم۲
سم۳
سم۴

✨ Narrow (format)

۱
۲
۳
۴

✨ Wide (stand-alone)

سهماههٔ اول
سهماههٔ دوم
سهماههٔ سوم
سهماههٔ چهارم

✨ Abbreviated (stand-alone)

سم۱
سم۲
سم۳
سم۴

✨ Narrow (stand-alone)

۱
۲
۳
۴

---

👑 Eras

✨ Wide (format)

قبل از میلاد
میلادی

✨ Abbreviated (format)

ق.م.
م.

✨ Narrow (format)

ق
م

---

🗓️ Date Formats

✨ Full

2008-02-05T18:30:30 = سه‌شنبه 5 فوریهٔ 2008
1995-12-22T09:05:02 = جمعه 22 دسامبر 1995
-0010-09-15T04:44:23 = شنبه 15 سپتامبر -10

✨ Long

2008-02-05T18:30:30 = 5 فوریهٔ 2008
1995-12-22T09:05:02 = 22 دسامبر 1995
-0010-09-15T04:44:23 = 15 سپتامبر -10

✨ Medium

2008-02-05T18:30:30 = 5 فوریه 2008
1995-12-22T09:05:02 = 22 دسامبر 1995
-0010-09-15T04:44:23 = 15 سپتامبر -10

✨ Short

2008-02-05T18:30:30 = 2008/2/5
1995-12-22T09:05:02 = 1995/12/22
-0010-09-15T04:44:23 = -10/9/15

---

⏰ Time Formats

✨ Full

2008-02-05T18:30:30 = 18:30:30 (UTC)
1995-12-22T09:05:02 = 9:05:02 (UTC)
-0010-09-15T04:44:23 = 4:44:23 (UTC)

✨ Long

2008-02-05T18:30:30 = 18:30:30 (UTC)
1995-12-22T09:05:02 = 9:05:02 (UTC)
-0010-09-15T04:44:23 = 4:44:23 (UTC)

✨ Medium

2008-02-05T18:30:30 = 18:30:30
1995-12-22T09:05:02 = 9:05:02
-0010-09-15T04:44:23 = 4:44:23

✨ Short

2008-02-05T18:30:30 = 18:30
1995-12-22T09:05:02 = 9:05
-0010-09-15T04:44:23 = 4:44

---

🌟 Datetime Formats

✨ Full

2008-02-05T18:30:30 = سه‌شنبه 5 فوریهٔ 2008، ساعت 18:30:30 (UTC)
1995-12-22T09:05:02 = جمعه 22 دسامبر 1995، ساعت 9:05:02 (UTC)
-0010-09-15T04:44:23 = شنبه 15 سپتامبر -10، ساعت 4:44:23 (UTC)

✨ Long

2008-02-05T18:30:30 = 5 فوریهٔ 2008، ساعت 18:30:30 (UTC)
1995-12-22T09:05:02 = 22 دسامبر 1995، ساعت 9:05:02 (UTC)
-0010-09-15T04:44:23 = 15 سپتامبر -10، ساعت 4:44:23 (UTC)

✨ Medium

2008-02-05T18:30:30 = 5 فوریه 2008،‏ 18:30:30
1995-12-22T09:05:02 = 22 دسامبر 1995،‏ 9:05:02
-0010-09-15T04:44:23 = 15 سپتامبر -10،‏ 4:44:23

✨ Short

2008-02-05T18:30:30 = 2008/2/5،‏ 18:30
1995-12-22T09:05:02 = 1995/12/22،‏ 9:05
-0010-09-15T04:44:23 = -10/9/15،‏ 4:44

---

💅 Available Formats

okay this next bit is the big flex: every available format, with its pattern and its three sample timestamps. I’m obsessed. 🔥

✨ Bh (h B)

2008-02-05T18:30:30 = 6 B
1995-12-22T09:05:02 = 9 B
-0010-09-15T04:44:23 = 4 B

✨ Bhm (h:mm B)

2008-02-05T18:30:30 = 6:30 B
1995-12-22T09:05:02 = 9:05 B
-0010-09-15T04:44:23 = 4:44 B

✨ Bhms (h:mm:ss B)

2008-02-05T18:30:30 = 6:30:30 B
1995-12-22T09:05:02 = 9:05:02 B
-0010-09-15T04:44:23 = 4:44:23 B

✨ E (ccc)

2008-02-05T18:30:30 = سه‌شنبه
1995-12-22T09:05:02 = جمعه
-0010-09-15T04:44:23 = شنبه

✨ EBhm (E h:mm B)

2008-02-05T18:30:30 = سه‌شنبه 6:30 B
1995-12-22T09:05:02 = جمعه 9:05 B
-0010-09-15T04:44:23 = شنبه 4:44 B

✨ EBhms (E h:mm:ss B)

2008-02-05T18:30:30 = سه‌شنبه 6:30:30 B
1995-12-22T09:05:02 = جمعه 9:05:02 B
-0010-09-15T04:44:23 = شنبه 4:44:23 B

✨ EHm (E H:mm)

2008-02-05T18:30:30 = سه‌شنبه 18:30
1995-12-22T09:05:02 = جمعه 9:05
-0010-09-15T04:44:23 = شنبه 4:44

✨ EHms (E H:mm:ss)

2008-02-05T18:30:30 = سه‌شنبه 18:30:30
1995-12-22T09:05:02 = جمعه 9:05:02
-0010-09-15T04:44:23 = شنبه 4:44:23

✨ Ed (E d)

2008-02-05T18:30:30 = سه‌شنبه 5
1995-12-22T09:05:02 = جمعه 22
-0010-09-15T04:44:23 = شنبه 15

✨ Ehm (E h:mm a)

2008-02-05T18:30:30 = سه‌شنبه 6:30 ب.ظ.
1995-12-22T09:05:02 = جمعه 9:05 ق.ظ.
-0010-09-15T04:44:23 = شنبه 4:44 ق.ظ.

✨ Ehms (E h:mm:ss a)

2008-02-05T18:30:30 = سه‌شنبه 6:30:30 ب.ظ.
1995-12-22T09:05:02 = جمعه 9:05:02 ق.ظ.
-0010-09-15T04:44:23 = شنبه 4:44:23 ق.ظ.

✨ Gy (y G)

2008-02-05T18:30:30 = 2008 م.
1995-12-22T09:05:02 = 1995 م.
-0010-09-15T04:44:23 = -10 ق.م.

✨ GyMMM (MMM y G)

2008-02-05T18:30:30 = فوریه 2008 م.
1995-12-22T09:05:02 = دسامبر 1995 م.
-0010-09-15T04:44:23 = سپتامبر -10 ق.م.

✨ GyMMMEd (E d MMM y G)

2008-02-05T18:30:30 = سه‌شنبه 5 فوریه 2008 م.
1995-12-22T09:05:02 = جمعه 22 دسامبر 1995 م.
-0010-09-15T04:44:23 = شنبه 15 سپتامبر -10 ق.م.

✨ GyMMMd (d MMM y G)

2008-02-05T18:30:30 = 5 فوریه 2008 م.
1995-12-22T09:05:02 = 22 دسامبر 1995 م.
-0010-09-15T04:44:23 = 15 سپتامبر -10 ق.م.

✨ GyMd (y/M/d GGGGG)

2008-02-05T18:30:30 = 2008/2/5 م
1995-12-22T09:05:02 = 1995/12/22 م
-0010-09-15T04:44:23 = -10/9/15 ق

✨ H (H)

2008-02-05T18:30:30 = 18
1995-12-22T09:05:02 = 9
-0010-09-15T04:44:23 = 4

✨ HHmmZ (HH:mm (Z))

2008-02-05T18:30:30 = 18:30 (+0000)
1995-12-22T09:05:02 = 09:05 (+0000)
-0010-09-15T04:44:23 = 04:44 (+0000)

✨ Hm (H:mm)

2008-02-05T18:30:30 = 18:30
1995-12-22T09:05:02 = 9:05
-0010-09-15T04:44:23 = 4:44

✨ Hms (H:mm:ss)

2008-02-05T18:30:30 = 18:30:30
1995-12-22T09:05:02 = 9:05:02
-0010-09-15T04:44:23 = 4:44:23

✨ Hmsv (H:mm:ss v)

2008-02-05T18:30:30 = 18:30:30 UTC
1995-12-22T09:05:02 = 9:05:02 UTC
-0010-09-15T04:44:23 = 4:44:23 UTC

✨ Hmv (H:mm v)

2008-02-05T18:30:30 = 18:30 UTC
1995-12-22T09:05:02 = 9:05 UTC
-0010-09-15T04:44:23 = 4:44 UTC

✨ M (L)

2008-02-05T18:30:30 = 2
1995-12-22T09:05:02 = 12
-0010-09-15T04:44:23 = 9

✨ MEd (E M/d)

2008-02-05T18:30:30 = سه‌شنبه 2/5
1995-12-22T09:05:02 = جمعه 12/22
-0010-09-15T04:44:23 = شنبه 9/15

✨ MMM (LLL)

2008-02-05T18:30:30 = فوریه
1995-12-22T09:05:02 = دسامبر
-0010-09-15T04:44:23 = سپتامبر

✨ MMMEd (E d LLL)

2008-02-05T18:30:30 = سه‌شنبه 5 فوریه
1995-12-22T09:05:02 = جمعه 22 دسامبر
-0010-09-15T04:44:23 = شنبه 15 سپتامبر

✨ MMMMEd (E d LLLL)

2008-02-05T18:30:30 = سه‌شنبه 5 فوریه
1995-12-22T09:05:02 = جمعه 22 دسامبر
-0010-09-15T04:44:23 = شنبه 15 سپتامبر

✨ MMMMW-count-one (هفتهٔ Wم LLLL)

2008-02-05T18:30:30 = هفتهٔ 1م فوریه
1995-12-22T09:05:02 = هفتهٔ 3م دسامبر
-0010-09-15T04:44:23 = هفتهٔ 2م سپتامبر

✨ MMMMW-count-other (هفتهٔ Wم LLLL)

2008-02-05T18:30:30 = هفتهٔ 1م فوریه
1995-12-22T09:05:02 = هفتهٔ 3م دسامبر
-0010-09-15T04:44:23 = هفتهٔ 2م سپتامبر

✨ MMMMd (d LLLL)

2008-02-05T18:30:30 = 5 فوریه
1995-12-22T09:05:02 = 22 دسامبر
-0010-09-15T04:44:23 = 15 سپتامبر

✨ MMMd (d LLL)

2008-02-05T18:30:30 = 5 فوریه
1995-12-22T09:05:02 = 22 دسامبر
-0010-09-15T04:44:23 = 15 سپتامبر

✨ Md (M/d)

2008-02-05T18:30:30 = 2/5
1995-12-22T09:05:02 = 12/22
-0010-09-15T04:44:23 = 9/15

✨ d (d)

2008-02-05T18:30:30 = 5
1995-12-22T09:05:02 = 22
-0010-09-15T04:44:23 = 15

✨ h (h a)

2008-02-05T18:30:30 = 6 ب.ظ.
1995-12-22T09:05:02 = 9 ق.ظ.
-0010-09-15T04:44:23 = 4 ق.ظ.

✨ hm (h:mm a)

2008-02-05T18:30:30 = 6:30 ب.ظ.
1995-12-22T09:05:02 = 9:05 ق.ظ.
-0010-09-15T04:44:23 = 4:44 ق.ظ.

✨ hms (h:mm:ss a)

2008-02-05T18:30:30 = 6:30:30 ب.ظ.
1995-12-22T09:05:02 = 9:05:02 ق.ظ.
-0010-09-15T04:44:23 = 4:44:23 ق.ظ.

✨ hmsv (h:mm:ss a v)

2008-02-05T18:30:30 = 6:30:30 ب.ظ. UTC
1995-12-22T09:05:02 = 9:05:02 ق.ظ. UTC
-0010-09-15T04:44:23 = 4:44:23 ق.ظ. UTC

✨ hmv (h:mm a v)

okay so picking up exactly where we left off — the tail end of the clock-time patterns, no heading needed, we're already in it 💅

2008-02-05T18:30:30 = 6:30 ب.ظ. UTC
1995-12-22T09:05:02 = 9:05 ق.ظ. UTC
-0010-09-15T04:44:23 = 4:44 ق.ظ. UTC

---

mmss (mm:ss)

literally just minutes and seconds, no notes 🎀

2008-02-05T18:30:30 = 30:30
1995-12-22T09:05:02 = 05:02
-0010-09-15T04:44:23 = 44:23

ms (m:ss)

same vibes as mmss but the minutes don't get a leading zero — main character energy for the single digits ✨

2008-02-05T18:30:30 = 30:30
1995-12-22T09:05:02 = 5:02
-0010-09-15T04:44:23 = 44:23

y (y)

just the year, that's it, that's the whole pattern 🫶

2008-02-05T18:30:30 = 2008
1995-12-22T09:05:02 = 1995
-0010-09-15T04:44:23 = -10

yM (y/M)

year, slash, month. lowkey minimal but she serves 🌸

2008-02-05T18:30:30 = 2008/2
1995-12-22T09:05:02 = 1995/12
-0010-09-15T04:44:23 = -10/9

yMEd (E y/M/d)

weekday first, then the classic year/month/day stack 👑

2008-02-05T18:30:30 = سه‌شنبه 2008/2/5
1995-12-22T09:05:02 = جمعه 1995/12/22
-0010-09-15T04:44:23 = شنبه -10/9/15

yMMM (MMM y)

month name in front of the year, cute little flip 🦋

2008-02-05T18:30:30 = فوریه 2008
1995-12-22T09:05:02 = دسامبر 1995
-0010-09-15T04:44:23 = سپتامبر -10

yMMMEd (E d MMM y)

full little lineup: weekday, day number, month name, year — the way it just works 😭

2008-02-05T18:30:30 = سه‌شنبه 5 فوریه 2008
1995-12-22T09:05:02 = جمعه 22 دسامبر 1995
-0010-09-15T04:44:23 = شنبه 15 سپتامبر -10

yMMMM (MMMM y)

bestie this is the wide month name (you can clock the extra diacritic on فوریهٔ — that's not a typo, that's the full form, periodt) 💖

2008-02-05T18:30:30 = فوریهٔ 2008
1995-12-22T09:05:02 = دسامبر 1995
-0010-09-15T04:44:23 = سپتامبر -10

yMMMMEEEEd (EEEE d MMMM y)

the full maximalist version: the wide weekday, the day, the wide month, the year. it's giving overachiever and we respect it 🌈

2008-02-05T18:30:30 = سه‌شنبه 5 فوریهٔ 2008
1995-12-22T09:05:02 = جمعه 22 دسامبر 1995
-0010-09-15T04:44:23 = شنبه 15 سپتامبر -10

yMMMd (d MMM y)

day, month, year — the stripped-down version, no weekday invited 🎀

2008-02-05T18:30:30 = 5 فوریه 2008
1995-12-22T09:05:02 = 22 دسامبر 1995
-0010-09-15T04:44:23 = 15 سپتامبر -10

yMd (y/M/d)

all numbers, all slashes, zero notes ⭐

2008-02-05T18:30:30 = 2008/2/5
1995-12-22T09:05:02 = 1995/12/22
-0010-09-15T04:44:23 = -10/9/15

yQQQ (QQQQ y)

quarter time!! and yes, the pattern name says QQQ while the format string uses QQQQ — that's literally what the page says, I'm not touching it, not my business 🙈

2008-02-05T18:30:30 = سه‌ماههٔ اول 2008
1995-12-22T09:05:02 = سه‌ماههٔ چهارم 1995
-0010-09-15T04:44:23 = سه‌ماههٔ سوم -10

yQQQQ (QQQQ y)

same output as yQQQ above, no cap. identical. iconic of them honestly 💀

2008-02-05T18:30:30 = سه‌ماههٔ اول 2008
1995-12-22T09:05:02 = سه‌ماههٔ چهارم 1995
-0010-09-15T04:44:23 = سه‌ماههٔ سوم -10

yw-count-one (هفتهٔ wم Y)

week-of-year with the one plural category 💜

2008-02-05T18:30:30 = هفتهٔ 6م 2008
1995-12-22T09:05:02 = هفتهٔ 51م 1995
-0010-09-15T04:44:23 = هفتهٔ 37م -10

yw-count-other (هفتهٔ wم Y)

the other plural category — and yeah, the output happens to match the one version exactly. slay 💅

2008-02-05T18:30:30 = هفتهٔ 6م 2008
1995-12-22T09:05:02 = هفتهٔ 51م 1995
-0010-09-15T04:44:23 = هفتهٔ 37م -10

---

🌸 Miscellaneous 🌸

Prefers 24 hour time?

Yes. (she said what she said 🕐)

Local first day of the week

6 (شنبه) — Saturday's the opener around here, bestie 🗓️

---

✨ Strftime Patterns ✨

these are the old-school strftime-flavored ones, and they come with little labels so you know what each is for 🧚

%c (%A %Oe %B %Oy، %OH:%OM:%OS) — date time format

2008-02-05T18:30:30 = سه‌شنبه %Oe فوریهٔ %Oy، %OH:%OM:%OS‏
1995-12-22T09:05:02 = جمعه %Oe دسامبر %Oy، %OH:%OM:%OS‏
-0010-09-15T04:44:23 = شنبه %Oe سپتامبر %Oy، %OH:%OM:%OS‏

%x (%Oy/%Om/%Od) — date format

2008-02-05T18:30:30 = %Oy/%Om/%Od
1995-12-22T09:05:02 = %Oy/%Om/%Od
-0010-09-15T04:44:23 = %Oy/%Om/%Od

%X (%OH:%OM:%OS) — time format

2008-02-05T18:30:30 = %OH:%OM:%OS
1995-12-22T09:05:02 = %OH:%OM:%OS
-0010-09-15T04:44:23 = %OH:%OM:%OS

---

📚 SUPPORT 📚

See DateTime::Locale. that's the whole support section, she's short and sweet 🫶

---

and that's a wrap on the fa_IR locale page!! 💖 this beauty shipped as perl v5.42.0, dated 2024-12-12 — go forth and format your Persian dates correctly, bestie, i'm obsessed with you 🌟