Каков стандарт форматирования валютных значений в JSON?

Ответ 1

Я не знаю, является ли это лучшим решением, но теперь я пытаюсь просто передать значения как строки, не форматированные за исключением десятичной точки, например:

"amount": "1234.56"

Приложение может легко проанализировать это (и преобразовать его в double, BigDecimal, int или любой другой метод, который разработчик приложений лучше всего подходит для арифметики с плавающей запятой). Приложение будет отвечать за форматирование значения для отображения в соответствии с языком и валютой.

В этом формате могут учитываться другие значения валюты: сильно завышенные большие числа, цифры с тремя цифрами после десятичной точки, цифры без дробных значений и т.д.

Конечно, это предполагает, что приложение уже знает используемый язык и валюту (от другого вызова, настройки приложения или значений локального устройства). Если эти требования должны быть указаны для каждого вызова, другой вариант:

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

У меня возникает соблазн перевернуть их в один объект JSON, но канал JSON может иметь несколько сумм для разных целей, и тогда вам нужно будет только указать параметры валюты один раз. Разумеется, если это может измениться для каждой указанной суммы, тогда было бы лучше всего их инкапсулировать, например:

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

Другим спорным подходом является предоставление сервером необработанного количества и отформатированной суммы. (Если это так, я бы предложил инкапсулировать его как объект, вместо того, чтобы иметь несколько свойств в фиде, которые все определяют одну и ту же концепцию):

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

Здесь большая часть работы выгружается на сервер. Он также обеспечивает согласованность между различными платформами и приложениями в том, как отображаются числа, при этом обеспечивая легко анализируемое значение для условного тестирования и т.п.

Однако это оставляет проблему - что делать, если приложение должно выполнять вычисления, а затем показывать результаты пользователю? По-прежнему необходимо форматировать номер для отображения. Мог бы также пойти с первым примером в верхней части этого ответа и дать приложению контроль над форматированием.

Это мои мысли, по крайней мере. Я не смог найти каких-либо твердых передовых методов или исследований в этой области, поэтому я приветствую лучшие решения или потенциальные проблемы, о которых я не указал.

Ответ 2

AFAIK, в JSON нет стандарта "валюты" - это стандарт, основанный на рудиментарных типах. Вещи, которые вы, возможно, захотите рассмотреть, это то, что в некоторых валютах нет десятичной части (Guinean Franc, Indonesian Rupiah), а некоторые могут быть разделены на тысячные (Bahraini Dinar) - следовательно, вы не хотите брать два десятичных знака. Для иранских Real $2million не собирается вас далеко, так что я ожидаю, что вам придется иметь дело с двойниками не целыми числами. Если вы ищете общую международную модель, вам понадобится код валюты, так как страны с гиперинфляцией часто меняют валюты каждый год из двух, чтобы разделить значение на 1 000 000 (или 100 млн.). Я думаю, что исторически Бразилия и Иран сделали это.

Если вам нужна ссылка для кодов валют (и немного другой полезной информации), посмотрите здесь: https://gist.github.com/Fluidbyte/2973986

Ответ 3

ВКЛ Dev Portal - Руководство по API - Валюты вы можете найти интересные предложения:

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

Немного сложнее создать и форматировать, чем просто строку, но я считаю, что это самый чистый и осмысленный способ ее достижения:

• количество и валюта разоблачения
• использовать number JSON тип

Здесь формат JSON предложил: 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"
    ]
}

Другие вопросы, связанные с форматом валюты, указывали правильно или неправильно, что практика намного больше похожа на строку с базовыми единицами:

{
    "price": "40.0"
}

Ответ 4

Количество денег должно быть представлено в виде строки.

Идея использования строки состоит в том, что любой клиент, который использует json, должен анализировать его в десятичный тип, такой как BigDecimal чтобы избежать неточностей с плавающей запятой.

Однако это будет иметь смысл только в том случае, если какая-либо часть системы также избежит плавающей запятой. Даже если бэкэнд только передает данные и не выполняет никаких вычислений, использование плавающей запятой в конечном итоге приведет к тому, что вы видите (в программе) не то, что вы получаете (на json).

И, предполагая, что источником является база данных, важно, чтобы данные хранились с правильным типом. Если данные уже сохранены как числа с плавающей запятой, то любое последующее преобразование или преобразование будет бессмысленным, так как это технически приведет к неточности.