DateTim...e::en_US(3)
π DateTime::Locale::en_US(3) π
okay bestie so this is your User Contributed Perl Documentation era, and today's main character is DateTime::Locale::en_US β the locale data for the English United States (en-US) locale. Yes, the whole thing. All the days, all the months, all the formats. Ngl it's a lot, but we're gonna get through it together. π
β¨ NAME β¨
DateTime::Locale::en_US β Locale data examples for the English United States (en-US) locale. That's the whole name, no cap.
πΈ DESCRIPTION πΈ
So this pod file contains examples of the locale data available for the English United States locale. It's literally a showroom of how en-US formats its days, months, quarters, eras, dates, times, datetimes, and a whole buffet of custom formats. Buckle up, gorgeous, we're touring all of it. π¦
π Days
Wide (format)
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
Abbreviated (format)
Mon
Tue
Wed
Thu
Fri
Sat
Sun
Narrow (format)
M
T
W
T
F
S
S
ngl the narrow ones are giving single-letter mystery β two Ts and two Ss in there, iykyk. π«Ά
Wide (stand-alone)
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
Abbreviated (stand-alone)
Mon
Tue
Wed
Thu
Fri
Sat
Sun
Narrow (stand-alone)
M
T
W
T
F
S
S
π Months
Wide (format)
January
February
March
April
May
June
July
August
September
October
November
December
Abbreviated (format)
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Sep
Oct
Nov
Dec
Narrow (format)
J
F
M
A
M
J
J
A
S
O
N
D
Wide (stand-alone)
January
February
March
April
May
June
July
August
September
October
November
December
Abbreviated (stand-alone)
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Sep
Oct
Nov
Dec
Narrow (stand-alone)
J
F
M
A
M
J
J
A
S
O
N
D
bestie note: the narrow month letters are chaos β J three times, M twice, A twice. it's giving cryptic crossword. π
π¦ Quarters
Wide (format)
1st quarter
2nd quarter
3rd quarter
4th quarter
Abbreviated (format)
Q1
Q2
Q3
Q4
Narrow (format)
1
2
3
4
Wide (stand-alone)
1st quarter
2nd quarter
3rd quarter
4th quarter
Abbreviated (stand-alone)
Q1
Q2
Q3
Q4
Narrow (stand-alone)
1
2
3
4
π Eras
Wide (format)
Before Christ
Anno Domini
Abbreviated (format)
BC
AD
Narrow (format)
B
A
and yes, Eras only gets format variants here β no stand-alone era content, so don't come for me, that's just what the data says. π
π Date Formats
Full
2008-02-05T18:30:30 = Tuesday, February 5, 2008
1995-12-22T09:05:02 = Friday, December 22, 1995
-0010-09-15T04:44:23 = Saturday, September 15, -10
Long
2008-02-05T18:30:30 = February 5, 2008
1995-12-22T09:05:02 = December 22, 1995
-0010-09-15T04:44:23 = September 15, -10
Medium
2008-02-05T18:30:30 = Feb 5, 2008
1995-12-22T09:05:02 = Dec 22, 1995
-0010-09-15T04:44:23 = Sep 15, -10
Short
2008-02-05T18:30:30 = 2/5/08
1995-12-22T09:05:02 = 12/22/95
-0010-09-15T04:44:23 = 9/15/-10
π«Ά obsessed with the negative-year rep β-0010-09-15T04:44:23becomesSeptember 15, -10and the short one goes full gremlin mode:9/15/-10.
π Time Formats
Full
2008-02-05T18:30:30 = 6:30:30 PM UTC
1995-12-22T09:05:02 = 9:05:02 AM UTC
-0010-09-15T04:44:23 = 4:44:23 AM UTC
Long
2008-02-05T18:30:30 = 6:30:30 PM UTC
1995-12-22T09:05:02 = 9:05:02 AM UTC
-0010-09-15T04:44:23 = 4:44:23 AM UTC
Medium
2008-02-05T18:30:30 = 6:30:30 PM
1995-12-22T09:05:02 = 9:05:02 AM
-0010-09-15T04:44:23 = 4:44:23 AM
Short
2008-02-05T18:30:30 = 6:30 PM
1995-12-22T09:05:02 = 9:05 AM
-0010-09-15T04:44:23 = 4:44 AM
the way Full and Long are just out here wearing the same outfit β iconic but also, girl, we see you. π
π Datetime Formats
Full
2008-02-05T18:30:30 = Tuesday, February 5, 2008, 6:30:30 PM UTC
1995-12-22T09:05:02 = Friday, December 22, 1995, 9:05:02 AM UTC
-0010-09-15T04:44:23 = Saturday, September 15, -10, 4:44:23 AM UTC
Long
2008-02-05T18:30:30 = February 5, 2008, 6:30:30 PM UTC
1995-12-22T09:05:02 = December 22, 1995, 9:05:02 AM UTC
-0010-09-15T04:44:23 = September 15, -10, 4:44:23 AM UTC
Medium
2008-02-05T18:30:30 = Feb 5, 2008, 6:30:30 PM
1995-12-22T09:05:02 = Dec 22, 1995, 9:05:02 AM
-0010-09-15T04:44:23 = Sep 15, -10, 4:44:23 AM
Short
2008-02-05T18:30:30 = 2/5/08, 6:30 PM
1995-12-22T09:05:02 = 12/22/95, 9:05 AM
-0010-09-15T04:44:23 = 9/15/-10, 4:44 AM
date plus time, soulmate behavior π«Ά
β Available Formats β
okay this is the bonus-track section β every named format with its pattern and the same three test timestamps. slay. π
π 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 = Tue
1995-12-22T09:05:02 = Fri
-0010-09-15T04:44:23 = Sat
π EBhm (E h:mm B)
2008-02-05T18:30:30 = Tue 6:30 B
1995-12-22T09:05:02 = Fri 9:05 B
-0010-09-15T04:44:23 = Sat 4:44 B
π EBhms (E h:mm:ss B)
2008-02-05T18:30:30 = Tue 6:30:30 B
1995-12-22T09:05:02 = Fri 9:05:02 B
-0010-09-15T04:44:23 = Sat 4:44:23 B
π EHm (E HH:mm)
2008-02-05T18:30:30 = Tue 18:30
1995-12-22T09:05:02 = Fri 09:05
-0010-09-15T04:44:23 = Sat 04:44
π EHms (E HH:mm:ss)
2008-02-05T18:30:30 = Tue 18:30:30
1995-12-22T09:05:02 = Fri 09:05:02
-0010-09-15T04:44:23 = Sat 04:44:23
π Ed (d E)
2008-02-05T18:30:30 = 5 Tue
1995-12-22T09:05:02 = 22 Fri
-0010-09-15T04:44:23 = 15 Sat
π Ehm (E h:mm a)
2008-02-05T18:30:30 = Tue 6:30 PM
1995-12-22T09:05:02 = Fri 9:05 AM
-0010-09-15T04:44:23 = Sat 4:44 AM
π Ehm-alt-ascii (E h:mm a)
2008-02-05T18:30:30 = Tue 6:30 PM
1995-12-22T09:05:02 = Fri 9:05 AM
-0010-09-15T04:44:23 = Sat 4:44 AM
π Ehms (E h:mm:ss a)
2008-02-05T18:30:30 = Tue 6:30:30 PM
1995-12-22T09:05:02 = Fri 9:05:02 AM
-0010-09-15T04:44:23 = Sat 4:44:23 AM
π Ehms-alt-ascii (E h:mm:ss a)
2008-02-05T18:30:30 = Tue 6:30:30 PM
1995-12-22T09:05:02 = Fri 9:05:02 AM
-0010-09-15T04:44:23 = Sat 4:44:23 AM
π Gy (y G)
2008-02-05T18:30:30 = 2008 AD
1995-12-22T09:05:02 = 1995 AD
-0010-09-15T04:44:23 = -10 BC
π GyMMM (MMM y G)
2008-02-05T18:30:30 = Feb 2008 AD
1995-12-22T09:05:02 = Dec 1995 AD
-0010-09-15T04:44:23 = Sep -10 BC
π GyMMMEd (E, MMM d, y G)
2008-02-05T18:30:30 = Tue, Feb 5, 2008 AD
1995-12-22T09:05:02 = Fri, Dec 22, 1995 AD
-0010-09-15T04:44:23 = Sat, Sep 15, -10 BC
π GyMMMd (MMM d, y G)
2008-02-05T18:30:30 = Feb 5, 2008 AD
1995-12-22T09:05:02 = Dec 22, 1995 AD
-0010-09-15T04:44:23 = Sep 15, -10 BC
π GyMd (M/d/y G)
2008-02-05T18:30:30 = 2/5/2008 AD
1995-12-22T09:05:02 = 12/22/1995 AD
-0010-09-15T04:44:23 = 9/15/-10 BC
π 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, M/d)
2008-02-05T18:30:30 = Tue, 2/5
1995-12-22T09:05:02 = Fri, 12/22
-0010-09-15T04:44:23 = Sat, 9/15
π MMM (LLL)
2008-02-05T18:30:30 = Feb
1995-12-22T09:05:02 = Dec
-0010-09-15T04:44:23 = Sep
π MMMEd (E, MMM d)
2008-02-05T18:30:30 = Tue, Feb 5
1995-12-22T09:05:02 = Fri, Dec 22
-0010-09-15T04:44:23 = Sat, Sep 15
π MMMMW-count-one ('week' W 'of' MMMM)
2008-02-05T18:30:30 = week 1 of February
1995-12-22T09:05:02 = week 3 of December
-0010-09-15T04:44:23 = week 2 of September
π MMMMW-count-other ('week' W 'of' MMMM)
2008-02-05T18:30:30 = week 1 of February
1995-12-22T09:05:02 = week 3 of December
-0010-09-15T04:44:23 = week 2 of September
yes bestie, MMMWW-count-one and MMMWW-count-other are twins β same pattern, same output. plural rules said "not today." π
π MMMMd (MMMM d)
2008-02-05T18:30:30 = February 5
1995-12-22T09:05:02 = December 22
-0010-09-15T04:44:23 = September 15
π MMMd (MMM d)
2008-02-05T18:30:30 = Feb 5
1995-12-22T09:05:02 = Dec 22
-0010-09-15T04:44:23 = Sep 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 PM
1995-12-22T09:05:02 = 9 AM
-0010-09-15T04:44:23 = 4 AM
π h-alt-ascii (h a)
2008-02-05T18:30:30 = 6 PM
1995-12-22T09:05:02 = 9 AM
-0010-09-15T04:44:23 = 4 AM
π hm (h:mm a)
2008-02-05T18:30:30 = 6:30 PM
1995-12-22T09:05:02 = 9:05 AM
-0010-09-15T04:44:23 = 4:44 AM
π hm-alt-ascii (h:mm a)
2008-02-05T18:30:30 = 6:30 PM
1995-12-22T09:05:02 = 9:05 AM
-0010-09-15T04:44:23 = 4:44 AM
π hms (h:mm:ss a)
2008-02-05T18:30:30 = 6:30:30 PM
1995-12-22T09:05:02 = 9:05:02 AM
-0010-09-15T04:44:23 = 4:44:23 AM
π hms-alt-ascii (h:mm:ss a)
2008-02-05T18:30:30 = 6:30:30 PM
1995-12-22T09:05:02 = 9:05:02 AM
-0010-09-15T04:44:23 = 4:44:23 AM
π hmsv (h:mm:ss a v)
2008-02-05T18:30:30 = 6:30:30 PM UTC
1995-12-22T09:05:02 = 9:05:02 AM UTC
-0010-09-15T04:44:23 = 4:44:23 AM UTC
π hmsv-alt-ascii (h:mm:ss a v)
2008-02-05T18:30:30 = 6:30:30 PM UTC
1995-12-22T09:05:02 = 9:05:02 AM UTC
-0010-09-15T04:44:23 = 4:44:23 AM UTC
π hmv (h:mm a v)
2008-02-05T18:30:30 = 6:30 PM UTC
1995-12-22T09:05:02 = 9:05 AM UTC
-0010-09-15T04:44:23 = 4:44 AM UTC
π hmv-alt-ascii (h:mm a v)
2008-02-05T18:30:30 = 6:30 PM UTC
1995-12-22T09:05:02 = 9:05 AM UTC
-0010-09-15T04:44:23 = 4:44 AM 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)
and that's where part 1 runs out of runway, bestie β yM (M/y) is literally mid-sentence, so the rest of the format buffet is waiting for you in part 2. don't go anywhere. π¦β¨
Picking up right where we left off β here's the tail end of that format, no interruptions π
2008-02-05T18:30:30 = 2/2008
1995-12-22T09:05:02 = 12/1995
-0010-09-15T04:44:23 = 9/-10
yMEd (E, M/d/y)
Day name + the good ol' numeric date, bestie π
2008-02-05T18:30:30 = Tue, 2/5/2008
1995-12-22T09:05:02 = Fri, 12/22/1995
-0010-09-15T04:44:23 = Sat, 9/15/-10
yMMM (MMM y)
Short month + year. Clean, minimal, iconic β¨
2008-02-05T18:30:30 = Feb 2008
1995-12-22T09:05:02 = Dec 1995
-0010-09-15T04:44:23 = Sep -10
yMMMEd (E, MMM d, y)
The full casual-date vibe: day name, short month, day, year π
2008-02-05T18:30:30 = Tue, Feb 5, 2008
1995-12-22T09:05:02 = Fri, Dec 22, 1995
-0010-09-15T04:44:23 = Sat, Sep 15, -10
yMMMM (MMMM y)
Now we're spelling the whole month out, because we're fancy like that πΈ
2008-02-05T18:30:30 = February 2008
1995-12-22T09:05:02 = December 1995
-0010-09-15T04:44:23 = September -10
yMMMd (MMM d, y)
All the info, none of the weekday. lowkey efficient π¦
2008-02-05T18:30:30 = Feb 5, 2008
1995-12-22T09:05:02 = Dec 22, 1995
-0010-09-15T04:44:23 = Sep 15, -10
yMd (M/d/y)
Fully numeric, no frills, straight to the point π
2008-02-05T18:30:30 = 2/5/2008
1995-12-22T09:05:02 = 12/22/1995
-0010-09-15T04:44:23 = 9/15/-10
yQQQ (QQQ y)
Quarter energy, abbreviated π
2008-02-05T18:30:30 = Q1 2008
1995-12-22T09:05:02 = Q4 1995
-0010-09-15T04:44:23 = Q3 -10
yQQQQ (QQQQ y)
Quarter energy, but spelled out and so much more dramatic π
2008-02-05T18:30:30 = 1st quarter 2008
1995-12-22T09:05:02 = 4th quarter 1995
-0010-09-15T04:44:23 = 3rd quarter -10
yw-count-one ('week' w 'of' Y)
Week number with the literal words week and of glued in. This is the count-one variant π
2008-02-05T18:30:30 = week 6 of 2008
1995-12-22T09:05:02 = week 51 of 1995
-0010-09-15T04:44:23 = week 37 of -10
yw-count-other ('week' w 'of' Y)
Same pattern, same output, different plural category β count-other this time π«Ά
2008-02-05T18:30:30 = week 6 of 2008
1995-12-22T09:05:02 = week 51 of 1995
-0010-09-15T04:44:23 = week 37 of -10
Miscellaneous
Little random facts about this locale, bestie β a whole vibe check β¨
- Prefers 24 hour time?
No.
- Local first day of the week
7 (Sunday)
Strftime Patterns
The classic strftime-style escapes, serving looks π°οΈπ
%c (%a %d %b %Y %r %Z) β date time format
The whole date and time and zone, all at once. main character energy π₯
2008-02-05T18:30:30 = Tue 05 Feb 2008 06:30:30 PM UTC
1995-12-22T09:05:02 = Fri 22 Dec 1995 09:05:02 AM UTC
-0010-09-15T04:44:23 = Sat 15 Sep -10 04:44:23 AM UTC
Heads up: these%cexamples are formatted with leading zeros on the day (05,22,15) β that's just what this one does, no cap.
%x (%m/%d/%Y) β date format
Just the date, zero-padded and tidy π
2008-02-05T18:30:30 = 02/05/2008
1995-12-22T09:05:02 = 12/22/1995
-0010-09-15T04:44:23 = 09/15/-10
%X (%r) β time format
Just the time, 12-hour style because apparently we're like that πΈ
2008-02-05T18:30:30 = 06:30:30 PM
1995-12-22T09:05:02 = 09:05:02 AM
-0010-09-15T04:44:23 = 04:44:23 AM
π SUPPORT π
See DateTime::Locale. That's it, that's the whole support situation π«Ά
And that's the page, bestie!! ππ This beauty is perl v5.42.0 business, dated 2024-12-12, and the header/footer both call it DateTim...e::en_US(3) β yes, that name really is abbreviated with the ..., and honestly? It's giving β¨mysteriousβ¨. slay. π
π
π¦ where this page comes from
- opensuse-leap 16.0: perl-DateTime-Locale 1.440000-160000.2.2 Β· Artistic-1.0 OR GPL-1.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms