DateTim...ale::ar(3)

🌈 DateTime::Locale::ar(3) 🌈

okay so bestie, welcome to the DateTime::Locale::ar man page — section 3 of the manual, the user-contributed Perl docs corner of the universe 💅. This is literally the Arabic (ar) locale data file, and it's giving reference-sheet realness. Every day name, month name, quarter, era, and date/time format the locale knows about? Yeah, it's all in here. No cap.


💖 NAME 💖

DateTime::Locale::ar — Locale data examples for the Arabic (ar) locale 🫶


✨ DESCRIPTION ✨

So this pod file is basically a big ol' show-and-tell: it contains examples of the locale data that's available for the Arabic locale. Think of it as the vibe board for ar — everything DateTime::Locale can spit out, demonstrated with real datetime strings. Iconic, honestly 🎀


🌸 Days 🌸

The week, in Arabic, showing format and stand-alone versions in three widths. Bestie, spoiler alert: for this locale the wide and abbreviated forms are identical, so don't come for me — that's just what the data says 💀

Wide (format)

الاثنين
الثلاثاء
الأربعاء
الخميس
الجمعة
السبت
الأحد

Abbreviated (format)

الاثنين
الثلاثاء
الأربعاء
الخميس
الجمعة
السبت
الأحد

Narrow (format)

ن
ث
ر
خ
ج
س
ح

Wide (stand-alone)

الاثنين
الثلاثاء
الأربعاء
الخميس
الجمعة
السبت
الأحد

Abbreviated (stand-alone)

الاثنين
الثلاثاء
الأربعاء
الخميس
الجمعة
السبت
الأحد

Narrow (stand-alone)

ن
ث
ر
خ
ج
س
ح

🦋 Months 🦋

Twelve months, coming right up — again in wide, abbreviated, and narrow, both format and stand-alone. The wide and abbreviated months are the same here too (the way that Arabic month names just do that ✨). The narrow ones are single letters and yes, أ and و and ن are all chilling in there — iykyk.

Wide (format)

يناير
فبراير
مارس
أبريل
مايو
يونيو
يوليو
أغسطس
سبتمبر
أكتوبر
نوفمبر
ديسمبر

Abbreviated (format)

يناير
فبراير
مارس
أبريل
مايو
يونيو
يوليو
أغسطس
سبتمبر
أكتوبر
نوفمبر
ديسمبر

Narrow (format)

ي
ف
م
أ
و
ن
ل
غ
س
ك
ب
د

Wide (stand-alone)

يناير
فبراير
مارس
أبريل
مايو
يونيو
يوليو
أغسطس
سبتمبر
أكتوبر
نوفمبر
ديسمبر

Abbreviated (stand-alone)

يناير
فبراير
مارس
أبريل
مايو
يونيو
يوليو
أغسطس
سبتمبر
أكتوبر
نوفمبر
ديسمبر

Narrow (stand-alone)

ي
ف
م
أ
و
ن
ل
غ
س
ك
ب
د

🎀 Quarters 🎀

Four quarters, and the wide + abbreviated versions are literally the same string — الربع الأول through الربع الرابع. The narrow ones are Arabic-Indic digits: ١ ٢ ٣ ٤. Slay 🔥

Wide (format)

الربع الأول
الربع الثاني
الربع الثالث
الربع الرابع

Abbreviated (format)

الربع الأول
الربع الثاني
الربع الثالث
الربع الرابع

Narrow (format)

١
٢
٣
٤

Wide (stand-alone)

الربع الأول
الربع الثاني
الربع الثالث
الربع الرابع

Abbreviated (stand-alone)

الربع الأول
الربع الثاني
الربع الثالث
الربع الرابع

Narrow (stand-alone)

١
٢
٣
٤

👑 Eras 👑

Two eras, bestie: before and after. And heads up — this section only has format variants, no stand-alone ones. That's not me forgetting, that's just what's in the data 🙈

Wide (format)

قبل الميلاد
ميلادي

Abbreviated (format)

ق.م
م

Narrow (format)

ق.م
م

💜 Date Formats 💜

Four sizes of date — Full, Long, Medium, Short — each demoed with the same three sample timestamps so you can compare. The samples are 2008-02-05T18:30:30, 1995-12-22T09:05:02, and the absolute icon -0010-09-15T04:44:23 (yes, negative year, main character energy 😭).

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 = 05/02/2008
1995-12-22T09:05:02 = 22/12/1995
-0010-09-15T04:44:23 = 15/09/-10

