Поделиться через

Глобализируйте форматы даты, времени и чисел

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

Введение

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

Разные регионы и культуры используют разные форматы даты и времени. К ним относятся соглашения о порядке дня и месяца в дате, для разделения часов и минут во времени, а также для того, какие знаки препинания используются в качестве разделителя. Кроме того, даты могут формироваться в разных форматах: длинных ("среда, 28 марта 2012 г.") или коротких ("3/28/12"), которые зависят от культурных различий. И, конечно, имена и аббревиаты для дней недели и месяцев года отличаются между языками.

Вы можете просмотреть форматы, используемые для разных языков. Перейдите в раздел Параметры>Время и язык>Регион и язык, и щелкните Дополнительные параметры даты, времени и региона>Изменить формат даты, времени или чисел. На вкладке Форматы выберите язык из раскрывающегося списка Формат и просмотрите форматы в примерах.

В этом разделе используются термины "список языков профиля пользователя", "список языков манифеста приложения" и "список языков среды выполнения приложения". Дополнительные сведения о том, какие термины означают и как получить доступ к их значениям, см. в разделе "Общие сведения о языках профилей пользователей" и языках манифеста приложения.

Форматирование дат и времени для списка языков среды выполнения приложения

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

Если вам нужно отобразить даты или время самостоятельно, можно использовать класс DateTimeFormatter . По умолчанию DateTimeFormatter автоматически использует лучший формат даты и времени для списка языков среды выполнения приложения. Таким образом, приведенный ниже код форматирует заданный dateTime лучшим способом для этого списка. Например, предположим, что список языков манифеста приложения включает английский (США), который также является вашим значением по умолчанию и немецким (Германия). Если текущая дата — 6 ноября 2017 г., а список языков профиля пользователя содержит немецкий (Германия), то средство форматирования дает "06.11.2017". Если в списке языков профиля пользователя английский (США) стоит первым (или если он не содержит ни английского, ни немецкого), то форматтер выводит "11/6/2017" (поскольку "en-US" совпадает или используется по умолчанию).

    // Use the DateTimeFormatter class to display dates and times using basic formatters.

    var shortDateFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("shortdate");
    var shortTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("shorttime");

    var dateTimeToFormat = DateTime.Now;

    var shortDate = shortDateFormatter.Format(dateTimeToFormat);
    var shortTime = shortTimeFormatter.Format(dateTimeToFormat);

    var results = "Short Date: " + shortDate + "\n" +
                  "Short Time: " + shortTime;

Вы можете протестировать приведенный выше код на своем компьютере, как показано ниже.

Форматирование дат и времени для списка языков профиля пользователя

Помните, что по умолчанию DateTimeFormatter соответствует списку языков среды выполнения приложения. Таким образом, если вы отображаете строки, такие как "Дата: <дата>", то язык будет соответствовать формату даты.

Если по какой-либо причине вы хотите отформатировать даты и (или) время только в соответствии со списком языков профиля пользователя, вы можете сделать это с помощью кода, как показано ниже. Но если вы сделаете это, учтите, что пользователь может выбрать язык, на который в вашем приложении нет переведённых строк. Например, если ваше приложение не локализовано на немецком языке (Германия), но пользователь выбирает это в качестве предпочтительного языка, то это может привести к отображению, возможно, нечетных строк, таких как "Дата 06.11.2017".

    // Use the DateTimeFormatter class to display dates and times using basic formatters.

    var userLanguages = Windows.System.UserProfile.GlobalizationPreferences.Languages;

    var shortDateFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("shortdate", userLanguages);

    var results = "Short Date: " + shortDateFormatter.Format(DateTime.Now);

Форматирование чисел и валют соответствующим образом

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

В этом примере показано, как отображать валюты как для профиля пользователя, так и для конкретной валюты.

    // This scenario uses the CurrencyFormatter class to format a number as a currency.

    var userCurrency = Windows.System.UserProfile.GlobalizationPreferences.Currencies[0];

    var valueToBeFormatted = 12345.67;

    var userCurrencyFormatter = new Windows.Globalization.NumberFormatting.CurrencyFormatter(userCurrency);
    var userCurrencyValue = userCurrencyFormatter.Format(valueToBeFormatted);

    // Create a formatter initialized to a specific currency,
    // in this case US Dollar (specified as an ISO 4217 code) 
    // but with the default number formatting for the current user.
    var currencyFormatUSD = new Windows.Globalization.NumberFormatting.CurrencyFormatter("USD");
    var currencyValueUSD = currencyFormatUSD.Format(valueToBeFormatted);

    // Create a formatter initialized to a specific currency.
    // In this case it's the Euro with the default number formatting for France.
    var currencyFormatEuroFR = new Windows.Globalization.NumberFormatting.CurrencyFormatter("EUR", new[] { "fr-FR" }, "FR");
    var currencyValueEuroFR = currencyFormatEuroFR.Format(valueToBeFormatted);

    // Results for display.
    var results = "Fixed number (" + valueToBeFormatted + ")\n" +
                    "With user's default currency: " + userCurrencyValue + "\n" +
                    "Formatted US Dollar: " + currencyValueUSD + "\n" +
                    "Formatted Euro (fr-FR defaults): " + currencyValueEuroFR;

