Describir una referencia cultural con datos LDML

Artículo
08/10/2011

Cuando la aplicación guarda una referencia cultural con Save, la representación XML resultante del objeto CultureAndRegionInfoBuilder sigue el formato LDML (Lenguaje de marcado de datos de configuración regional) versión 1.1. El método CreateFromLdml es el inverso de Save y se carga desde este archivo XML.

La mayoría de los datos significativos que describen una referencia cultural se encuentran en elementos special dentro del archivo XML. Los elementos special de LDML permiten anotaciones y datos específicos del producto.

.NET Framework utiliza el elemento special como contenedor de los datos obtenidos del esquema msLocale, https://schemas.microsoft.com/globalization/2005/carib/ldml. Como es normal para un esquema, ese identificador URI proporciona un nombre único para el esquema, pero no es la dirección URL de un documento real.

La mayoría de los elementos XML relevantes corresponden a propiedades (o a valores devueltos por métodos) de las clases que describen una referencia cultural, como CultureAndRegionInfoBuilder y CultureInfo. Un reducido número de elementos son específicos de Windows y no de .NET Framework, y no se incluyen como propiedades de CultureAndRegionInfoBuilder.

Para obtener más información acerca del estándar LDML, vea el estándar técnico Unicode 35 referente al Lenguaje de marcado de datos de configuración regional (Locale Data Markup Language, LDML) en el sitio principal de Unicode.

Elementos sólo de Windows

En este tema se describen varios elementos como "sólo de Windows". Son relativos al código de Windows no administrado, pero no a .NET Framework. Si su aplicación crea un archivo LDML fuera de .NET Framework y utiliza el marco para registrarlo, el archivo estará disponible tanto para Windows como para .NET Framework. En .NET Framework, si su aplicación se inicia con una definición de referencia cultural existente, después la modifica y la guarda como referencia cultural personalizada, los elementos sólo de Windows pasan intactas desde la referencia cultural original a la referencia cultural guardada.

Elementos identity

La tabla siguiente describe los elementos identity.

Elemento	Notas
version	LDML 1.1. El formato es <version number="1.1">ldml version 1.1</version>
generation	Hora de generación del archivo de fecha, por ejemplo, <generation date="2006-08-28" />
special	Un contenedor. Todo el contenido procede del esquema msLocale.

Los siguientes son elementos identity o special. A menos que se indique otra cosa, el atributo type especifica todos los valores. Por ejemplo:

    <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>

La tabla siguiente describe las propiedades y métodos que corresponden a los elementos identity.