Short

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

⭐ Time Formats ⭐

Same four sizes, but for the clock. Notice how Full and Long keep the seconds and slap UTC on the end, Medium drops the UTC, and Short drops the seconds entirely. It's giving "progressive relaxation" but for timestamps 🧚

Full

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

Long

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

Medium

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

Short

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

🌟 Datetime Formats 🌟

Date plus time, glued together with the Arabic comma ، because aesthetics. Full and Long hang onto UTC; Medium and Short keep it cute and local. Same three timestamps every time, bestie, consistency is key 💖

Full

2008-02-05T18:30:30 = الثلاثاء، 5 فبراير 2008، 6: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، 6: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 = 05/02/2008، 6:30:30 م
1995-12-22T09:05:02 = 22/12/1995، 9:05:02 ص
-0010-09-15T04:44:23 = 15/09/-10، 4:44:23 ص

Short

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

🔥 Available Formats 🔥

Okay this is the big one — every named format the locale ships, each heading showing the format ID and its pattern in parens, then three sample renderings. Buckle up, there's a lot, and we're doing them all. No skipping, periodt 🫶

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 HH:mm)

2008-02-05T18:30:30 = الثلاثاء 18:30
1995-12-22T09:05:02 = الجمعة 09:05
-0010-09-15T04:44:23 = السبت 04:44

EHms (E HH:mm:ss)

2008-02-05T18:30:30 = الثلاثاء 18:30:30
1995-12-22T09:05:02 = الجمعة 09:05:02
-0010-09-15T04:44:23 = السبت 04: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 (dd-MM-y GGGGG)

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

H (HH)

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

Hm (HH:mm)

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

Hms (HH:mm:ss)

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

Hmsv (HH:mm:ss v)

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

Hmv (HH:mm v)

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

M (L)

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

MEd (E، d/M)

2008-02-05T18:30:30 = الثلاثاء، 5/2
1995-12-22T09:05:02 = الجمعة، 22/12
-0010-09-15T04:44:23 = السبت، 15/9

MMM (LLL)

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

MMMEd (E، d MMM)

2008-02-05T18:30:30 = الثلاثاء، 5 فبراير
1995-12-22T09:05:02 = الجمعة، 22 ديسمبر
-0010-09-15T04:44:23 = السبت، 15 سبتمبر

MMMMEd (E، d MMMM)

2008-02-05T18:30:30 = الثلاثاء، 5 فبراير
1995-12-22T09:05:02 = الجمعة، 22 ديسمبر
-0010-09-15T04:44:23 = السبت، 15 سبتمبر

MMMMW-count-few (الأسبوع W من MMMM)

2008-02-05T18:30:30 = الأسبوع 1 من فبراير
1995-12-22T09:05:02 = الأسبوع 3 من ديسمبر
-0010-09-15T04:44:23 = الأسبوع 2 من سبتمبر

MMMMW-count-many (الأسبوع W من MMMM)

2008-02-05T18:30:30 = الأسبوع 1 من فبراير
1995-12-22T09:05:02 = الأسبوع 3 من ديسمبر
-0010-09-15T04:44:23 = الأسبوع 2 من سبتمبر

MMMMW-count-one (الأسبوع W من MMMM)

2008-02-05T18:30:30 = الأسبوع 1 من فبراير
1995-12-22T09:05:02 = الأسبوع 3 من ديسمبر
-0010-09-15T04:44:23 = الأسبوع 2 من سبتمبر

MMMMW-count-other (الأسبوع W من MMMM)

2008-02-05T18:30:30 = الأسبوع 1 من فبراير
1995-12-22T09:05:02 = الأسبوع 3 من ديسمبر
-0010-09-15T04:44:23 = الأسبوع 2 من سبتمبر

MMMMW-count-two (الأسبوع W من MMMM)

2008-02-05T18:30:30 = الأسبوع 1 من فبراير
1995-12-22T09:05:02 = الأسبوع 3 من ديسمبر
-0010-09-15T04:44:23 = الأسبوع 2 من سبتمبر

MMMMW-count-zero (الأسبوع W من MMMM)

2008-02-05T18:30:30 = الأسبوع 1 من فبراير
1995-12-22T09:05:02 = الأسبوع 3 من ديسمبر
-0010-09-15T04:44:23 = الأسبوع 2 من سبتمبر

MMMMd (d MMMM)

...and bestie, that's exactly where part one runs out of page 😭🌸 the formats keep going — more of them are waiting for you in part two, so don't go anywhere 🫶

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

...and that's the tail end of the previous pattern's examples, bestie 💅 no need to panic, it's not a stray fragment, it's just where we came in. Carrying on:

MMMd — d MMM

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

MMdd — dd/MM

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

Md — d/M

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

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

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

ms — mm:ss

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

y — y

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

yM — M/y

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

yMEd — E، d/M/y

  2008-02-05T18:30:30 = الثلاثاء، 5/2/2008
  1995-12-22T09:05:02 = الجمعة، 22/12/1995
 -0010-09-15T04:44:23 = السبت، 15/9/-10

yMM — MM/y

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

yMMM — MMM y

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

yMMMEd — E، d MMM y

  2008-02-05T18:30:30 = الثلاثاء، 5 فبراير 2008
  1995-12-22T09:05:02 = الجمعة، 22 ديسمبر 1995
 -0010-09-15T04:44:23 = السبت، 15 سبتمبر -10

yMMMM — MMMM y

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

yMMMd — d MMM y

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

yMd — d/M/y

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

yQQQ — QQQ y

  2008-02-05T18:30:30 = الربع الأول 2008
  1995-12-22T09:05:02 = الربع الرابع 1995
 -0010-09-15T04:44:23 = الربع الثالث -10

yQQQQ — QQQQ y

  2008-02-05T18:30:30 = الربع الأول 2008
  1995-12-22T09:05:02 = الربع الرابع 1995
 -0010-09-15T04:44:23 = الربع الثالث -10

yw-count-few — الأسبوع w من سنة Y

  2008-02-05T18:30:30 = الأسبوع 6 من سنة 2008
  1995-12-22T09:05:02 = الأسبوع 51 من سنة 1995
 -0010-09-15T04:44:23 = الأسبوع 37 من سنة -10

yw-count-many — الأسبوع w من سنة Y

  2008-02-05T18:30:30 = الأسبوع 6 من سنة 2008
  1995-12-22T09:05:02 = الأسبوع 51 من سنة 1995
 -0010-09-15T04:44:23 = الأسبوع 37 من سنة -10

yw-count-one — الأسبوع w من سنة Y

  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

  2008-02-05T18:30:30 = الأسبوع 6 من سنة 2008
  1995-12-22T09:05:02 = الأسبوع 51 من سنة 1995
 -0010-09-15T04:44:23 = الأسبوع 37 من سنة -10

yw-count-two — الأسبوع w من سنة Y

  2008-02-05T18:30:30 = الأسبوع 6 من سنة 2008
  1995-12-22T09:05:02 = الأسبوع 51 من سنة 1995
 -0010-09-15T04:44:23 = الأسبوع 37 من سنة -10

yw-count-zero — الأسبوع w من سنة Y

  2008-02-05T18:30:30 = الأسبوع 6 من سنة 2008
  1995-12-22T09:05:02 = الأسبوع 51 من سنة 1995
 -0010-09-15T04:44:23 = الأسبوع 37 من سنة -10
🫶 okay yes, all six of those yw-count-* variants print the exact same thing — that's not me being lazy, that's literally what's listed. They exist as separate keys and they all resolve identically here. Respect the roster.

🌸 Miscellaneous 🌸

  • Prefers 24 hour time? No
  • Local first day of the week 1 (الاثنين)

⭐ Strftime Patterns ⭐

Ok so these are the classic strftime-style ones, and ngl they lowkey behave a little differently from the patterns above — same three test dates though, so you can compare side by side 🎀

%c (%a %b %e %H:%M:%S %Y) — date time format

  2008-02-05T18:30:30 = الثلاثاء فبراير  5 18:30:30 2008
  1995-12-22T09:05:02 = الجمعة ديسمبر 22 09:05:02 1995
 -0010-09-15T04:44:23 = السبت سبتمبر 15 04:44:23 -10

%x (%m/%d/%y) — date format

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

%X (%H:%M:%S) — time format

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

🫶 SUPPORT 🫶

See DateTime::Locale.

That's it. That's the whole support section. Iconic minimalism honestly 👑


✨ aaaand that's a wrap on the Arabic locale data page, bestie! This was DateTim...ale::ar(3) from perl v5.42.0, dated 2024-12-12 — go forth and format your dates, you absolute main character 💖🦋

📦 where this page comes from