Описание языка и региональных параметров с помощью данных LDML

Статья
08/11/2011

При сохранении в приложении языка и региональных параметров с помощью метода Save полученное XML-представление объекта CultureAndRegionInfoBuilder соответствует формату языка LDML версии 1.1. Метод CreateFromLdml является обратным по отношению к методу Save и выполняет загрузку из этого XML-файла.

Основная часть значимых данных, которые описывают язык и региональные параметры, содержится в специальных элементах XML-файла. С помощью специальных элементов LDML можно создавать примечания и данные, относящиеся к определенным продуктам.

Платформа .NET Framework использует специальный элемент для размещения данных, полученных из схемы msLocale (https://schemas.microsoft.com/globalization/2005/carib/ldml). Этот универсальный код ресурса (URI) означает уникальное имя, как и должно быть в схеме, но не является URL-адресом фактического документа.

Большинство таких XML-элементов соответствует свойствам или возвращаемым значениям методов классов, которые описывают язык и региональные параметры, например CultureAndRegionInfoBuilder и CultureInfo. Небольшая часть элементов свойственна только для операционной системы Windows, а не для платформы .NET Framework, и эти элементы не включены в качестве свойств класса CultureAndRegionInfoBuilder.

Дополнительные сведения о стандарте LDML см. в техническом стандарте Юникода № 35, посвященном языку LDML, на домашней странице Юникода (на английском языке).

Элементы, свойственные только Windows

Некоторые элементы в этом разделе названы свойственными "только для Windows". Они важны для неуправляемого кода Windows, но не имеют отношения к платформе .NET Framework. Если приложение создает LDML-файл вне платформы .NET Framework и для его регистрации используется структура, файл будет доступен как для Windows, так и для .NET Framework. В .NET Framework, если приложение запущено с существующим определением языка и региональных параметров, а затем в нем выполняется изменение и сохранение пользовательского языка и региональных параметров, элементы, свойственные только Windows, без изменений переносятся в пользовательское определение.

Элементы identity

Элементы identity описаны в таблице ниже.

Элемент	Примечания
версия	LDML 1.1; формат: <version number="1.1">ldml version 1.1</version>
generation	Время создания файла данных, например <generation date="2006-08-28" />
special	Контейнер, все содержимое которого поступает из схемы msLocale

Перечисленные ниже элементы относятся к категории identity/special. Все значения задаются атрибутом type, если не указано иное. Примеры.

    <identity>
        ...
        <special xmlns:msLocale="https://schemas.microsoft.com/globalization/2005/carib/ldml">
             <!-- A typical case... -->
             <msLocale:cultureAndRegionInfoName type="en-US-fabricam"/>
             ...
             <!-- ...but here are some examples that use CDATA -->
             <msLocale:geoId>244</msLocale:geoId>
             <msLocale:languageIsoName type="twoLetters">
                 en
             </msLocale:languageIsoName> 
             ...
        </special>
    </identity>

В таблице ниже описаны свойства и методы, соответствующие элементам identity.

Элемент	Свойство или метод	Примечания
msLocale:cultureAndRegionInfoName	CultureName	Примеры: "en", "en-US", "en-US-fabricam"
msLocale:cultureAndRegionModifier	IsNeutralCulture	Используется только для нейтральных языков и региональных параметров; всегда имеет тип "neutral"
msLocale:cultureInfoVersion	Неприменимо	В настоящее время "1.0"
msLocale:geoId	GeoId	Пример: "244"; это значение задано в виде текста CDATA, а не с помощью атрибута type
msLocale:parentName	Parent	Пример: "en"
msLocale:specificCulture	CreateSpecificCulture	Пример: "en-US"; относится только к нейтральным языкам и региональным параметрам, определяет конкретный язык и региональные параметры по умолчанию
msLocale:languageNameAbbr	ThreeLetterWindowsLanguageName	Пример: "ENU"
msLocale:languageIsoName type="threeLetters"	ThreeLetterISOLanguageName	Пример: "eng"; это значение задано в виде текста CDATA, а не с помощью атрибута type; тип — "threeLetters"
msLocale:languageIsoName type="twoLetters"	TwoLetterISOLanguageName	Пример: "en"; это значение задано в виде текста CDATA, а не с помощью атрибута type; тип — "twoLetters"
msLocale:nativeDisplayName	CultureNativeName	Примеры: "English (United States)", "Deutsch (Deutschland)"
msLocale:englishName	CultureEnglishName	Примеры: "English (United States)", "German (Germany)"
msLocale:countryCode	Неприменимо	Только для Windows; значение задано как CDATA; единственным исключением является Канада (код 2), для остальных стран это значение совпадает с международным телефонным кодом; в Windows его можно получить с помощью метода GetLocaleInfo или GetLocaleInfoEx, где LCTYPE имеет значение LOCALE_ICOUNTRY
msLocale:regionNativeName	RegionNativeName	Примеры: "United States", "Deutschland"
msLocale:regionEnglishName	RegionEnglishName	Примеры: "United States", "Germany"
msLocale:regionIsoName type="threeLetters"	ThreeLetterISORegionName	Пример: "USA"; это значение задано в виде текста CDATA, а не с помощью атрибута type; тип — "threeLetters"
msLocale:regionIsoName type="twoLetters"	TwoLetterISORegionName	Пример: "US"; это значение задано в виде текста CDATA, а не с помощью атрибута type; тип — "twoLetters"
msLocale:textInfoName	TextInfo.CultureName	Пример: "en-US"
msLocale:sortName	CompareInfo.Name	Примеры: "en-US", "de-DE_phoneb"
msLocale:ietfLanguageTag	IetfLanguageTag	Пример: "en-US"
msLocale:englishLanguage	Только для Windows	Примеры: "English", "German"

Элемент layout

Элемент layout описан в таблице ниже.

Элемент	Примечания
special	Контейнер; все содержимое поступает из схемы msLocale

Элемент, описанный в таблице ниже, относится к категории layout/special.

Элемент	Свойство или метод	Примечания
msLocale:direction	IsRightToLeft	Ориентация текста; это свойство может принимать одно из следующих значений: "left-to-right" "right-to-left" Пример: <msLocale:Direction type="left-to-right" />

msLocale:direction

IsRightToLeft

Ориентация текста; это свойство может принимать одно из следующих значений:

"left-to-right"
"right-to-left"

Пример: <msLocale:Direction type="left-to-right" />

Элемент characters

Элемент characters описан в таблице ниже.

Элемент	Примечания
special	Контейнер; все содержимое поступает из схемы msLocale

В таблице ниже описаны элементы, которые относятся к категории characters/special. Все значения задаются атрибутом type, если не указано иное.

Элемент	Свойство или метод	Примечания
msLocale:keyboardLayout	KeyboardLayoutId	Значение, которое обрабатывается как CDATA
msLocale:consoleFallbackName	ConsoleFallbackUICulture	Пример: "en-US"
msLocale:fontSignature	Неприменимо	Контейнер для дальнейшего хранения содержимого из схемы msLocale
mslocale:scripts	Неприменимо	Контейнер для дальнейшего хранения содержимого из схемы msLocale

В таблице ниже описаны элементы, которые относятся к категории characters/special/msLocale:fontSignature.

msLocale:unicodeRanges
msLocale:defaultCodePages
msLocale:codePages

Каждый из этих элементов строго является контейнером для дальнейшего хранения содержимого из схемы msLocale.

Элементы, описанные в таблице ниже, относятся к категории characters/special/msLocale:fontSignature/msLocale:unicodeRanges. Все значения задаются атрибутом type. Эти сведения относятся только к Windows и частично соответствуют структуре Windows LOCALESIGNATURE.

Элемент	Свойство или метод	Примечания
msLocale:range	Неприменимо	Только для Windows; значение от 0 до 122, представляющее собой число битов в битовом поле подмножества Юникода, которое содержится в структуре Windows FONTSIGNATURE; этот элемент может появляться неоднократно
msLocale:layoutProgress	Неприменимо	Только для Windows; возможные значения: "horizontalRightToLeft" "verticalBeforeHorizontal" "verticalBottomToTop"

msLocale:range

Неприменимо

Только для Windows; значение от 0 до 122, представляющее собой число битов в битовом поле подмножества Юникода, которое содержится в структуре Windows FONTSIGNATURE; этот элемент может появляться неоднократно

msLocale:layoutProgress

Неприменимо

Только для Windows; возможные значения:

"horizontalRightToLeft"
"verticalBeforeHorizontal"
"verticalBottomToTop"

Элементы, перечисленные ниже, относятся к категориям characters/special/msLocale:fontSignature/msLocale:defaultCodePages и characters/special/msLocale:fontSignature/msLocale:codePages.

msLocale:ansiCodePage
msLocale:ansiOemCodePage
msLocale:oemCodePage

Каждый из этих элементов строго является контейнером для элементов msLocale:codePage и имеет значение, определенное атрибутом type.

Элемент	Примечания
msLocale:codePage	Кодовая страница; должна соответствовать элементу, в котором содержится; например, кодовая страница "1252" является кодовой страницей Windows ANSI и относится к категории msLocale:ansiCodePage; кодовая страница "932" является кодовой страницей ANSI/OEM и относится к категории msLocale:ansiOemCodePage; кодовая страница "855" является кодовой страницей OEM и относится к категории msLocale:oemCodePage

msLocale:codePage

Кодовая страница; должна соответствовать элементу, в котором содержится; например, кодовая страница "1252" является кодовой страницей Windows ANSI и относится к категории msLocale:ansiCodePage; кодовая страница "932" является кодовой страницей ANSI/OEM и относится к категории msLocale:ansiOemCodePage; кодовая страница "855" является кодовой страницей OEM и относится к категории msLocale:oemCodePage

В категории characters/special/msLocale:fontSignature/msLocale:defaultCodePages должен присутствовать один из следующих элементов или наборов элементов:

одиночный элемент msLocale:ansiOemCodePage, который содержит одиночный элемент msLocale:codePage;
одиночный элемент msLocale:ansiCodePage, который содержит одиночный элемент msLocale:codePage, и одиночный элемент msLocale:oemCodePage, который содержит одиночный элемент msLocale:codePage

Данные msLocale:defaultCodePages относятся только к Windows. Данные characters/special/msLocale:fontSignature/msLocale:codePages также относятся только к Windows. В них перечисляются все кодовые страницы, которые могут поддерживать заданный язык и набор символов. Это означает, что в списке может быть несколько кодовых страниц одного типа. Пример.

<msLocale:codePages>
    <msLocale:ansiCodePage>
        ...
    </msLocale:ansiCodePage>
    <msLocale:oemCodePage>
        <msLocale:codePage type="864" />
        <msLocale:codePage type="708" />
    </msLocale:oemCodePage>
</msLocale:codePages>

Элементы, описанные в таблице ниже, относятся к категории characters/special/msLocale:fontSignature/msLocale:scripts. Все значения задаются атрибутом type. Эти данные относятся только к Windows. Невозможно задать эти данные в Windows, но они соответствуют значению, которое возвращает функция Windows GetStringScripts.

Элемент	Свойство или метод	Примечания
msLocale:script	Неприменимо	Только для Windows; четырехбуквенный код IS0 15924 для набора символов, например "Latn" (латиница) или "Cyrl" (кириллица); этот элемент может появляться любое количество раз

Элементы measurement

В таблице ниже описаны элементы категории measurement.

Элемент	Свойство или метод	Примечания
measurementSystem	IsMetric	Атрибут type имеет значение "metric" или "US"
paperSize	Неприменимо	Только для Windows; этот элемент представляет собой контейнер для элементов height и width; возможные значения: width = "216", height = "279" (Letter) width = "216", height = "356" (Legal) width = "297", height = "420" (A3) width = "210", height = "297" (A4)

measurementSystem

IsMetric

Атрибут type имеет значение "metric" или "US"

paperSize

Неприменимо

Только для Windows; этот элемент представляет собой контейнер для элементов height и width; возможные значения:

width = "216", height = "279" (Letter)
width = "216", height = "356" (Legal)
width = "297", height = "420" (A3)
width = "210", height = "297" (A4)

Элемент dates

Единственный элемент в категории dates — элемент calendars. Он является только элементом контейнера.

Примечание
В платформе .NET Framework используются правила POSIX для интерпретации форматов даты и времени из стандарта LDML, т. е. элемент извлекается из пространства имен LDML, а не из схемы msLocale.Например, индикатор AM/PM — это символ "a".Элементы в схеме msLocale подчиняются правилам Майкрософт для форматов даты и времени.Например, указатель AM/PM задается шаблоном формата "tt".

В платформе .NET Framework используются правила POSIX для интерпретации форматов даты и времени из стандарта LDML, т. е. элемент извлекается из пространства имен LDML, а не из схемы msLocale.Например, индикатор AM/PM — это символ "a".Элементы в схеме msLocale подчиняются правилам Майкрософт для форматов даты и времени.Например, указатель AM/PM задается шаблоном формата "tt".

В таблице ниже описаны элементы категории dates/calendars. Все значения задаются атрибутом type.

Элемент	Свойство или метод	Примечания
default	AvailableCalendars	Календарь по умолчанию, атрибут type имеет значение "metric" or "US"; в файлах, созданных в продуктах корпорации Майкрософт, календарь по умолчанию всегда совпадает с AvailableCalendars[0] Возможные значения календаря: "Gregorian" "Gregorian-US" "Japanese" "Taiwan" "Korean" "Hijri" "Thai" "Hebrew" "Gregorian-ME-French" "Gregorian-Arabic" "Gregorian-XLIT-English" "Gregorian-XLIT-French"
calendar	AvailableCalendars	Индикатор для доступных календарей; этот элемент может повторяться, поскольку для каждого доступного календаря возможные значения атрибута type такие же, как для календаря по умолчанию; этот элемент служит также контейнером для элементов, содержащих сведения о календаре Примечание. Для календарей, отличных от календаря по умолчанию, этот элемент обычно пуст. Соответственно, если доступны календари "Gregorian" и "Gregorian-US", и "Gregorian" является календарем по умолчанию, для календаря "Gregorian-US" этот элемент имеет вид <calendar type=" Gregorian-US" />.

default

AvailableCalendars

Календарь по умолчанию, атрибут type имеет значение "metric" or "US"; в файлах, созданных в продуктах корпорации Майкрософт, календарь по умолчанию всегда совпадает с AvailableCalendars[0]

Возможные значения календаря:

"Gregorian"
"Gregorian-US"
"Japanese"
"Taiwan"
"Korean"
"Hijri"
"Thai"
"Hebrew"
"Gregorian-ME-French"
"Gregorian-Arabic"
"Gregorian-XLIT-English"
"Gregorian-XLIT-French"

calendar

AvailableCalendars

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

Примечание. Для календарей, отличных от календаря по умолчанию, этот элемент обычно пуст. Соответственно, если доступны календари "Gregorian" и "Gregorian-US", и "Gregorian" является календарем по умолчанию, для календаря "Gregorian-US" этот элемент имеет вид <calendar type=" Gregorian-US" />.

В таблице ниже описаны элементы категории dates/calendars/calendar. Все значения задаются атрибутом type.

Элемент	Свойство или метод	Примечания
months	Неприменимо	Контейнер
days	Неприменимо	Контейнер
week	Неприменимо	Контейнер
am	AMDesignator	В разделе CDATA определен текст, который используется для обозначения времени до полудня, например "AM"
pm	PMDesignator	В разделе CDATA определен текст, который используется для обозначения времени после полудня, например "PM"
dateformat	Неприменимо	Контейнер
timeformat	Неприменимо	Контейнер
eras	Неприменимо	Контейнер

В категории dates/calendars/calendar/months содержится единственный элемент monthContext, для которого атрибут type должен иметь значение "format". В категории dates/calendars/calendar/months/monthContext должны присутствовать четыре элемента monthWidth.

Элемент	Свойство или метод	Примечания
monthWidth type="wide"	MonthNames	Контейнер
monthWidth type="abbreviated"	AbbreviatedMonthNames	Контейнер
monthWidth type="genitive"	MonthGenitiveNames	Контейнер
monthWidth type="genitiveAbbreviated"	AbbreviatedMonthGenitiveNames	Контейнер

В категории dates/calendars/calendar/months/monthContext/monthWidth должен присутствовать один элемент month для каждого месяца в году. В зависимости от календаря их может быть 12 или 13. Для каждого элемента месяца тип — это номер месяца, а тип CDATA указывает на соответствующую строку. Пример.

...
<calendar type="Gregorian">
   <months>
      <monthContext type="format">
          <monthWidth type="wide">            
              <month type="1">January</month>
              <month type="2">February</month>
              <month type="3">March</month>
              ...
          </monthWidth>
          <monthWidth type="abbreviated">
              <month type="1">Jan</month>
              <month type="2">Feb</month>
              <month type="3">Mar</month>
              ...
          </monthWidth>
          ...
      </monthContext>
   </months>
</calendar>

В категории dates/calendars/calendar/days содержится единственный элемент dayContext, для которого атрибут type должен иметь значение "format". В категории dates/calendars/calendar/days/dayContext должны присутствовать три элемента dayWidth.

Элемент	Свойство или метод	Примечания
dayWidth type="wide"	DayNames	Контейнер
dayWidth type="abbreviated"	AbbreviatedDayNames	Контейнер
dayWidth type="shorter"	ShortestDayNames	Контейнер

В категории dates/calendars/calendar/days/dayContext/dayWidth должен присутствовать один элемент day для каждого дня недели. Тип каждого из этих элементов может иметь одно из значений: "sun", "mon", "tue", "wed", "thu", "fri", "sat". Тип CDATA указывает на соответствующую строку. Пример.

...
<calendar type="Gregorian">
   <days>
      <dayContext type="format">
          <dayWidth type="wide">
              <day type="sun">Sunday</month>
              <day type="mon">Monday</month>
              <day type="tue">Tuesday</month>
              ...
          </dayWidth>
          ...
      </dayContext>
   </days>
</calendar>

В таблице ниже описаны элементы категории dates/calendars/calendar/week.

Элемент	Свойство или метод	Примечания
firstDay	FirstDayOfWeek	Атрибут day может иметь одно из значений: "sun", "mon", "tue", "wed", "thu", "fri", "sat"
special	Неприменимо	Контейнер; все содержимое поступает из схемы msLocale

В таблице ниже описаны элементы категории dates/calendars/calendar/week/special.

Элемент	Свойство или метод	Примечания
msLocale:weekRule	CalendarWeekRule	Атрибут type должен иметь одно из значений: firstDay firstFourDayWeek firstFullWeek

msLocale:weekRule

CalendarWeekRule

Атрибут type должен иметь одно из значений:

firstDay
firstFourDayWeek
firstFullWeek

Элемент, описанный в таблице, относится к категории dates/calendars/calendar/dateformats.

Элемент	Примечания
special	Контейнер; все содержимое поступает из схемы msLocale

В таблице ниже описаны элементы категории dates/calendars/calendar/dateformats/special. Все значения задаются атрибутом type.

Элемент	Свойство или метод	Примечания
msLocale:dateFormatLength type="long"	GetAllDateTimePatterns('D')	Контейнер
msLocale:dateFormatLength type="short"	GetAllDateTimePatterns('d')	Контейнер
msLocale:yearMonth	GetAllDateTimePatterns('Y')	Контейнер для каждого соответствующего шаблона DateTime; атрибут type задает уникальный индекс с отсчетом от нуля; разрывы не допускаются
msLocale:monthDay	MonthDayPattern	Контейнер

В таблице ниже описаны элементы категории dates/calendars/calendar/dateformats/special/msLocale:dateFormatLength. Все значения задаются атрибутом type.

Элемент	Свойство или метод	Примечания
msLocale:default	Неприменимо	Значение, соответствующее атрибуту type формата по умолчанию; в LDML-файлах, созданных в продуктах корпорации Майкрософт, по умолчанию всегда задано значение "0"
msLocale:dateFormat	GetAllDateTimePatterns ('D'), GetAllDateTimePatterns ('d')	Контейнер для каждого соответствующего шаблона формата DateTime; атрибут type задает уникальный индекс с отсчетом от нуля; разрывы не допускаются

Элементы, перечисленные ниже, являются контейнерами для элементов msLocale:pattern, значения которых становятся типами CDATA:

dates/calendars/calendar/dateformats/special/msLocale:dateFormatLength /msLocale:dateformat
dates/calendars/calendar/dateformats/special/msLocale:yearMonth
dates/calendars/calendar/dateformats/special/msLocale:monthDay

Пример.

<dateFormats>
    <special xmlns:msLocale="https://schemas.microsoft.com/globalization/2005/carib/ldml">
        <msLocale:dateFormatLength type="long">
            <msLocale:default type="0"/>
            <msLocale:dateFormat type="0">
                <msLocale:pattern>dddd, MMMM dd, yyyy</pattern>
            </msLocale:dateFormat>
                       
            <msLocale:dateFormat type="1">
                <msLocale:pattern>MMMM dd, yyyy</pattern>
            </msLocale:dateFormat>
            ...
        </msLocale:dateFormatLength>
        ...
        <msLocale:yearMonth type="0">
            <msLocale:pattern>MMMM, yyyy</msLocale:pattern>
        </msLocale:yearMonth>

        <msLocale:yearMonth type="1">
            <msLocale:pattern>mm, yy</msLocale:pattern>
        </msLocale:yearMonth>

        <msLocale:monthDay>
            <msLocale:pattern>MMMM dd</msLocale:pattern>
        </msLocale:monthDay>
    </special>
</dateFormats>

Элемент, описанный в таблице, относится к категории dates/calendars/calendar/timeformats.

Элемент	Примечания
special	Контейнер; все содержимое поступает из схемы msLocale

В таблице ниже описаны элементы категории dates/calendars/calendar/timeformats/special. Все значения задаются атрибутом type.

Элемент	Свойство или метод	Примечания
msLocale:durationFormats	Неприменимо	Только для Windows; контейнер
msLocale:timeFormatLength type="long"	GetAllDateTimePatterns('T')	Контейнер
msLocale:timeFormatLength type="short"	GetAllDateTimePatterns('t')	Контейнер

В таблице ниже описаны элементы категории dates/calendars/calendar/dateformats/special/msLocale:durationFormats. Все значения задаются атрибутом type.

Элемент	Свойство или метод	Примечания
msLocale:default	Неприменимо	Только для Windows; значение, соответствующее атрибуту type формата по умолчанию; в файлах, созданных в продуктах корпорации Майкрософт, по умолчанию всегда задано значение "0"
msLocale:durationFormat	Неприменимо	Только для Windows. Контейнер для каждого соответствующего значения DateTime; атрибут type задает уникальный индекс с отсчетом от нуля; разрывы не допускаются

В таблице ниже описаны элементы категории dates/calendars/calendar/dateformats/special/msLocale:timeFormatLength. Все значения задаются атрибутом type.

Элемент	Свойство или метод	Примечания
msLocale:default	Неприменимо	Значение, соответствующее атрибуту type формата по умолчанию; в файлах, созданных в продуктах корпорации Майкрософт, по умолчанию всегда задано значение "0"
msLocale:timeFormat	GetAllDateTimePatterns ('T'), GetAllDateTimePatterns ('t')	Контейнер для каждого соответствующего значения DateTime; атрибут type задает уникальный индекс с отсчетом от нуля; разрывы не допускаются

dates/calendars/calendar/dateformats/special/msLocale:durationFormats/msLocale:durationFormat
dates/calendars/calendar/dateformats/special/msLocale:timeFormatLength/msLocale:timeformat

Пример.

<timeFormats>
    <special xmlns:msLocale="https://schemas.microsoft.com/globalization/2005/carib/ldml">
        <msLocale:durationFormats>
            <msLocale:default type="0" />
            <msLocale:durationFormat type="0">
                <msLocale:pattern>HH:mm:ss</msLocale:pattern>
            </msLocale:durationFormat>
        </msLocale:durationFormats>

        <msLocale:timeFormatLength type="long">
            <msLocale:default type="0"/>
            <msLocale:timeFormat type="0">
                <msLocale:pattern>h:mm:ss tt</msLocale:pattern>
            </msLocale:timeFormat>
            <msLocale:timeFormat type="1">
                <msLocale:pattern>h:mm:ss a</msLocale:pattern>
            </timeFormat>
            ...
        </timeFormatLength>
        ...
    </special>
</timeFormats>

В таблице ниже описаны элементы категории dates/calendars/calendar/eras.

Элемент	Свойство или метод	Примечания
eraAbbr	GetEraName	Контейнер
eraNames	GetAbbreviatedEraName	Контейнер

В обеих категориях dates/calendars/calendar/eras/eraAbbr и dates/calendars/calendar/eras/eraNames должен присутствовать один элемент era для каждой эры. Для каждого элемента era тип — это номер эры, а тип CDATA указывает на соответствующую строку. Примеры.

<eras>
   <eraAbbr>
      <era type="0">BC</era>
      <era type="1">AD</era>
   </eraAbbr>
   <eraNames>
      <era type="0">Before Christ</era>
      <era type="1">Anno Domini</era>
   </eraNames>
</eras>

Элементы numbers

В таблице ниже описаны элементы категории numbers.

Элемент	Примечания
symbols	Контейнер
currencies	Контейнер
special	Контейнер; все содержимое поступает из схемы msLocale

Элементы категории numbers/symbols

В таблице ниже описаны элементы категории numbers/symbols. Данные этих элементов используются для типа CDATA, если не указано иное.

Элемент	Свойство или метод	Примечания
decimal	NumberDecimalSeparator	Пример: "."
group	NumberGroupSeparator	Пример: ","
list	TextInfo.ListSeparator	Пример: ";"
percentSign	PercentSymbol	Пример: "%"
infinity type="positive"	PositiveInfinitySymbol,	Пример: "Infinity"
infinity type="negative"	NegativeInfinitySymbol	Пример: "-Infinity"
nan	NaNSymbol	Обозначение "Не является числом". Например: "NaN".
special	Неприменимо	Контейнер; все содержимое поступает из схемы msLocale

В таблице ниже описаны элементы категории numbers/symbols/special. Данные этих элементов используются для типа CDATA, если не указано иное.

Элемент	Свойство или метод	Примечания
msLocale:currencyDecimalSeparator	CurrencyDecimalSeparator	Пример: "."
msLocale:currencyGroupSeparator	CurrencyGroupSeparator	Пример: ","
msLocale:leadingZero	Неприменимо	Только для Windows; CDATA отсутствует; атрибут type должен иметь значение "yes" или "no" для разрешения или запрещения предшествующих нулей.

Примеры.

<symbols>
    <decimal>.</decimal>
    <group>,</group>
    ...
    <infinity type="positive">Infinity</infinity>
    <infinity type="negative">-Infinity</infinity>
    ...
    <special xmlns:msLocale="https://schemas.microsoft.com/globalization/2005/carib/ldml">
        <msLocale:currencyDecimalSeparator>
            .
        </msLocale:currencyDecimalSeparator>
        <msLocale:currencyGroupSeparator>
            ,
        </msLocale:currencyGroupSeparator>
        <msLocale:leadingZero type="yes" />
    </special>
</symbols>

Элементы категории numbers/currencies

Элемент, описанный в таблице ниже, относится к категории numbers/currencies.

Элемент	Примечания
currency	Контейнер; атрибут type должен иметь значение "default"

Элементы, описанные в таблице ниже, относятся к категории numbers/currencies/currency. Данные этих элементов используются для типа CDATA, если не указано иное.

Элемент	Свойство или метод	Примечания
symbol	ISOCurrencySymbol	Пример: "$"
displayName	CurrencyNativeName	Пример: "доллар"
special	Неприменимо	Контейнер; все содержимое поступает из схемы msLocale

Элементы, описанные в таблице ниже, относятся к категории numbers/currencies/currency/special. Данные этих элементов используются для типа CDATA, если не указано иное.

Элемент	Свойство или метод	Примечания
msLocale:isoCurrency	ISOCurrencySymbol	Пример: "USD"
msLocale:currencyEnglishName	CurrencyEnglishName	Пример: "доллар"

Пример.

<currencies>
    <currency type="default">
        <symbol>$</symbol>
        <displayName>Dollar</displayName>
        <special xmlns:msLocale="https://schemas.microsoft.com/globalization/2005/carib/ldml">
                <msLocale:isoCurrency>USD</msLocale:isoCurrency>
                <msLocale:currencyEnglishName>
                    Dollar
                </msLocale:currencyEnglishName>
    </special>
</currency>

Элементы, описанные в таблице ниже, относятся к категории numbers/currencies/special. Все значения задаются атрибутом type, если не указано иное.

Элемент	Свойство или метод	Примечания
msLocale:decimalDigits	NumberDecimalDigits	Число десятичных разрядов, которое используется в числовых значениях, заданное как CDATA; пример: "2"
msLocale:negativePattern	NumberNegativePattern	Шаблон формата для отрицательных числовых значений
msLocale:currencyDecimalDigits	CurrencyDecimalDigits	Число десятичных разрядов, которое используется в значениях валют; в отличие от элемента msLocale:decimalDigits этот элемент задается в атрибуте type. Пример: "2"
msLocale:currencyPositivePattern	CurrencyPositivePattern	Шаблон формата для положительных значений валют
msLocale:currencyNagativePattern	CurrencyNegativePattern	Шаблон формата для отрицательных значений валют
msLocale:percentPositivePattern	PercentPositivePattern	Шаблон формата для положительных значений процентов
msLocale:percentNagativePattern	PercentNegativePattern	Шаблон формата для отрицательных значений процентов
msLocale:groupSizes	NumberGroupSizes	Количество цифр в каждой группе слева от десятичной точки в числовых значениях; фактический размер групп задан как тип CDATA; атрибут type служит для его сериализации; допускается присутствие любого числа этих элементов, при этом каждый должен иметь уникальный атрибут type, сериализованный с отсчетом от "0"; значение отсчитывается с наименьшей значимой группы цифр
msLocale:nativeDigits	NativeDigits	Собственные цифры, эквивалентные западным цифрам от 0 до 9, по одному элементу для каждой цифры; атрибут type является цифрой от "0" до "9"; тип CDATA задает символ, который используется для представления цифры
msLocale:digitSubstitution	DigitSubstitution	Значение, определяющее, каким образом в графическом интерфейсе пользователя должны отображаться фигуры цифр; действительными параметрами для атрибута type являются: "context" (значение по умолчанию) "none" (всегда использовать цифры от "0" до "9") "nativeNational" (всегда заменять)

Пример.

<numbers>
    ...
    <special xmlns:msLocale="https://schemas.microsoft.com/globalization/2005/carib/ldml">
        <msLocale:decimalDigits>2</msLocale:decimalDigits>     
        <msLocale:negativePattern type="1"/>
        <msLocale:currencyDecimalDigits type="2"/>
        <msLocale:currencyPositivePattern type="0"/>
        <msLocale:currencyNegativePattern type="0"/>
        <msLocale:percentNegativePattern type="0"/>
        <msLocale:percentPositivePattern type="0"/>
        <msLocale:groupSizes type="0">3</msLocale:groupSizes>
        <msLocale:currencyGroupSizes type="0">
            3
        </msLocale:currencyGroupSizes>
        <msLocale:nativeDigits type="0">0</msLocale:nativeDigits>
        <msLocale:nativeDigits type="1">1</msLocale:nativeDigits>
        ...
        <msLocale:nativeDigits type="9">9</msLocale:nativeDigits>
        <msLocale:digitSubstitution type="context"/>
    </special>
</numbers>

См. также

Ссылки

CultureAndRegionInfoBuilder

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

Описание языка и региональных параметров с помощью данных LDML

Элементы, свойственные только Windows

Элементы identity

Элемент layout

Элемент characters

Элементы measurement

Элемент dates

Элементы numbers

Элементы категории numbers/symbols

Элементы категории numbers/currencies

См. также

Ссылки

Дополнительные ресурсы