Elemento	Propiedad o método	Notas
msLocale:cultureAndRegionInfoName	CultureName	Ejemplos: "en", "en-US", "en-US-fabricam"
msLocale:cultureAndRegionModifier	IsNeutralCulture	Sólo se utiliza para las referencias culturales neutras. type siempre es "neutral"
msLocale:cultureInfoVersion	N/D	Actualmente, "1.0"
msLocale:geoId	GeoId	Ejemplo: "244". Este valor se especifica como CDATA de texto, en lugar de utilizar un atributo type.
msLocale:parentName	Parent	Ejemplo: "en"
msLocale:specificCulture	CreateSpecificCulture	Ejemplo: "en-US". Sólo es relevante para las referencias culturales neutras, donde indica la referencia cultural específica predeterminada.
msLocale:languageNameAbbr	ThreeLetterWindowsLanguageName	Ejemplo: "ENU"
msLocale:languageIsoName type="threeLetters"	ThreeLetterISOLanguageName	Ejemplo: "eng". Este valor se especifica como CDATA de texto, en lugar de utilizar un atributo type. type es "threeLetters".
msLocale:languageIsoName type="twoLetters"	TwoLetterISOLanguageName	Ejemplo: "en". Este valor se especifica como CDATA de texto, en lugar de utilizar un atributo type. type es "twoLetters".
msLocale:nativeDisplayName	CultureNativeName	Ejemplos: "English (United States)", "Deutsch (Deutschland)"
msLocale:englishName	CultureEnglishName	Ejemplos: "English (United States)", German (Germany)
msLocale:countryCode	N/D	Windows sólo. El valor se especifica como CDATA. Con la única excepción de Canadá (codificación 2), este valor es idéntico al código de llamada internacional para telefonía. En Windows, se tiene acceso a él mediante GetLocaleInfo o GetLocaleInfoEx, con LCTYPE especificado como LOCALE_ICOUNTRY.
msLocale:regionNativeName	RegionNativeName	Ejemplos: "United States", " Deutschland"
msLocale:regionEnglishName	RegionEnglishName	Ejemplos: "United States", "Germany"
msLocale:regionIsoName type="threeLetters"	ThreeLetterISORegionName	Ejemplo: "USA". Este valor se especifica como CDATA de texto, en lugar de utilizar un atributo type; type es "threeLetters".
msLocale:regionIsoName type="twoLetters"	TwoLetterISORegionName	Ejemplo: "US". Este valor se especifica como CDATA de texto, en lugar de utilizar un atributo type; type es "twoLetters".
msLocale:textInfoName	TextInfo.CultureName	Ejemplo: "en-US"
msLocale:sortName	CompareInfo.Name	Ejemplos: "en-US", "de-DE_phoneb"
msLocale:ietfLanguageTag	IetfLanguageTag	Ejemplo: "en-US"
msLocale:englishLanguage	Sólo Windows	Ejemplos: "English", "German"

Elemento layout

La tabla siguiente describe el elemento layout.

Elemento	Notas
special	Un contenedor. Todo el contenido procede del esquema msLocale.

El elemento de la tabla siguiente forma parte de layout/special.

Elemento	Propiedad o método	Notas
msLocale:direction	IsRightToLeft	Dirección de diseño del texto, que puede tener los valores siguientes: "left-to-right" "right-to-left" Ejemplo: <msLocale:Direction type="left-to-right" />

msLocale:direction

IsRightToLeft

Dirección de diseño del texto, que puede tener los valores siguientes:

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

Ejemplo: <msLocale:Direction type="left-to-right" />

Elemento characters

En la tabla siguiente se describe el elemento characters.

Elemento	Notas
special	Un contenedor. Todo el contenido procede del esquema msLocale.

La tabla siguiente describe los elementos characters/special. A menos que se indique otra cosa, el atributo type especifica todos los valores.

Elemento	Propiedad o método	Notas
msLocale:keyboardLayout	KeyboardLayoutId	El valor se especifica como CDATA
msLocale:consoleFallbackName	ConsoleFallbackUICulture	Ejemplo: "en-US"
msLocale:fontSignature	N/D	Un contenedor para contenido adicional del esquema msLocale
mslocale:scripts	N/D	Un contenedor para contenido adicional del esquema msLocale

Los elementos siguientes forman parte de characters/special/msLocale:fontSignature:

msLocale:unicodeRanges
msLocale:defaultCodePages
msLocale:codePages

Cada uno de estos elementos es estrictamente un contenedor para otros contenidos obtenidos del esquema msLocale.

Los elementos de la tabla siguiente forman parte de characters/special/msLocale:fontSignature/msLocale:unicodeRanges. Todos los valores se especifican mediante el atributo type. Esta es información sólo de Windows y corresponde, en parte, a la estructura LOCALESIGNATURE de Windows.

Elemento	Propiedad o método	Notas
msLocale:range	N/D	Windows sólo. Un valor entre 0 y 122 que representa un número de bits en el campo de bits del subconjunto Unicode (USB), contenido en la estructura FONTSIGNATURE de Windows. Este elemento puede darse varias veces.
msLocale:layoutProgress	N/D	Windows sólo; valores posibles: "horizontalRightToLeft" "verticalBeforeHorizontal" "verticalBottomToTop"

