Add a dayPeriod option to Intl.DateTimeFormat() method so the caller can format times such as "7 in the morning", "11 in the morning", "12 noon", "1 in the afternoon", "6 in the evening", "10 at night" (or in Chinese, "清晨7時", "上午11時", "中午12時", "下午1時" ,"下午6時" ,"晚上10時")

Motivation

This enhances Intl.DateTimeFormat() to match what is already possible in C++ and Java by calling ICU and ICU4J. Without this feature, developers need to either format the quarter in the server or ship a set of day period patterns and hour to day period mappings from the server to client to perform such task.

Demo

• https://github.com/tc39/ecma402/pull/346

Documentation

• https://tc39.es/ecma402/#table-datetimeformat-components
• https://tc39.es/ecma402/#sec-todatetimeoptions
• https://tc39.es/ecma402/#sec-intl.datetimeformat-internal-slots
• https://tc39.es/ecma402/#table-datetimeformat-rangepatternfields
• https://github.com/tc39/ecma402/pull/346

Specification

Public discussion

Status in Chromium

Blink components: Blink>JavaScript>Internationalization

Enabled by default (tracking bug) in:

• Chrome for desktop release 92
• Chrome for Android release 92
• Android WebView release 92

Consensus & Standardization

• Firefox: In development
• Edge: No signal
• Safari: In development
• Web Developers: Mixed signals

Owners

• ftang@chromium.org
• jshin@chromium.org

Intent to Prototype url

Comments

dayPeriod is already part of ECMA402 2021. We should launch this to match the standard. It was set to stage in m78 for more than 1.5 years already.

Search tags

Last updated on 2021-07-24