19 | The abstract operation InitializeRelativeTimeFormat accepts the arguments relativeTimeFormat (which must be an object), locales, and options. It initializes relativeTimeFormat as a RelativeTimeFormat object. It performas the following steps: 20 | 21 |
22 | 23 |"localeMatcher", "string", «"lookup", "best fit"», "best fit")."style", "string", «"long", "short", "narrow"», "long")."useGrouping", "minimumIntegerDigits", "style", "cardinal").
31 | When the
"second", "minute", "hour", "day", "week", "month", "quarter", "year", throw a RangeError exception."past"."future".
43 | The MakePartsList abstract operation is called with arguments parts, a pattern String, unit, a String, and value a String.
44 |
45 |
MakePartsList("AA{0}BB", "hour", "15") --<
49 |
50 | Output (List of Records):
51 | [
52 | {type: 'literal', value: 'AA'},
53 | {type: 'hour', value: '15'},
54 | {type: 'literal', value: 'BB'},
55 | ]
56 |
57 |
58 | "length")."literal", [[Value]]: literal } as a new element of the list result."0"."literal", [[Value]]: literal } as a new element of the list result.66 | The FormatRelativeTime abstract operation is called with arguments relativeTimeFormat (which must be an object initialized as a RelativeTimeFormat), value (which must be a Number value), and unit (which must be a String denoting the value unit) and performs the following steps: 67 | 68 |
69 | 70 |79 |
80 | 81 |
90 | The RelativeTimeFormat constructor is a standard built-in property of the Intl object. Behaviour common to all service constructor properties of the Intl object is specified in
98 | When the
111 | The Intl.RelativeTimeFormat constructor has the following properties: 112 | 113 |
114 | 115 |
119 | The value of
123 | This property has the attributes { [[Writable]]:
132 | When the
140 | The value of the
149 | The value of the [[AvailableLocales]] internal slot is implementation defined within the constraints described in
154 | The value of the [[RelevantExtensionKeys]] internal slot is []. 155 | 156 |
157 | 158 |
164 | The value of the [[LocaleData]] internal slot is implementation defined within the constraints described in
"second", "minute", "hour", "day", "week", "month", "quarter" and "year". Additional property keys may exist with the previous names concatenated with the strings "-narrow" or "-short". The values corresponding to these property keys are objects which contain these two categories of properties:"future" and "past" properties, which are objects with a property for each of the [[PluralCategories]] in the Locale. The value corresponding to those properties is a pattern which may contain "{0}" to be replaced by a formatted number.187 | The Intl.RelativeTimeFormat prototype object is itself an ordinary object. %RelativeTimeFormatPrototype% is not an Intl.RelativeTimeFormat instance and does not have an [[InitializedRelatimveTimeFormat]] internal slot or any of the other internal slots of Intl.RelativeTimeFormat instance objects. 188 | 189 |
190 |
191 | In the following descriptions of functions that are properties or [[Get]] attributes of properties of
199 | The initial value of
208 | The initial value of the @@toStringTag property is the string value "Object".
209 |
210 |
212 | This property has the attributes { [[Writable]]:
221 | When the
233 | When the
245 | This function provides access to the locale and formatting options computed during initialization of the object. 246 | 247 |
248 |
249 | The function returns a new object whose properties and attributes are set as if constructed by an object literal assigning to each of the following properties the value of the corresponding internal slot of this RelativeTimeFormat object (see
259 | Intl.RelativeTimeFormat instances inherit properties from
264 | Intl.RelativeTimeFormat instances and other objects that have been successfully initialized as a RelativeTimeFormat have [[InitializedIntlObject]] and [[InitializedRelativeTimeFormat]] internal slots whose values are
269 | Objects that have been successfully initialized as a RelativeTimeFormat object also have several internal slots that are computed by the constructor: 270 | 271 |
272 | 273 |"long", "short", or "narrow", identifying the relative time format style used.8 | title: Intl.RelativeTimeFormat Spec Proposal 9 | stage: 3 10 | contributors: Caridy Patiño, Eric Ferraiuolo, Zibi Braniecki, Rafael Xavier, Daniel Ehrenberg 11 | status: draft 12 | copyright: false 13 | location: https://rawgit.com/tc39/proposal-intl-relative-time/master/index.html 14 |15 |
12 | The abstract operation InitializeRelativeTimeFormat accepts the arguments _relativeTimeFormat_ (which must be an object), _locales_, and _options_. It initializes _relativeTimeFormat_ as a RelativeTimeFormat object. 13 |
14 |The following steps are taken:
15 | 16 |69 | When the FormatRelativeTime abstract operation is called with arguments _relativeTimeFormat_, _value_, and _unit_ it returns a String value representing _value_ (which must be a Number value) according to the effective locale and the formatting options of _relativeTimeFormat_. 70 |
71 | 72 |
112 | The MakePartsList abstract operation is called with arguments _pattern_, a pattern String, _unit_, a String, and _parts_, a List of Records representing a formatted Number.
113 |
116 | MakePartsList("AA{0}BB", "hour", « { [[Type]]: "integer", [[Value]]: "15" } » )
117 |
118 | Output (List of Records):
119 | «
120 | { [[Type]]: "literal", [[Value]]: "AA"},
121 | { [[Type]]: "integer", [[Value]]: "15", [[Unit]]: "hour"},
122 | { [[Type]]: "literal", [[Value]]: "BB"}
123 | »
124 |
125 |
144 | The FormatRelativeTime abstract operation is called with arguments _relativeTimeFormat_ (which must be an object initialized as a RelativeTimeFormat), _value_ (which must be a Number value), and _unit_ (which must be a String denoting the value unit) and performs the following steps: 145 |
146 | 147 |160 | The FormatRelativeTimeToParts abstract operation is called with arguments _relativeTimeFormat_ (which must be an object initialized as a RelativeTimeFormat), _value_ (which must be a Number value), and _unit_ (which must be a String denoting the value unit) and performs the following steps: 161 |
162 | 163 |
184 | The RelativeTimeFormat constructor is the %RelativeTimeFormat% intrinsic object and a standard built-in property of the Intl object. Behaviour common to all service constructor properties of the Intl object is specified in
191 | When the *Intl.RelativeTimeFormat* function is called with optional arguments the following steps are taken: 192 |
193 | 194 |206 | The Intl.RelativeTimeFormat constructor has the following properties: 207 |
208 | 209 |213 | The value of `Intl.RelativeTimeFormat.prototype` is %RelativeTimeFormatPrototype%. 214 |
215 |216 | This property has the attributes { [[Writable]]: *false*, [[Enumerable]]: *false*, [[Configurable]]: *false* }. 217 |
218 |224 | When the `supportedLocalesOf` method of %RelativeTimeFormat% is called, the following steps are taken: 225 |
226 | 227 |
238 | The value of the [[AvailableLocales]] internal slot is implementation defined within the constraints described in
242 | The value of the [[RelevantExtensionKeys]] internal slot is « `"nu"` ». 243 |
244 | 245 |
250 | The value of the [[LocaleData]] internal slot is implementation defined within the constraints described in
275 | The Intl.RelativeTimeFormat prototype object is itself an ordinary object. %RelativeTimeFormatPrototype% is not an Intl.RelativeTimeFormat instance and does not have an [[InitializedRelativeTimeFormat]] internal slot or any of the other internal slots of Intl.RelativeTimeFormat instance objects. 276 |
277 | 278 |282 | The initial value of `Intl.RelativeTimeFormat.prototype.constructor` is %RelativeTimeFormat%. 283 |
284 |290 | The initial value of the @@toStringTag property is the string value `"Intl.RelativeTimeFormat"`. 291 |
292 |293 | This property has the attributes { [[Writable]]: *false*, [[Enumerable]]: *false*, [[Configurable]]: *true* }. 294 |
295 |301 | When the `format` method is called with arguments _value_ and _unit_, the following steps are taken: 302 |
303 | 304 |318 | When the `formatToParts` method is called with arguments _value_ and _unit_, the following steps are taken: 319 |
320 | 321 |335 | This function provides access to the locale and options computed during initialization of the object. 336 |
337 | 338 || Internal Slot | 357 |Property | 358 |
|---|---|
| [[Locale]] | 362 |`"locale"` | 363 |
| [[Style]] | 366 |`"style"` | 367 |
| [[Numeric]] | 370 |`"numeric"` | 371 |
| [[NumberingSystem]] | 374 |`"numberingSystem"` | 375 |
385 | Intl.RelativeTimeFormat instances are ordinary objects that inherit properties from %RelativeTimeFormatPrototype%. 386 |
387 | 388 |389 | Intl.RelativeTimeFormat instances have an [[InitializedRelativeTimeFormat]] internal slot. 390 |
391 | 392 |393 | Intl.RelativeTimeFormat instances also have several internal slots that are computed by the constructor: 394 |
395 | 396 |