msLocale:range

N/D

Windows sólo. Un valor entre 0 y 122 que representa un número de bits en el campo de bits del subconjunto Unicode (USB), contenido en la estructura FONTSIGNATURE de Windows. Este elemento puede darse varias veces.

msLocale:layoutProgress

N/D

Windows sólo; valores posibles:

"horizontalRightToLeft"
"verticalBeforeHorizontal"
"verticalBottomToTop"

Los elementos siguientes forman parte de characters/special/msLocale:fontSignature/msLocale:defaultCodePages y characters/special/msLocale:fontSignature/msLocale:codePages:

msLocale:ansiCodePage
msLocale:ansiOemCodePage
msLocale:oemCodePage

Cada uno de estos elementos es estrictamente un contenedor para elementos msLocale:codePage, cuyo valor está especificado por el atributo type.

Elemento	Notas
msLocale:codePage	Una página de códigos. Debe ser adecuada para el elemento en el que está contenida; por ejemplo, la página de códigos "1252" es una página de códigos ANSI de Windows que forma parte de msLocale:ansiCodePage. La página de códigos "932" es una página de códigos ANSI/OEM que forma parte de msLocale:ansiOemCodePage. La página de códigos "855" es una página de códigos OEM que forma parte de msLocale:oemCodePage.

msLocale:codePage

Una página de códigos. Debe ser adecuada para el elemento en el que está contenida; por ejemplo, la página de códigos "1252" es una página de códigos ANSI de Windows que forma parte de msLocale:ansiCodePage. La página de códigos "932" es una página de códigos ANSI/OEM que forma parte de msLocale:ansiOemCodePage. La página de códigos "855" es una página de códigos OEM que forma parte de msLocale:oemCodePage.

En characters/special/msLocale:fontSignature/msLocale:defaultCodePages debe haber uno de los elementos siguientes:

Un único elemento msLocale:ansiOemCodePage que contiene un único elemento msLocale:codePage
Un único elemento msLocale:ansiCodePage que contiene un único elemento msLocale:codePage, y un único elemento msLocale:oemCodePage que contiene un único elemento msLocale:codePage

Los datos de msLocale:defaultCodePages son sólo de Windows. Los datos de characters/special/msLocale:fontSignature/msLocale:codePages también son sólo de Windows. Muestra todas las páginas de códigos que admiten el idioma y el script especificados. Por consiguiente, es posible que esta lista tenga varias páginas de códigos del mismo tipo. Por ejemplo:

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

Los elementos de la tabla siguiente forman parte de characters/special/msLocale:fontSignature/msLocale:scripts. Todos los valores se especifican mediante el atributo type. Esta información es sólo de Windows. Estos datos no se pueden establecer en Windows, pero corresponden al resultado de la función GetStringScripts de Windows.

Elemento	Propiedad o método	Notas
msLocale:script	N/D	Windows sólo. Un código IS0 15924 de cuatro letras para un script, como "Latn" (latín) "Cyrl" (cirílico). Este elemento puede darse cualquier número de veces.

Elementos measurement

La tabla siguiente define los elementos measurement.

Elemento	Propiedad o método	Notas
measurementSystem	IsMetric	El atributo type es "metric" o "US"
paperSize	N/D	Windows sólo. Este elemento es un contenedor para un elemento de alto y de ancho. Los valores posibles son: width = "216", height = "279" (Carta) width = "216", height = "356" (Oficio) width = "297", height = "420" (A3) width = "210", height = "297" (A4)

measurementSystem

IsMetric

El atributo type es "metric" o "US"

paperSize

N/D

Windows sólo. Este elemento es un contenedor para un elemento de alto y de ancho. Los valores posibles son:

width = "216", height = "279" (Carta)
width = "216", height = "356" (Oficio)
width = "297", height = "420" (A3)
width = "210", height = "297" (A4)

Elemento dates

El único elemento dates es el elemento calendars. Este sólo es un elemento contenedor.

Nota
.NET Framework utiliza reglas POSIX para interpretar los formatos de fecha y hora de un elemento LDML estándar, es decir, un elemento obtenido del espacio de nombres LDML en lugar del esquema msLocale.Por ejemplo, el indicador AM/PM es "a".Los elementos del esquema msLocale siguen las reglas de Microsoft para los formatos de fecha y hora.Por ejemplo, el designador AM/PM se especifica mediante el modelo de formato "tt".

.NET Framework utiliza reglas POSIX para interpretar los formatos de fecha y hora de un elemento LDML estándar, es decir, un elemento obtenido del espacio de nombres LDML en lugar del esquema msLocale.Por ejemplo, el indicador AM/PM es "a".Los elementos del esquema msLocale siguen las reglas de Microsoft para los formatos de fecha y hora.Por ejemplo, el designador AM/PM se especifica mediante el modelo de formato "tt".

La tabla siguiente describe los elementos que forman parte de dates/calendars. Todos los valores se especifican mediante el atributo type.

Elemento	Propiedad o método	Notas
default	AvailableCalendars	Un calendario predeterminado. El atributo type es "metric" o "US". En archivos generados por Microsoft, el calendario predeterminado coincide siempre con AvailableCalendars[0]. Los valores posibles de calendar son: "Gregorian" "Gregorian-US" "Japanese" "Taiwan" "Korean" "Hijri" "Thai" "Hebrew" "Gregorian-ME-French" "Gregorian-Arabic" "Gregorian-XLIT-English" "Gregorian-XLIT-French"
calendar	AvailableCalendars	Indicador de los calendarios disponibles. Este elemento se puede repetir una vez para cada calendario disponible. Los posibles valores del atributo type son iguales que los predeterminados. Este elemento también funciona como un contenedor para los elementos que proporcionan datos sobre el calendario. Nota Para los calendarios no predeterminados, este elemento normalmente es un elemento vacío. Por consiguiente, si están disponibles "Gregorian" y "Gregorian-US", y "Gregorian" es el valor predeterminado, el elemento para "Gregorian-US" es simplemente <calendar type=" Gregorian-US" />.

default

AvailableCalendars

Un calendario predeterminado. El atributo type es "metric" o "US". En archivos generados por Microsoft, el calendario predeterminado coincide siempre con AvailableCalendars[0].

Los valores posibles de calendar son:

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

calendar

AvailableCalendars

Indicador de los calendarios disponibles. Este elemento se puede repetir una vez para cada calendario disponible. Los posibles valores del atributo type son iguales que los predeterminados. Este elemento también funciona como un contenedor para los elementos que proporcionan datos sobre el calendario.

Nota Para los calendarios no predeterminados, este elemento normalmente es un elemento vacío. Por consiguiente, si están disponibles "Gregorian" y "Gregorian-US", y "Gregorian" es el valor predeterminado, el elemento para "Gregorian-US" es simplemente <calendar type=" Gregorian-US" />.

Los elementos de la tabla siguiente forman parte de dates/calendars/calendar. Todos los valores se especifican mediante el atributo type.

Elemento	Propiedad o método	Notas
months	N/D	Un contenedor
days	N/D	Un contenedor
week	N/D	Un contenedor
am	AMDesignator	CDATA especifica el texto utilizado para etiquetar las horas anteriores al mediodía, por ejemplo, "AM"
pm	PMDesignator	CDATA especifica el texto utilizado para etiquetar las horas posteriores al mediodía, por ejemplo, "PM"
dateformat	N/D	Un contenedor
timeformat	N/D	Un contenedor
eras	N/D	Un contenedor

En dates/calendars/calendar/months, es un único elemento monthContext, cuyo atributo type debe ser "format". En dates/calendars/calendar/months/monthContext, debe haber cuatro elementos monthWidth.

Elemento	Propiedad o método	Notas
monthWidth type="wide"	MonthNames	Un contenedor
monthWidth type="abbreviated"	AbbreviatedMonthNames	Un contenedor
monthWidth type="genitive"	MonthGenitiveNames	Un contenedor
monthWidth type="genitiveAbbreviated"	AbbreviatedMonthGenitiveNames	Un contenedor

En dates/calendars/calendar/months/monthContext/monthWidth, debe haber un elemento month para cada mes del año. Debe haber 12 o 13, dependiendo del calendario. Para cada elemento month, el atributo type es el número del mes y el tipo CDATA indica la cadena correspondiente. Por ejemplo:

...
<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>

En dates/calendars/calendar/days, es un único elemento dayContext, cuyo atributo type debe ser "format". En dates/calendars/calendar/days/dayContext, debe haber tres elementos dayWidth.

Elemento	Propiedad o método	Notas
dayWidth type="wide"	DayNames	Un contenedor
dayWidth type="abbreviated"	AbbreviatedDayNames	Un contenedor
dayWidth type="shorter"	ShortestDayNames	Un contenedor

En dates/calendars/calendar/days/dayContext/dayWidth, debe haber un elemento day para cada día de la semana. Para cada elemento day, el atributo type es uno de estos valores: "sun", "mon", "tue", "wed", "thu", "fri", "sat". El tipo CDATA indica la cadena pertinente. Por ejemplo:

...
<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>

Los elementos de la tabla siguiente forman parte de dates/calendars/calendar/week.

Elemento	Propiedad o método	Notas
firstDay	FirstDayOfWeek	El atributo day debe ser uno de los siguientes valores: "sun", "mon", "tue", "wed", "thu", "fri", "sat"
special	N/D	Un contenedor. Todo el contenido procede del esquema msLocale.

Los elementos de la tabla siguiente forman parte de dates/calendars/calendar/week/special.

Elemento	Propiedad o método	Notas
msLocale:weekRule	CalendarWeekRule	El atributo type debe ser uno de los valores siguientes: firstDay firstFourDayWeek firstFullWeek

msLocale:weekRule

CalendarWeekRule

El atributo type debe ser uno de los valores siguientes:

firstDay
firstFourDayWeek
firstFullWeek

El elemento de la tabla siguiente forma parte de dates/calendars/calendar/week/dateformats.

Elemento	Notas
special	Un contenedor. Todo el contenido procede del esquema msLocale.

Los elementos de la tabla siguiente forman parte de dates/calendars/calendar/dateformats/special. Todos los valores se especifican mediante el atributo type.

Elemento	Propiedad o método	Notas
msLocale:dateFormatLength type="long"	GetAllDateTimePatterns('D')	Un contenedor
msLocale:dateFormatLength type="short"	GetAllDateTimePatterns('d')	Un contenedor
msLocale:yearMonth	GetAllDateTimePatterns('Y')	Un contenedor para cada modelo de DateTime pertinente. El atributo type especifica un índice de base cero único. No debe haber espacios vacíos.
msLocale:monthDay	MonthDayPattern	Un contenedor

Los elementos de la tabla siguiente forman parte de dates/calendars/calendar/dateformats/special/msLocale:dateFormatLength. Todos los valores se especifican mediante el atributo type.

Elemento	Propiedad o método	Notas
msLocale:default	N/D	Valor que corresponde al atributo type del formato predeterminado. En archivos LDML generados por Microsoft, el valor predeterminado siempre es "0".
msLocale:dateFormat	GetAllDateTimePatterns ('D'), GetAllDateTimePatterns ('d')	Un contenedor para cada formato DateTime pertinente. El atributo type especifica un índice de base cero único. No debe haber espacios vacíos.

Los elementos siguientes son contenedores de elementos msLocale:pattern que proporcionan sus valores como tipos CDATA:

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

Por ejemplo:

<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>

