DateTim...ale::zh(3)

📦
version 1.440000 · 12 versions
, in opensuse-leap 16.0

💖 DateTime::Locale::zh — locale vibes for Chinese (zh)

okay bestie, so this is the pod file for DateTime::Locale::zh, and it's literally just a big glow-up lookbook of the locale data you get for the Chinese (zh) locale — all the day names, month names, quarter names, eras, and every date/time/datetime format, with actual example output so you can see exactly what your strings are gonna look like. no cap, it's a reference sheet, and it ate. 🎀

✨ NAME ✨

DateTime::Locale::zh — locale data examples for the Chinese (zh) locale 🦋

🌸 DESCRIPTION 🌸

this pod file is a whole tour of the locale data available for the Chinese locale. it's giving "show, don't tell" — every chunk below is the actual data, laid out so you can vibe-check it. 💅

🗓️ Days — the whole week, served

Wide (format)

星期一
星期二
星期三
星期四
星期五
星期六
星期日

Abbreviated (format)

周一
周二
周三
周四
周五
周六
周日

Narrow (format)

一
二
三
四
五
六
日

Wide (stand-alone)

星期一
星期二
星期三
星期四
星期五
星期六
星期日

Abbreviated (stand-alone)

周一
周二
周三
周四
周五
周六
周日

Narrow (stand-alone)

一
二
三
四
五
六
日

🌙 Months — all twelve, iconic

Wide (format)

一月
二月
三月
四月
五月
六月
七月
八月
九月
十月
十一月
十二月

Abbreviated (format)

1月
2月
3月
4月
5月
6月
7月
8月
9月
10月
11月
12月

Narrow (format)

1
2
3
4
5
6
7
8
9
10
11
12

Wide (stand-alone)

一月
二月
三月
四月
五月
六月
七月
八月
九月
十月
十一月
十二月

Abbreviated (stand-alone)

1月
2月
3月
4月
5月
6月
7月
8月
9月
10月
11月
12月

Narrow (stand-alone)

1
2
3
4
5
6
7
8
9
10
11
12

🧚 Quarters — four of them, all main characters

Wide (format)

第一季度
第二季度
第三季度
第四季度

Abbreviated (format)

1季度
2季度
3季度
4季度

Narrow (format)

1
2
3
4

Wide (stand-alone)

第一季度
第二季度
第三季度
第四季度

Abbreviated (stand-alone)

1季度
2季度
3季度
4季度

Narrow (stand-alone)

1
2
3
4

👑 Eras — bc and ad, but make it Chinese

Wide (format)

公元前
公元

Abbreviated (format)

公元前
公元

Narrow (format)

公元前
公元

📅 Date Formats — every length, lowkey obsessed

Full

2008-02-05T18:30:30 = 2008年2月5日星期二
1995-12-22T09:05:02 = 1995年12月22日星期五
-0010-09-15T04:44:23 = -10年9月15日星期六

Long

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

Medium

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

Short

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

⏰ Time Formats — clock stuff, slay

Full

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

Long

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

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 — date PLUS time, the collab we deserved

Full

2008-02-05T18:30:30 = 2008年2月5日星期二 UTC 18:30:30
1995-12-22T09:05:02 = 1995年12月22日星期五 UTC 09:05:02
-0010-09-15T04:44:23 = -10年9月15日星期六 UTC 04:44:23

Long

2008-02-05T18:30:30 = 2008年2月5日 UTC 18:30:30
1995-12-22T09:05:02 = 1995年12月22日 UTC 09:05:02
-0010-09-15T04:44:23 = -10年9月15日 UTC 04:44:23

Medium

2008-02-05T18:30:30 = 2008年2月5日 18:30:30
1995-12-22T09:05:02 = 1995年12月22日 09:05:02
-0010-09-15T04:44:23 = -10年9月15日 04:44:23

Short

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

🎀 Available Formats — the full menu, iykyk

each one's got a name and the pattern it's built from, so you know exactly which one to reach for. 🫶

Bh (Bh时)

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

Bhm (Bh:mm)

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

Bhms (Bh:mm:ss)

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

E (ccc)

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

EBhm (EBh:mm)

2008-02-05T18:30:30 = 周二B6:30
1995-12-22T09:05:02 = 周五B9:05
-0010-09-15T04:44:23 = 周六B4:44

EBhms (EBh:mm:ss)

2008-02-05T18:30:30 = 周二B6:30:30
1995-12-22T09:05:02 = 周五B9:05:02
-0010-09-15T04:44:23 = 周六B4:44:23

EHm (EHH:mm)

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

EHms (EHH: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 (d日E)

2008-02-05T18:30:30 = 5日周二
1995-12-22T09:05:02 = 22日周五
-0010-09-15T04:44:23 = 15日周六

Ehm (Eah:mm)

2008-02-05T18:30:30 = 周二下午6:30
1995-12-22T09:05:02 = 周五上午9:05
-0010-09-15T04:44:23 = 周六上午4:44

Ehms (Eah:mm:ss)

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 (Gy年)

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

GyMMM (Gy年M月)

2008-02-05T18:30:30 = 公元2008年2月
1995-12-22T09:05:02 = 公元1995年12月
-0010-09-15T04:44:23 = 公元前-10年9月

GyMMMEd (Gy年M月d日E)

2008-02-05T18:30:30 = 公元2008年2月5日周二
1995-12-22T09:05:02 = 公元1995年12月22日周五
-0010-09-15T04:44:23 = 公元前-10年9月15日周六

GyMMMd (Gy年M月d日)

2008-02-05T18:30:30 = 公元2008年2月5日
1995-12-22T09:05:02 = 公元1995年12月22日
-0010-09-15T04:44:23 = 公元前-10年9月15日

GyMd (GGGGG 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

H (H时)

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

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

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

Hmv (v HH:mm)

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

M (M月)

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

MEd (M/dE)

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

MMM (LLL)

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

MMMEd (M月d日E)

2008-02-05T18:30:30 = 2月5日周二
1995-12-22T09:05:02 = 12月22日周五
-0010-09-15T04:44:23 = 9月15日周六

MMMMW-count-other (MMMM第W周)

2008-02-05T18:30:30 = 二月第1周
1995-12-22T09:05:02 = 十二月第3周
-0010-09-15T04:44:23 = 九月第2周

MMMMd (M月d日)

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

MMMd (M月d日)

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

MMdd (MM/dd)

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

2008-02-05T18:30:30 = 下午6时
1995-12-22T09:05:02 = 上午9时
-0010-09-15T04:44:23 = 上午4时

hm (ah:mm)

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

hms (ah:mm:ss)

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 (v ah:mm:ss)

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

hmv (v ah:mm)

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

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/M)

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

yMEEEEd (y年M月d日EEEE)

2008-02-05T18:30:30 = 2008年2月5日星期二
1995-12-22T09:05:02 = 1995年12月22日星期五
-0010-09-15T04:44:23 = -10年9月15日星期六

yMEd (y/M/dE)

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

yMM (y年M月)

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

yMMM (y年M月)

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

yMMMEd (y年M月d日E)

bestie the list keeps going — more formats are queued up in the next part 💅✨
2008-02-05T18:30:30 = 2008年2月5日周二
1995-12-22T09:05:02 = 1995年12月22日周五
-0010-09-15T04:44:23 = -10年9月15日周六

okay so that was one pattern, and we're still going — there are more format names coming, all formatted for zh, all iconic. 💅

yMMMM (y年M月)

month-and-year only, no day, she's lowkey mysterious:

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

yMMMd (y年M月d日)

the classic "year month day" moment, fr fr the main character of date formats:

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

yMd (y/M/d)

slashes! very spreadsheet-chic:

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

yQQQ (y年第Q季度)

quarter energy 🌸 — she tells you which quarter, not just which month:

2008-02-05T18:30:30 = 2008年第1季度
1995-12-22T09:05:02 = 1995年第4季度
-0010-09-15T04:44:23 = -10年第3季度

yQQQQ (y年第Q季度)

same string, same output — yes bestie, yQQQ and yQQQQ both render the exact same thing here. that's not a typo, it's just how zh does it:

2008-02-05T18:30:30 = 2008年第1季度
1995-12-22T09:05:02 = 1995年第4季度
-0010-09-15T04:44:23 = -10年第3季度

yw-count-other (Y年第w周)

week-number realness 🗓️:

2008-02-05T18:30:30 = 2008年第6周
1995-12-22T09:05:02 = 1995年第51周
-0010-09-15T04:44:23 = -10年第37周

🌈 MISCELLANEOUS 🌈

the little settings that tell you how this locale lives:

  • Prefers 24 hour time? Yes. no AM/PM shenanigans here, we're doing 18:30:30 and we're normal about it. 🕕
  • Local first day of the week — 1 (星期一). monday is the first day of the week for this locale, so adjust your calendars accordingly bestie 📅

✨ STRFTIME PATTERNS ✨

these are the classic strftime-style format strings, with their parenthesized patterns and their outputs. keep these exact, iykyk — they're literal:

  • %c (%a %b %e %H:%M:%S %Y) — date time format
2008-02-05T18:30:30 = 周二 2月  5 18:30:30 2008
1995-12-22T09:05:02 = 周五 12月 22 09:05:02 1995
-0010-09-15T04:44:23 = 周六 9月 15 04:44:23 -10

(and yes, that double space after 2月 is intentional — %e is space-padded, she's quirky like that 💀)

  • %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 🫶

like the original says, plainly and simply: See DateTime::Locale. that's the whole support section, she's a woman of few words and honestly? respect. 👑

aaaand that's the whole page, bestie 💖 it's DateTime::Locale::zh, from perl v5.42.0, dated 2024-12-12, and it ate. no cap. now go format some dates in Chinese and slay 🎀🦋✨

📦 where this page comes from