Skip to content

Commit ed5c716

Browse files
authored
Editorial: Document DurationFormat in summary sections (#966)
1 parent d097048 commit ed5c716

File tree

4 files changed

+18
-2
lines changed

4 files changed

+18
-2
lines changed

spec/annexes.html

+11
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,17 @@ <h1>Implementation Dependent Behaviour</h1>
8585
</li>
8686
</ul>
8787
</li>
88+
<li>
89+
In DurationFormat:
90+
<ul>
91+
<li>
92+
The set of supported *"nu"* key values (numbering systems) per locale (<emu-xref href="#sec-Intl.DurationFormat-internal-slots"></emu-xref>)
93+
</li>
94+
<li>
95+
The digital formatting configuration (use of two-digit hours with style *"numeric"* and separators for numeric hours, minutes, and seconds) per locale (<emu-xref href="#sec-Intl.DurationFormat-internal-slots"></emu-xref>)
96+
</li>
97+
</ul>
98+
</li>
8899
<li>
89100
In ListFormat:
90101
<ul>

spec/conventions.html

+5
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,11 @@ <h1>Well-Known Intrinsic Objects</h1>
6161
<td>`Intl.DisplayNames`</td>
6262
<td>The `Intl.DisplayNames` constructor (<emu-xref href="#sec-intl-displaynames-constructor"></emu-xref>)</td>
6363
</tr>
64+
<tr>
65+
<td>%Intl.DurationFormat%</td>
66+
<td>`Intl.DurationFormat`</td>
67+
<td>The `Intl.DurationFormat` constructor (<emu-xref href="#sec-intl-durationformat-constructor"></emu-xref>)</td>
68+
</tr>
6469
<tr>
6570
<td>%Intl.ListFormat%</td>
6671
<td>`Intl.ListFormat`</td>

spec/durationformat.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ <h1>Intl.DurationFormat ( [ _locales_ [ , _options_ ] ] )</h1>
1919
1. Let _matcher_ be ? GetOption(_options_, *"localeMatcher"*, ~string~, « *"lookup"*, *"best fit"* », *"best fit"*).
2020
1. Let _numberingSystem_ be ? GetOption(_options_, *"numberingSystem"*, ~string~, ~empty~, *undefined*).
2121
1. If _numberingSystem_ is not *undefined*, then
22-
1. If _numberingSystem_ does not match the Unicode Locale Identifier `type` nonterminal, throw a *RangeError* exception.
22+
1. If _numberingSystem_ cannot be matched by the <code>type</code> Unicode locale nonterminal, throw a *RangeError* exception.
2323
1. Let _opt_ be the Record { [[localeMatcher]]: _matcher_, [[nu]]: _numberingSystem_ }.
2424
1. Let _r_ be ResolveLocale(%Intl.DurationFormat%.[[AvailableLocales]], _requestedLocales_, _opt_, %Intl.DurationFormat%.[[RelevantExtensionKeys]], %Intl.DurationFormat%.[[LocaleData]]).
2525
1. Set _durationFormat_.[[Locale]] to _r_.[[Locale]].

spec/overview.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ <h1>API Overview</h1>
2323
This specification is designed to complement the ECMAScript 2025 Language Specification by providing key language-sensitive functionality. The API can be added to an implementation of the ECMAScript 2025 Language Specification (ECMA-262 16<sup>th</sup> Edition, or successor) in whole or in part. This specification introduces new language values observable to ECMAScript code (such as the value of a [[FallbackSymbol]] internal slot and the set of values transitively reachable from %Intl% by <emu-xref href="#sec-property-accessors">property access</emu-xref>), and also refines the definition of some functions specified in ECMA-262 (as described below). Neither category prohibits behaviour that is otherwise permitted for values and interfaces defined in ECMA-262, in order to support adoption of this specification by any implementation of ECMA-262.
2424
</p>
2525
<p>
26-
This specification provides several key pieces of language-sensitive functionality that are required in most applications: String comparison (collation), number formatting, date and time formatting, relative time formatting, display names, list formatting, locale selection and operation, pluralization rules, case conversion, and text segmentation. While the ECMAScript 2025 Language Specification provides functions for this basic functionality (on <emu-xref href="#sec-array.prototype">Array.prototype</emu-xref>: `toLocaleString`; on <emu-xref href="#sec-string.prototype">String.prototype</emu-xref>: `localeCompare`, `toLocaleLowerCase`, `toLocaleUpperCase`; on <emu-xref href="#sec-number.prototype">Number.prototype</emu-xref>: `toLocaleString`; on <emu-xref href="#sec-date.prototype">Date.prototype</emu-xref>: `toLocaleString`, `toLocaleDateString`, and `toLocaleTimeString`), their actual behaviour is left largely implemenation-defined. This specification provides additional functionality, control over the language and over details of the behaviour to be used, and a more complete specification of required functionality.
26+
This specification provides several key pieces of language-sensitive functionality that are required in most applications: locale selection and inspection, string comparison (collation) and case conversion, pluralization rules, text segmentation, and formatting of numbers, absolute and relative dates and times, durations, and lists. While the ECMAScript 2025 Language Specification provides functions for this basic functionality (on <emu-xref href="#sec-array.prototype">Array.prototype</emu-xref>: `toLocaleString`; on <emu-xref href="#sec-string.prototype">String.prototype</emu-xref>: `localeCompare`, `toLocaleLowerCase`, `toLocaleUpperCase`; on <emu-xref href="#sec-number.prototype">Number.prototype</emu-xref>: `toLocaleString`; on <emu-xref href="#sec-date.prototype">Date.prototype</emu-xref>: `toLocaleString`, `toLocaleDateString`, and `toLocaleTimeString`), their actual behaviour is left largely implemenation-defined. This specification provides additional functionality, control over the language and over details of the behaviour to be used, and a more complete specification of required functionality.
2727
</p>
2828

2929
<p>Applications can use the API in two ways:</p>

0 commit comments

Comments
 (0)