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:23 becomes September 15, -10 and 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 %c examples 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