El elemento de la tabla siguiente forma parte de dates/calendars/calendar/timeformats.

Elemento	Notas
special	Un contenedor. Todo el contenido procede del esquema msLocale.

Los elementos de la tabla siguiente forman parte de dates/calendars/calendar/timeformats/special. Todos los valores se especifican mediante el atributo type.

Elemento	Propiedad o método	Notas
msLocale:durationFormats	N/D	Windows sólo. Un contenedor.
msLocale:timeFormatLength type="long"	GetAllDateTimePatterns('T')	Un contenedor
msLocale:timeFormatLength type="short"	GetAllDateTimePatterns('t')	Un contenedor

Los elementos de la tabla siguiente forman parte de dates/calendars/calendar/dateformats/special/msLocale:durationFormats. Todos los valores se especifican mediante el atributo type.

Elemento	Propiedad o método	Notas
msLocale:default	N/D	Windows sólo. Valor que corresponde al atributo type del formato predeterminado. En archivos generados por Microsoft, el valor predeterminado siempre es "0".
msLocale:durationFormat	N/D	Sólo Windows. Un contenedor para cada valor DateTime pertinente. El atributo type especifica un índice de base cero único. No debe haber espacios vacíos.

Los elementos de la tabla siguiente forman parte de dates/calendars/calendar/dateformats/special/msLocale:timeFormatLength. Todos los valores se especifican mediante el atributo type.

Elemento	Propiedad o método	Notas
msLocale:default	N/D	Valor que corresponde al atributo type del formato predeterminado. En archivos generados por Microsoft, el valor predeterminado siempre es "0".
msLocale:timeFormat	GetAllDateTimePatterns ('T'), GetAllDateTimePatterns ('t')	Un contenedor para cada valor DateTime pertinente. El atributo type especifica un índice de base cero único. No debe haber espacios vacíos.

Los elementos siguientes son contenedores de elementos msLocale:pattern que proporcionan sus valores como tipos CDATA:

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

Por ejemplo:

<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>

Los elementos de la tabla siguiente forman parte de dates/calendars/calendar/eras.

Elemento	Propiedad o método	Notas
eraAbbr	GetEraName	Un contenedor
eraNames	GetAbbreviatedEraName	Un contenedor

Debajo de dates/calendars/calendar/eras/eraAbbr y dates/calendars/calendar/eras/eraNames debe haber un elemento de era para cada era. Para cada elemento de era, el tipo es el número de la era y el tipo CDATA indica la cadena correspondiente. Por ejemplo:

<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>

Elementos numbers

La tabla siguiente define los elementos de numbers.

Elemento	Notas
symbols	Un contenedor
currencies	Un contenedor
special	Un contenedor. Todo el contenido procede del esquema msLocale.

Elementos en numbers/symbols

Los elementos de la tabla siguiente forman parte de numbers/symbols. A menos que se indique otra cosa, estos elementos proporcionan sus datos como un tipo CDATA.

Elemento	Propiedad o método	Notas
decimal	NumberDecimalSeparator	Ejemplo: "."
group	NumberGroupSeparator	Ejemplo: ","
configuración	TextInfo.ListSeparator	Ejemplo: ";"
percentSign	PercentSymbol	Ejemplo: "%"
infinity type="positive"	PositiveInfinitySymbol,	Ejemplo: "Infinity"
infinity type="negative"	NegativeInfinitySymbol	Ejemplo: "-Infinity"
nan	NaNSymbol	Símbolo de "No es un número". Ejemplo: "NaN".
special	N/D	Un contenedor. Todo el contenido procede del esquema msLocale.

Los elementos de la tabla siguiente forman parte de numbers/symbols/special. A menos que se indique otra cosa, estos elementos proporcionan sus datos como un tipo CDATA.

