currency-proposal-fr
Currency
currency est un microformat simple pour baliser des montants en monnaie, comme les prix de produits/services ou des faits financiers.
Introduction
Les montants d'argent sont l'un des contenus les plus répandus sur le Web, mais le manque de représentation sans ambiguité de la monnaie dans laquelle ils sont présentés, ou la date à laquelle ils sont apparentés, rendent difficiles les comparaisons et correspondances des offres en ligne.
Remarques
Cette proposition a été écrite en se fondant sur les contributions de plusieurs membres de la communauté. Les idées du brainstorming original et la proposition de paille peuvent être visualisées sur currency-brainstorming-fr et currency-brainstorming#Andy_Mabbett
Etendue
Cette proposition limite son champ aux :
- montants d'argent exprimé dans des pièces et billets officiellement sortis. Ceci veut dire qu'il ne supporte pas les montants d'argent exprimés en termes de commodités ou autres actifs liquides.
- les montants d'argent exprimés en une unité. Ceci veut dire qu'il ne peut pas supporter des montants composés comme "39 Euros et 99 Centimes".
Caractéristiques
- Réutilisation du largement utilisé ISO 4217 pour l'encodage sans ambiguité des types de monnaies : assure l'interopérabilité avec beaucoup de standards industriels existants et émergents comme IFX, ACORD, XBRL ou UBL.
- Définit une fois la monnaie, utilisez la partout : permet aux unités de monnaie d'être définies une fois et ensuite mises en référence, au lieu de définir localement chaque montant de monnaie, ceci aboutissant à une facilité de lisibilité tant pour les utilisateurs humains et leurs agents utilisateurs.
- CTimestamping : les montants d'argent ont une date en option qui permet aux agents utilisateurs de traduire un chiffre historique à un montant équivalent actualisé.
Nom de classe racine
Le nom de classe racine pour un montant en argent est money
.
Liste de Propriété
- Obligatoire
amount
: peut baliser une valeur numérique lisible par une machine avec un élémentspan
ou une chaîne de valeur avec unabbr
dont l'attributtitle
contient la valeur numérique lisible par une marchine (Voir abbr-design-pattern). - En option
currency
, ou référence à une monnaie (Voir include-pattern). Doit baliser un code compatible ISO 4217 out utilise le abbr-design-pattern pour fournir l'équivalent de la valeur ISO 4217 lisible par une machine vers la valeur balisée lisible par un humain. - En option
unit
, ou référence vers une unité de la monnaie (Voir include-pattern), par exemple un "dollar" ou "cent". Cette proposition ne spécifie pas comment l'unité doit être balisée. Ceci est le coeur des microformats measure. Quand elle n'est pas présente, l'unité est supposée cella par défaut pour la monnaie actuelle. Par exemple, "Dollar" pour la devise aux USA. - En option
date
suivant le datetime-design-pattern, spécifie la date qui doit être utilisée pour évaluer la valeur de l'unité de monnaie utilisée.
Exemples
Simple in-line example with local definition of the currency unit: $39.99
<span class="money"><abbr class="currency" title="USD">$</abbr><span class="amount">39.99</span></span>
Text representation of the amount: Thirty-nine Dollars
<span class="money"><abbr class="amount" title="39">Thirty-nine</abbr> <abbr class="currency" title="USD">Dollars</abbr></span>
Example using the unit
class: 99¢
<span class="money"><span class="amount">99</span><abbr class="unit">¢</abbr><abbr class="currency" title="USD"></abbr></span>
Table example with global definition of the currency:
<table> <tr><th>Price in <abbr id="u1" class="currency" title="USD">US$</abbr></th></tr> <tr><td><div class="money">39.99<a href="#u1" class="include"></a></div></td></tr> </table>