Quelle est la norme pour formater les valeurs de devise dans JSON?

je ne sais pas si c'est la meilleure solution, mais ce que j'essaie maintenant est de transmettre des valeurs comme des chaînes de caractères non formaté à l'exception d'une virgule, comme ceci:

"amount": "1234.56"

l'application pourrait facilement analyser cela (et le convertir en double, BigDecimal, int, ou n'importe quelle méthode que le développeur d'application sent le meilleur pour l'arithmétique flottante). L'application serait responsable du formatage de la valeur pour l'affichage selon la locale et la devise.

ce format pourrait accommoder d'autres les valeurs de devise, si les grands nombres fortement gonflés, les nombres avec trois chiffres après le point décimal, les nombres sans valeurs fractionnaires du tout, etc.

bien sûr, cela supposerait que l'application connaît déjà la localisation et la monnaie utilisée (à partir d'un autre appel, d'un paramètre d'application, ou de valeurs de périphérique local). Si ceux qui ont besoin d'être précisées par appel, une autre option serait:

"amount": "1234.56",
"currency": "USD",
"locale": "en_US"

je suis tenté de les rouler dans un objet JSON, mais un flux JSON peut avoir plusieurs valeurs pour différentes finalités, et il ne serait alors nécessaire de spécifier les paramètres monétaires qu'une seule fois. Bien sûr, si cela peut varier pour chaque quantité énumérée, alors il serait préférable de les encapsuler ensemble, comme ceci:

{
"amount": "1234.56",
"currency": "USD",
"locale": "en_US"
}

une autre approche discutable consiste pour le serveur à fournir la quantité brute et la quantité formatée. (Si si, je vous suggère d'encapsulation comme un objet, au lieu d'avoir plusieurs propriétés dans un flux qui définissent tous le même concept):

{
"displayAmount":",234.56",
"calculationAmount":"1234.56"
}

Ici, plus de le travail est déchargé pour le serveur. Il assure également la cohérence entre les différentes plates-formes et applications dans la façon dont les nombres sont affichés, tout en fournissant une valeur facilement analysable pour les tests conditionnels et autres.

cependant, cela laisse un problème--que se passe-t-il si l'application doit effectuer des calculs et ensuite montrer les résultats à l'utilisateur? Il devra tout de même formater le numéro pour l'afficher. Pourrait tout aussi bien aller avec le premier exemple en haut de cette réponse et de donner l'app de contrôle sur le formatage.

ce sont mes pensées, au moins. J'ai été incapable de trouver des pratiques exemplaires ou des recherches solides dans ce domaine, alors je me réjouis de trouver de meilleures solutions ou des pièges potentiels que je n'ai pas mentionnés.

autant que je sache, il n'y a pas de "monnaie" standard en JSON - c'est un standard basé sur rudimentaires types. Les choses que vous pourriez considérer est que certaines devises n'ont pas une partie décimale (Franc guinéen, Rupiah indonésien) et certaines peuvent être divisées en millièmes (Dinar bahreïnien)- donc vous ne voulez pas assumer deux places décimales. Pour la réalité iranienne 2 millions de dollars ne va pas vous mener loin, donc je m'attendrais à ce que vous devez traiter avec des doubles pas des entiers. Si vous êtes à la recherche pour un international général modèle alors vous aurez besoin d'un code de devise car les pays avec l'hyperinflation changent souvent des devises chaque année de deux pour diviser la valeur par 1.000.000 (ou 100 millions). Historiquement, le Brésil et L'Iran ont tous deux fait cela, je pense.

Si vous avez besoin d'une référence pour les codes des monnaies (et un peu d'autres bonnes informations), puis prendre un coup d'oeil ici: https://gist.github.com/Fluidbyte/2973986

Dev Portail de l'API, les Directives sur les Monnaies vous pouvez trouver des suggestions intéressantes :

"price" : {
 "amount": 40,
 "currency": "EUR"
}

C'est un peu plus difficile à produire et format que juste une chaîne de caractères, mais j'ai l'impression que c'est le plus propre et de manière significative à atteindre :

1. découpler le montant et la devise
2. utiliser numberJSON tapez

voici le format JSON suggéré: https://pattern.yaas.io/v2/schema-monetary-amount.json

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "type": "object",
    "title": "Monetary Amount",
    "description":"Schema defining monetary amount in given currency.",
    "properties": {
        "amount": {
            "type": "number",
            "description": "The amount in the specified currency"
        },
        "currency": {
            "type": "string",
            "pattern": "^[a-zA-Z]{3}$",
            "description": "ISO 4217 currency code, e.g.: USD, EUR, CHF"
        }
    },
    "required": [
        "amount",
        "currency"
    ]
}

un Autre questions relatives au format de la devise fait remarquer à tort ou à raison, que la pratique ressemble beaucoup plus à une chaîne avec des unités de base:

{
    "price": "40.0"
}