blob: 187d766d53cd78d81a1ce8490d3229503dbc5a1b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
---
title: Intl.RelativeTimeFormat.prototype.resolvedOptions()
slug: >-
Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat/resolvedOptions
tags:
- Internationalization
- Intl
- JavaScript
- Méthode
- Prototype
- Reference
- i18n
translation_of: >-
Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat/resolvedOptions
original_slug: >-
Web/JavaScript/Reference/Objets_globaux/Intl/RelativeTimeFormat/resolvedOptions
---
{{JSRef}}
La méthode **`Intl.RelativeTimeFormat.prototype.resolvedOptions()`** renvoie un nouvel objet dont les propriétés reflètent les options de format et de locale pour les valeurs temporelles relatives, calculées pendant l'initialisation de l'objet {{jsxref("RelativeTimeFormat")}}.
{{EmbedInteractiveExample("pages/js/intl-relativetimeformat-prototype-resolvedoptions.html")}}
## Syntaxe
relativeTimeFormat.resolvedOptions()
### Valeur de retour
Un nouvel objet dont les propriétés reflètent les options de locale et de formatage calculées lors de l'initialisation de l'objet {{jsxref("RelativeTimeFormat")}}.
## Description
L'objet renvoyé par cette méthode possèdera les propriétés suivantes :
- `locale`
- : La balise de langue BCP 47 qui est réellement utilisée. Si des extensions Unicode étaient fournies avec la balise d'origine et sont supportées pour la locale utilisée, les paires de clés-valeurs seront incluses dans `locale`.
- `style`
- : La longueur du message internationalisé. Les valeurs possibles sont :
- `"long"` : la valeur par défaut, peu concise (par exemple `in 1 month`)
- `"short"` : une valeur plus courte (par exemple `in 1 mo.`),
- `"narrow"` : une valeur encore plus courte (pouvant être ambigüe selon les locales) (par exemple `in 1 mo.`). Les styles `narrow` et `short` peuvent être similaires voire identiques pour certaines locales.
- `numeric`
- : Le format du message produit. Les valeurs possibles sont :
- `"always"` : la valeur par défaut (par exemple `1 day ago`),
- `"auto"` : cette valeur indique qu'il n'est pas nécessaire d'utiliser de valeur numérique dans le message produit (par exemple `yesterday`).
- `numberingSystem`
- : La valeur demandée pour la clé d'extension Unicode `"nu"` ou la valeur remplie par défaut.
## Exemples
```js
var de = new Intl.RelativeTimeFormat('de-DE');
var usedOptions = de.resolvedOptions();
usedOptions.locale; // "de-DE"
usedOptions.style; // "long"
usedOptions.numeric; // "always"
usedOptions.numberingSystem; // "latn"
```
## Spécifications
| Spécification | État | Commentaires |
| ------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ------------ |
| | | |
| [Proposition pour `Intl.RelativeTime`](https://tc39.github.io/proposal-intl-relative-time/#sec-intl.relativetimeformat.prototype.resolvedoptions) | Proposition de niveau 3 | |
## Compatibilité des navigateurs
{{Compat("javascript.builtins.Intl.RelativeTimeFormat.resolvedOptions")}}
## Voir aussi
- {{jsxref("RelativeTimeFormat", "Intl.RelativeTimeFormat")}}
|
