DateTim...e::en_JP(3)
π NAME
So, <rainbow>DateTime::Locale::en_JP</rainbow> bestie β this is the <pink>locale data examples</pink> pod for the <purple>English Japan (en-JP)</purple> locale. Yes, that combo. It's giving "English words, Japan-flavoured formatting" and honestly? Iconic. π
This here is a <yellow>User Contributed Perl Documentation</yellow> page, iykyk.
π DESCRIPTION
Okay so here's the β¨teaβ¨: this pod file is literally just <hotpink>examples</hotpink> of all the locale data you get for the <purple>English Japan</purple> locale. Every list, every format string, every sample output β all spelled out so you can peep exactly what you'd get. No cap, it's a whole vibe check for the locale. π¦
πΈ 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
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
Not the<lavender>M T W T F S S</lavender>being the narrowest thing imaginable β when you use narrow days you're literally down to single letters and you just have to<italic>trust</italic> me on whichT` is which. π
πΈ 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
Same deal as the days, bestie β narrow months are<peach>J F M A M J J A S O N D</peach>and yes<italic>May</italic>and<italic>June</italic>keep their full three letters in the abbreviated form. That's not a typo, that's just how it is. π
πΈ 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
One (1) single letter each. Era data said<mint>minimalism</mint>and meant it. π§
πΈ 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 = 2008/02/05
1995-12-22T09:05:02 = 1995/12/22
-0010-09-15T04:44:23 = -10/09/15
Obsessed with the fact that<hotpink>Short</hotpink>is full numeric<cyan>y/MM/ddβ the year goes<italic>first</italic>. And<red>-10just chillin' there as a year, no drama. π₯
πΈ 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
<pink>Full</pink>and<pink>Long</pink>are literally identical output here. Not a glitch, not me being lazy β that's genuinely what the data says. π€·ββοΈ And these are 24-hour style, so<cyan>18:30:30instead of 6:30 PM. Theother` formats below are the ones out here doing AM/PM. β¨
πΈ Datetime Formats
Full
2008-02-05T18:30:30 = Tuesday, February 5, 2008, 18:30:30 UTC
1995-12-22T09:05:02 = Friday, December 22, 1995, 9:05:02 UTC
-0010-09-15T04:44:23 = Saturday, September 15, -10, 4:44:23 UTC
Long
2008-02-05T18:30:30 = February 5, 2008, 18:30:30 UTC
1995-12-22T09:05:02 = December 22, 1995, 9:05:02 UTC
-0010-09-15T04:44:23 = September 15, -10, 4:44:23 UTC
Medium
2008-02-05T18:30:30 = Feb 5, 2008, 18:30:30
1995-12-22T09:05:02 = Dec 22, 1995, 9:05:02
-0010-09-15T04:44:23 = Sep 15, -10, 4:44:23
Short
2008-02-05T18:30:30 = 2008/02/05, 18:30
1995-12-22T09:05:02 = 1995/12/22, 9:05
-0010-09-15T04:44:23 = -10/09/15, 4:44
See how it's just<mint>date format</mint>+<mint>", "</mint>+<mint>time format</mint>, glued together? Chef's kiss. π«Ά
πΈ Available Formats
Alright bestie, this is the <rainbow>big one</rainbow> β every named format this locale ships with, plus what it actually spits out for those same three sample timestamps. Buckle up. π’
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
EBh β E h B
2008-02-05T18:30:30 = Tue 6 B
1995-12-22T09:05:02 = Fri 9 B
-0010-09-15T04:44:23 = Sat 4 B
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
<yellow>Edis out here putting the day numberbeforethe weekday.5 Tue`. Chaotic but valid. π
Eh β E h a
2008-02-05T18:30:30 = Tue 6 PM
1995-12-22T09:05:02 = Fri 9 AM
-0010-09-15T04:44:23 = Sat 4 AM
Eh-alt-ascii β E h a
2008-02-05T18:30:30 = Tue 6 PM
1995-12-22T09:05:02 = Fri 9 AM
-0010-09-15T04:44:23 = Sat 4 AM
π So<peach>EhandEh-alt-ascii</peach>have the<italic>same</italic>patternE h a, and the difference is the space between the time and the AM/PM: the plain one uses a non-ASCII narrow no-break space, and the<mint>-alt-ascii` twin uses a plain ordinary space. That's it. That's the whole difference. iykyk. π
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
GyM β M/y G
2008-02-05T18:30:30 = 2/2008 AD
1995-12-22T09:05:02 = 12/1995 AD
-0010-09-15T04:44:23 = 9/-10 BC
GyMEd β E, M/d/y G
2008-02-05T18:30:30 = Tue, 2/5/2008 AD
1995-12-22T09:05:02 = Fri, 12/22/1995 AD
-0010-09-15T04:44:23 = Sat, 9/15/-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 β y/MM/dd G
2008-02-05T18:30:30 = 2008/02/05 AD
1995-12-22T09:05:02 = 1995/12/22 AD
-0010-09-15T04:44:23 = -10/09/15 BC
H β H
2008-02-05T18:30:30 = 18
1995-12-22T09:05:02 = 9
-0010-09-15T04:44:23 = 4
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
Hv β HH v
2008-02-05T18:30:30 = 18 UTC
1995-12-22T09:05:02 = 09 UTC
-0010-09-15T04:44:23 = 04 UTC
<cyan>Hvis the one doing zero-padding (09,04) β note the pattern isHH v`, capital-H capital-H. β
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
Two plural categories,<hotpink>count-oneandcount-other</hotpink>, and for these samples they give the exact same output. Note the literal quoted words'week'and'of'in the pattern β those quotes are part of the pattern, so keep 'em. π
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) π
Like, the hour and minute but make it mood, plus the time zone name. And yes, bestie, the spaces here are the fancy ones (narrow no-break, iykyk β the alt-ascii version exists for a reason π).
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) πΈ
Same vibe, boring spaces. For when your terminal is being dramatic about unicode.
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
hv (h a v) β¨
Hour only, period, zone. Minimalist queen behavior.
2008-02-05T18:30:30 = 6 PM UTC
1995-12-22T09:05:02 = 9 AM UTC
-0010-09-15T04:44:23 = 4 AM UTC
hv-alt-ascii (h a v) π
The plain-spaces twin of hv. Same energy, zero fancy whitespace.
2008-02-05T18:30:30 = 6 PM UTC
1995-12-22T09:05:02 = 9 AM UTC
-0010-09-15T04:44:23 = 4 AM UTC
ms (mm:ss) β±οΈ
Minutes and seconds, no hours invited to the party. It's giving stopwatch.
2008-02-05T18:30:30 = 30:30
1995-12-22T09:05:02 = 05:02
-0010-09-15T04:44:23 = 44:23
y (y) π
Just the year, bestie. That's it. That's the whole format.
2008-02-05T18:30:30 = 2008
1995-12-22T09:05:02 = 1995
-0010-09-15T04:44:23 = -10
yM (MM/y) π·
Month then year. Note the month comes first here β do not come for me, it's literally what the locale does.
2008-02-05T18:30:30 = 02/2008
1995-12-22T09:05:02 = 12/1995
-0010-09-15T04:44:23 = 09/-10
yMEd (E, y/MM/dd) ποΈ
Weekday, then year/month/day with the slashes. Very organized of her.
2008-02-05T18:30:30 = Tue, 2008/02/05
1995-12-22T09:05:02 = Fri, 1995/12/22
-0010-09-15T04:44:23 = Sat, -10/09/15
yMMM (MMM y) π¦
Short month name plus year. Clean, cute, 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) π
Weekday, short month, day, year. The full little package with commas, slay.
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) π
The full month name because we're not abbreviating anything today.
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) π
Short month, day, year β no weekday, she's keeping it lowkey.
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 (y/MM/dd) π§
Slashes, year first, very much the standard en_JP look.
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 (QQQ y) β
Quarter, abbreviated, plus the year. Big fiscal-energy.
2008-02-05T18:30:30 = Q1 2008
1995-12-22T09:05:02 = Q4 1995
-0010-09-15T04:44:23 = Q3 -10
yQQQQ (QQQQ y) π
The long-form quarter with the ordinal suffix β "1st", "4th", "3rd". Fr fr, she spells it out.
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 and week-year, spelled out with the word "week" and "of" baked in. The -count-one bit is the singular-ish CLDR plural category, and for en_JP it lands on the exact same output as the other one β no spoilers, just look π
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) π«Ά
The "other" plural category, and yeah β identical output to yw-count-one. Both are here because that's how the locale data rolls.
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 π¦
Random little facts about this locale that live rent-free in my head:
- Prefers 24 hour time? Yes
- Local first day of the week:
7(Sunday)
β° Strftime Patterns β°
These are the classic strftime-style patterns, in case you're old school like that. Respect honestly.
%c (%a %b %e %H:%M:%S %Y) β date time format π₯
The whole full date-time combo meal.
2008-02-05T18:30:30 = Tue Feb 5 18:30:30 2008
1995-12-22T09:05:02 = Fri Dec 22 09:05:02 1995
-0010-09-15T04:44:23 = Sat Sep 15 04:44:23 -10
%x (%m/%d/%y) β date format ποΈ
Date only, month/day/year, two-digit year. Keep your eyes on that year, bestie.
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 β±οΈ
Time only, and yes it's 24-hour, because "Prefers 24 hour time? Yes" β¨
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 π
Go look at DateTime::Locale, that's where the real lore lives. π«Ά
okay that's the whole page bestie!! π this lovely little localized-data drop ships with perl v5.42.2 and was dated 2026-09-15 β go off, date/time data, periodt π β¨
π¦ where this page comes from
- alpine 3.23: perl-datetime-locale-doc 1.46-r0 Β· GPL-1.0-or-later OR Artistic-1.0-Perl
- alpine 3.24: perl-datetime-locale-doc 1.46-r0 Β· GPL-1.0-or-later OR Artistic-1.0-Perl
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms