1 of 8

Update of Extend TimeZoneName Option Proposal in Stage 3

2 of 8

Motivation / Scope

Extend the timeZoneName option in Intl.DateTimeFormat object to support more formatted options.

3 of 8

History

  • Advanced to Stage 1 in TC39 2021-01 Meeting
  • ECMA402 2021-04 Monthly Meeting
    • Rname shortGMT/longGMT to shortOffset/longOffset
  • Advanced to Stage 2 in TC39 2021-04 Meeting
  • ECMA402 2021-05 Monthly Meeting
    • Rename shortWall/longWall to shortGeneric/longGeneric
  • Advanced to Stage 3 in TC39 2021-05 Meeting

4 of 8

Sample Usage in English Locale

d8> let timeZoneNames = ["short", "long", "shortOffset", "longOffset", "shortGeneric", "longGeneric"];

d8> timeZoneNames.forEach(function(timeZoneName) { print((new Date()).toLocaleTimeString("en", {timeZoneName}))});

9:27:14 AM PST

9:27:14 AM Pacific Standard Time

9:27:14 AM GMT-8

9:27:14 AM GMT-08:00

9:27:14 AM PT

9:27:14 AM Pacific Time

5 of 8

Sample Usage in Traditional Chinese Locale (zh-CN)

d8> let timeZoneNames = ["short", "long", "shortOffset", "longOffset", "shortGeneric", "longGeneric"];

d8> timeZoneNames.forEach(function(timeZoneName) { print((new Date()).toLocaleTimeString("zh-Hant", {timeZoneName}))});

上午9:27:27 [PST]

上午9:27:27 [太平洋標準時間]

上午9:27:27 [GMT-8]

上午9:27:27 [GMT-08:00]

上午9:27:27 [PT]

上午9:27:27 [太平洋時間]

6 of 8

Acknowledgement

I would like to thank the following delegates for supporting the development & deployment of this proposal

  • Stage 0 discussion within TG2 members: Jungshik Shin @jungshik, Zibi Braniecki @zbraniecki, Daniel Ehrenberg @littledan, Caridy Patiño @caridy, Rafael Xavier de Souza @rxaviers, Alolita Sharma @alolita, Philipp Dunkel @pipobscure
  • Strawman stage 0 - Steven R. Loomis @srl295 for
  • Stage 3 Reviewers: Philip Chimento @ptomato / Rick Button @rickbutton
  • Editor: Richard Gibson @gibson042 / Ujjwal Sharma @ryzokuken
  • Shane F. Carr @sffc and other TG2 members who participated in the TG2 meeting

Also special thanks to André Bargul @anba from Mozilla for his amazing review.

7 of 8

Stage 3 Activities

  • Chrome/v8:
    • Stage in Chrome m93
      • Behind the flag of harmony_intl_more_timezone
    • Plan to flip to ship in 2021Q3
    • See status page & issue tracker 11637
  • Mozilla: (91) 1710429
  • Safari: unclear
  • Test262: Need help, under feature tag “Intl.DateTimeFormat-extend-timezonename
  • MDN: Need help
  • Polyfills: Need help

8 of 8

Requesting the Committee

to help the development of test262, MDN, polyfills and to evangelize this new API