Elemento	Propiedad o método	Notas
msLocale:currencyDecimalSeparator	CurrencyDecimalSeparator	Ejemplo: "."
msLocale:currencyGroupSeparator	CurrencyGroupSeparator	Ejemplo: ","
msLocale:leadingZero	N/D	Windows sólo. No es CDATA. El atributo type debe ser "yes" o "no" para permitir o no los ceros a la izquierda.

Por ejemplo:

<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>

Elementos en numbers/currencies

El elemento de la tabla siguiente forma parte de numbers/currencies.

Elemento	Notas
currency	Un contenedor. El atributo type debe especificarse como "default".

Los elementos de la tabla siguiente forman parte de numbers/currencies/currency. A menos que se indique otra cosa, estos elementos proporcionan sus datos como un tipo CDATA.

Elemento	Propiedad o método	Notas
symbol	ISOCurrencySymbol	Ejemplo: "$"
displayName	CurrencyNativeName	Ejemplo: "Dollar"
special	N/D	Un contenedor. Todo el contenido procede del esquema msLocale.

Los elementos de la tabla siguiente forman parte de numbers/currencies/currency/special. A menos que se indique otra cosa, estos elementos proporcionan sus datos como un tipo CDATA.

Elemento	Propiedad o método	Notas
msLocale:isoCurrency	ISOCurrencySymbol	Ejemplo: "USD"
msLocale:currencyEnglishName	CurrencyEnglishName	Ejemplo: "Dollar"

Por ejemplo:

<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>

Los elementos de la tabla siguiente forman parte de numbers/currencies/special. El atributo type especifica todos los valores a menos se indique otra cosa.

Elemento	Propiedad o método	Notas
msLocale:decimalDigits	NumberDecimalDigits	Número de posiciones decimales que se va a utilizar en valores numéricos, especificado como CDATA. Ejemplo: "2"
msLocale:negativePattern	NumberNegativePattern	Modelo de formato para los valores numéricos negativos
msLocale:currencyDecimalDigits	CurrencyDecimalDigits	Número de posiciones decimales que se va a utilizar en los valores de divisa. A diferencia de msLocale:decimalDigits, este elemento se especifica en el atributo type. Ejemplo: "2"
msLocale:currencyPositivePattern	CurrencyPositivePattern	Modelo de formato para los valores de divisa positivos.
msLocale:currencyNagativePattern	CurrencyNegativePattern	Modelo de formato para los valores de divisa negativos
msLocale:percentPositivePattern	PercentPositivePattern	Modelo de formato para los valores de porcentaje positivos
msLocale:percentNagativePattern	PercentNegativePattern	Modelo de formato para los valores de porcentaje negativos
msLocale:groupSizes	NumberGroupSizes	Número de dígitos en cada grupo situado a la izquierda del decimal en valores numéricos. El tamaño real de la agrupación se especifica como el tipo CDATA. El atributo type sirve para realizar la serialización. Puede haber cualquier número de estos elementos, cada uno con un atributo type único, serializado desde "0". El valor comienza por el grupo menos significativo de dígitos.
msLocale:nativeDigits	NativeDigits	En los dígitos nativos, equivalente a los dígitos occidentales de 0 a 9, uno por cada dígito. El atributo type es un dígito de "0" a "9". El tipo CDATA especifica el carácter utilizado para representar un dígito.
msLocale:digitSubstitution	DigitSubstitution	Un valor que especifica la manera en que la interfaz gráfica de usuario muestra la forma de un dígito. Los valores válidos para el atributo type son: "context" (valor predeterminado) "none" (utilice siempre "0"-"9") "nativeNational" (sustituya siempre)

Por ejemplo:

<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>

Vea también

Referencia

CultureAndRegionInfoBuilder

Share via

Describir una referencia cultural con datos LDML

Elementos sólo de Windows

Elementos identity

Elemento layout

Elemento characters

Elementos measurement

Elemento dates

Elementos numbers

Elementos en numbers/symbols

Elementos en numbers/currencies

Vea también

Referencia

Recursos adicionales