DateTim...ale::shn(3)

📦

version 1.440000 · 9 versions

1.440000 · opensuse-leap 16.0 (latest)
1.43 · epel 10
1.46 · alpine 3.22
1.46 · alpine 3.23, alpine 3.24
1.46 · arch rolling
1.45 · fedora 43
1.45 · fedora 44
1.45 · ubuntu resolute, ubuntu stonking
1.41 · debian trixie, ubuntu questing

💖 NAME 💖

okay so bestie, this is DateTime::Locale::shn(3) from the User Contributed Perl Documentation corner of the internet, and the manual name is literally DateTime::Locale::shn - Locale data examples for the Shan (shn) locale. That’s the whole assignment. ✨

🌈 DESCRIPTION 🌈

This pod file contains examples of the locale data available for the Shan locale. Translation: it’s a showcase of all the day names, month names, quarter names, eras, date/time formats, named patterns, misc preferences, and strftime patterns. I’m gonna walk you through every single bit, no cap. 🫶

🗓️ Days

Wide (format)

wide format day names, coming right up:

Mon
Tue
Wed
Thu
Fri
Sat
Sun

Abbreviated (format)

abbreviated format, same cute little trio-letter energy:

Mon
Tue
Wed
Thu
Fri
Sat
Sun

Narrow (format)

narrow format, iconic minimalism:

M
T
W
T
F
S
S

Wide (stand-alone)

wide stand-alone days:

Mon
Tue
Wed
Thu
Fri
Sat
Sun

Abbreviated (stand-alone)

abbreviated stand-alone days:

Mon
Tue
Wed
Thu
Fri
Sat
Sun

Narrow (stand-alone)

narrow stand-alone days:

M
T
W
T
F
S
S

🌸 Months

Wide (format)

wide format months, bestie:

M01
M02
M03
M04
M05
M06
M07
M08
M09
M10
M11
M12

Abbreviated (format)

abbreviated format months:

M01
M02
M03
M04
M05
M06
M07
M08
M09
M10
M11
M12

Narrow (format)

narrow format months, just the numbers:

Wide (stand-alone)

wide stand-alone months:

M01
M02
M03
M04
M05
M06
M07
M08
M09
M10
M11
M12

Abbreviated (stand-alone)

abbreviated stand-alone months:

M01
M02
M03
M04
M05
M06
M07
M08
M09
M10
M11
M12

Narrow (stand-alone)

narrow stand-alone months:

🦋 Quarters

Wide (format)

wide format quarters:

Q1
Q2
Q3
Q4

Abbreviated (format)

abbreviated format quarters:

Q1
Q2
Q3
Q4

Narrow (format)

narrow format quarters:

Wide (stand-alone)

wide stand-alone quarters:

Q1
Q2
Q3
Q4

Abbreviated (stand-alone)

abbreviated stand-alone quarters:

Q1
Q2
Q3
Q4

Narrow (stand-alone)

narrow stand-alone quarters:

🎀 Eras

Wide (format)

wide format eras:

BCE
CE

Abbreviated (format)

abbreviated format eras:

BCE
CE

Narrow (format)

narrow format eras:

BCE
CE

💅 Date Formats

Full

2008-02-05T18:30:30 = 2008 M02 5, Tue
1995-12-22T09:05:02 = 1995 M12 22, Fri
-0010-09-15T04:44:23 = -10 M09 15, Sat

Long

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

Medium

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

Short

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

⏰ Time Formats

Full

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

Long

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

Medium

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

Short

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

🌟 Datetime Formats

Full

2008-02-05T18:30:30 = 2008 M02 5, Tue 18:30:30 UTC
1995-12-22T09:05:02 = 1995 M12 22, Fri 09:05:02 UTC
-0010-09-15T04:44:23 = -10 M09 15, Sat 04:44:23 UTC

Long

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

Medium

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

Short

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

👑 Available Formats

these are the named formats, and every label gets its own little spotlight with the three sample dates. not a single digit is getting left behind. 💜

`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

`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

`Gy (G y)`

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

`GyMMM (G y MMM)`

2008-02-05T18:30:30 = CE 2008 M02
1995-12-22T09:05:02 = CE 1995 M12
-0010-09-15T04:44:23 = BCE -10 M09

`GyMMMEd (G y MMM d, E)`

2008-02-05T18:30:30 = CE 2008 M02 5, Tue
1995-12-22T09:05:02 = CE 1995 M12 22, Fri
-0010-09-15T04:44:23 = BCE -10 M09 15, Sat

`GyMMMd (G y MMM d)`

2008-02-05T18:30:30 = CE 2008 M02 5
1995-12-22T09:05:02 = CE 1995 M12 22
-0010-09-15T04:44:23 = BCE -10 M09 15

`GyMd (GGGGG y-MM-dd)`

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

`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 (MM-dd, E)`

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

`MMM (LLL)`

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

`MMMEd (MMM d, E)`

2008-02-05T18:30:30 = M02 5, Tue
1995-12-22T09:05:02 = M12 22, Fri
-0010-09-15T04:44:23 = M09 15, Sat

`MMMMW-count-other ('week' W 'of' MMMM)`

2008-02-05T18:30:30 = week 1 of M02
1995-12-22T09:05:02 = week 3 of M12
-0010-09-15T04:44:23 = week 2 of M09

`MMMMd (MMMM d)`

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

`MMMd (MMM d)`

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

`Md (MM-dd)`

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

`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

`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

`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

`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

`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 (y-MM)`

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

`yMEd (y-MM-dd, E)`

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

`yMMM (y MMM)`

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

`yMMMEd (y MMM d, E)`

2008-02-05T18:30:30 = 2008 M02 5, Tue
1995-12-22T09:05:02 = 1995 M12 22, Fri
-0010-09-15T04:44:23 = -10 M09 15, Sat

`yMMMM (y MMMM)`

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

`yMMMd (y MMM d)`

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

`yMd (y-MM-dd)`

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

`yQQQ (y QQQ)`

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

`yQQQQ (y QQQQ)`

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

`yw-count-other ('week' w 'of' Y)`

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

Prefers 24 hour time?

Yes

Local first day of the week

1 (Mon)

🌈 Strftime Patterns

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

2008-02-05T18:30:30 = Tue M02  5 18:30:30 2008
1995-12-22T09:05:02 = Fri M12 22 09:05:02 1995
-0010-09-15T04:44:23 = Sat M09 15 04:44:23 -10

%x (%m/%d/%y) — the "date format" vibe 💅 it's the locale's short-ish date, all slashed up and ready to go.

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) — the "time format" queen 🕰️ hours, minutes, seconds, colon-separated, no notes.

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

ngl bestie, peep that last one — -0010 is a real year and it still formats fine. %x and %X said "negative years? never heard of her" and honestly? slay. 😭

🌈 SUPPORT

Go look at DateTime::Locale — that's literally the whole support section, she's short and she knows it 🫶

okay that's the whole page, you made it, I'm so proud of you fr fr 🎀 This little legend comes from the perl v5.42.0 docs, dated 2024-12-12, filed under the very abbreviated icon that is DateTim...ale::shn(3) — yes the man page was too cunty to spell its own name out 💀 go forth and format your dates, bestie ✨👑

📦 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 2026-11-04: a language model's rewrite of the original, under its terms