Вы можете протестировать приведенный выше код на своем компьютере, изменив страну или регион в разделе Параметры>Время и язык>Регион и язык>Страна или регион. Выберите страну или регион (возможно, Исландию) и снова запустите код.

Использование культурно подходящего календаря

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

Для того чтобы гарантировать использование предпочтительного формата календаря, вы можете воспользоваться стандартными элементами управления для календаря, даты и времени. Для более сложных задач, когда требуется работа непосредственно с операциями с календарными датами, Windows.Globalization предоставляет класс Calendar, который обеспечивает соответствующее представление календаря для заданной культуры, региона и типа календаря.

Форматирование номеров телефонов соответствующим образом

Номера телефонов форматируются по-разному в разных регионах. Количество цифр, группирование цифр и значение определенных частей номера телефона зависит от стран или регионов. Начиная с Windows 10 версии 1607, классы можно использовать в пространстве имен PhoneNumberFormatting для форматирования номеров телефонов соответствующим образом для текущего региона.

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

PhoneNumberFormatter форматирует строку цифр или PhoneNumberInfo для отображения, даже если строка цифр представляет собой частичный номер телефона. Вы можете использовать частичное форматирование числа, чтобы отформатировать его, когда пользователь вводит число.

В приведенном ниже примере показано, как использовать PhoneNumberFormatter для форматирования номера телефона при вводе. Каждый раз, когда текст изменяется в TextBox с именем phoneNumberInputTextBox, содержимое текстового поля форматируется с помощью текущей области по умолчанию и отображается в TextBlock с именем phoneNumberOutputTextBlock. Для демонстрационных целей строка также форматируется с помощью региона для Новой Зеландии и отображается в TextBlock с именем phoneNumberOutputTextBlockNZ.

    using Windows.Globalization.PhoneNumberFormatting;

    PhoneNumberFormatter currentFormatter, NZFormatter;

    public MainPage()
    {
        this.InitializeComponent();

        // Use the default formatter for the current region
        this.currentFormatter = new PhoneNumberFormatter();

        // Create an explicit formatter for New Zealand. 
        PhoneNumberFormatter.TryCreate("NZ", out this.NZFormatter);
    }

    private void phoneNumberInputTextBox_TextChanged(object sender, TextChangedEventArgs e)
    {
        // Format for the default region.
        this.phoneNumberOutputTextBlock.Text = currentFormatter.FormatPartialString(this.phoneNumberInputTextBox.Text);

        // If the NZFormatter was created successfully, format the partial string for the NZ TextBlock.
        if(this.NZFormatter != null)
        {
            this.phoneNumberOutputTextBlockNZ.Text = this.NZFormatter.FormatPartialString(this.phoneNumberInputTextBox.Text);
        }
    }

Вы можете протестировать приведенный выше код на своем компьютере, изменив страну или регион в разделе Параметры>Время и язык>Регион и язык>Страна или регион. Выберите страну или регион (возможно, Новую Зеландию, чтобы подтвердить соответствие форматов) и снова запустите код. Для тестовых данных можно выполнить веб-поиск телефонного номера бизнеса в Новой Зеландии.

Языковые и культурные предпочтения пользователя

В сценариях, где вы хотите предоставить различные функциональные возможности, основанные исключительно на языке пользователя, регионе или культурных предпочтениях, Windows предоставляет возможность доступа к этим предпочтениям через Windows.System.UserProfile.GlobalizationPreferences. При необходимости используйте класс GlobalizationPreferences , чтобы получить значение текущего географического региона пользователя, предпочитаемых языков, предпочитаемых валют и т. д. Но помните, что если строки и изображения приложения не локализованы для предпочтительного языка пользователя, то даты и время и другие данные, отформатированные для этого предпочтительного языка, не будут соответствовать отображаемым строкам.

Важные API

Образцы