Description d'une culture avec des données LDML

Article
08/10/2011

Lorsque votre application enregistre une culture avec Save, la représentation XML résultante de l'objet CultureAndRegionInfoBuilder suit le format de LDML (Locale Data Markup Language) version 1.1. La méthode CreateFromLdml est l'inverse de Save, et est chargée à partir de ce fichier XML.

La plupart des données significatives qui décrivent une culture sont contenues dans les éléments « special » du fichier XML. Les éléments « special » de LDML autorisent les données et les annotations spécifiques au produit.

.NET Framework utilise l'élément « special » pour stocker les données extraites du schéma msLocale, https://schemas.microsoft.com/globalization/2005/carib/ldml. Comme pour tout schéma, cet URI fournit un nom unique mais n'est pas l'URL d'un document réel.

La plupart des éléments XML pertinents correspondent aux propriétés ou aux valeurs retournées par les méthodes des classes qui décrivent une culture, telles que CultureAndRegionInfoBuilder et CultureInfo. Certains éléments, en nombre limité, sont spécifiques à Windows plutôt qu'à .NET Framework et ne sont pas inclus en tant que propriétés de CultureAndRegionInfoBuilder.

Pour plus d'informations sur la norme LDML, consultez Unicode Technical Standard #35, « Locale Data Markup Language (LDML) », sur le site d'accueil Unicode.

Éléments propres à Windows

Plusieurs éléments dans cette rubrique sont qualifiés « propres à Windows ». Ils sont pertinents pour le code Windows non managé, mais pas pour .NET Framework. Si votre application crée un fichier LDML en dehors de .NET Framework et utilise l'infrastructure pour l'enregistrer, le fichier devient disponible sous Windows ainsi que sous .NET Framework. Dans .NET Framework, si votre application démarre avec une définition de culture existante, puis la modifie et l'enregistre en tant que culture personnalisée, les éléments propres à Windows sont transmis tels quels de la culture d'origine à la culture enregistrée.

Éléments identity

Le tableau suivant décrit les éléments identity.

Élément	Remarques
version	LDML 1.1 ; format <version number="1.1">ldml version 1.1</version>
generation	Heure de génération du fichier, par exemple <generation date="2006-08-28" />.
special	Conteneur, avec tout le contenu extrait du schéma msLocale.

Les éléments suivants sont des éléments identity/special. Sauf pour les cas mentionnés, toutes les valeurs sont spécifiées par le type d'attribut. Par exemple :

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

Le tableau suivant décrit les propriétés et méthodes qui correspondent aux éléments identity.

Élément	Propriété/méthode	Remarques
msLocale:cultureAndRegionInfoName	CultureName	Exemples : « en », « en-US », « en-US-fabricam ».
msLocale:cultureAndRegionModifier	IsNeutralCulture	Utilisé uniquement pour les cultures neutres. Le type a toujours la valeur « neutral ».
msLocale:cultureInfoVersion	N/A	Actuellement, « 1.0 ».
msLocale:geoId	GeoId	Exemple : « 244 » ; cette valeur est spécifiée sous forme de texte CDATA, plutôt qu'avec un attribut de type.
msLocale:parentName	Parent	Exemple : « en ».
msLocale:specificCulture	CreateSpecificCulture	Exemple : « en-US » ; pertinent uniquement pour les cultures neutres, où il indique la culture spécifique par défaut.
msLocale:languageNameAbbr	ThreeLetterWindowsLanguageName	Exemple : « ENU »
msLocale:languageIsoName type="threeLetters"	ThreeLetterISOLanguageName	Exemple : « eng » ; cette valeur est spécifiée sous forme de texte CDATA, plutôt qu'avec un attribut de type ; le type est « threeLetters ».
msLocale:languageIsoName type="twoLetters"	TwoLetterISOLanguageName	Exemple : « eng » ; cette valeur est spécifiée sous forme de texte CDATA, plutôt qu'avec un attribut de type ; le type est « twoLetters ».
msLocale:nativeDisplayName	CultureNativeName	Exemples : "Anglais (États-Unis)", "Allemand (Allemagne)".
msLocale:englishName	CultureEnglishName	Exemples : "Anglais (États-Unis)", Allemand (Allemagne)
msLocale:countryCode	N/A	Windows uniquement ; la valeur est spécifiée sous forme CDATA ; avec la seule exception du Canada (indicatif 2), cette valeur est identique à l'indicatif téléphonique international ; sous Windows, accessible via GetLocaleInfo ou GetLocaleInfoEx avec LCTYPE comme LOCALE_ICOUNTRY.
msLocale:regionNativeName	RegionNativeName	Exemples : « Etats-Unis », « Allemagne ».
msLocale:regionEnglishName	RegionEnglishName	Exemples : « Etats-Unis », « Allemagne ».
msLocale:regionIsoName type="threeLetters"	ThreeLetterISORegionName	Exemple : « USA » ; cette valeur est spécifiée sous forme de texte CDATA, plutôt qu'avec un attribut de type ; le type est « threeLetters ».
msLocale:regionIsoName type="twoLetters"	TwoLetterISORegionName	Exemple : « US » ; cette valeur est spécifiée sous forme de texte CDATA, plutôt qu'avec un attribut de type ; le type est « twoLetters ».
msLocale:textInfoName	TextInfo.CultureName	Exemple : « en-US ».
msLocale:sortName	CompareInfo.Name	Exemples : « en-US », « de-DE_phoneb ».
msLocale:ietfLanguageTag	IetfLanguageTag	Exemple : « en-US ».
msLocale:englishLanguage	Windows uniquement.	Exemples : « Anglais », « Allemand ».

Élément layout

Le tableau suivant décrit l'élément layout.

Élément	Remarques
special	Conteneur ; tout le contenu vient du schéma msLocale.

L'élément du tableau suivant s'inscrit dans la catégorie layout/special.

Élément	Propriété/méthode	Remarques
msLocale:direction	IsRightToLeft	Sens de disposition du texte, à savoir : "left-to-right" "right-to-left" Exemple : <msLocale:Direction type="left-to-right" />

msLocale:direction

IsRightToLeft

Sens de disposition du texte, à savoir :

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

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

Élément characters

Le tableau suivant décrit l'élément characters.

Élément	Remarques
special	Conteneur ; tout le contenu vient du schéma msLocale.

Le tableau suivant décrit des éléments characters/special. Sauf pour les cas mentionnés, toutes les valeurs sont spécifiées par le type d'attribut.

Élément	Propriété/méthode	Remarques
msLocale:keyboardLayout	KeyboardLayoutId	La valeur est gérée comme du texte CDATA.
msLocale:consoleFallbackName	ConsoleFallbackUICulture	Exemple : « en-US ».
msLocale:fontSignature	N/A	Conteneur pour du contenu supplémentaire du schéma msLocale.
mslocale:scripts	N/A	Conteneur pour du contenu supplémentaire du schéma msLocale.

Les éléments suivants font partie de characters/special/msLocale:fontSignature :

msLocale:unicodeRanges
msLocale:defaultCodePages
msLocale:codePages

Chacun de ces éléments est strictement un conteneur pour le contenu supplémentaire provenant du schéma msLocale.

Les éléments du tableau suivant font partie de characters/special/msLocale:fontSignature/msLocale:unicodeRanges. Toutes les valeurs sont spécifiées par l'attribut de type. Il s'agit d'informations propres à Windows qui correspondent en partie à la structure Windows LOCALESIGNATURE.

Élément	Propriété/méthode	Remarques
msLocale:range	N/A	Windows uniquement ; valeur entre 0 et 122 qui représente un nombre de bits dans le champ de bits du sous-ensemble Unicode (USB) et contenue dans la structure de Windows FONTSIGNATURE; cet élément peut se produire plusieurs fois.
msLocale:layoutProgress	N/A	Windows uniquement ; valeurs possibles : "horizontalRightToLeft" "verticalBeforeHorizontal" "verticalBottomToTop"

msLocale:range

N/A

Windows uniquement ; valeur entre 0 et 122 qui représente un nombre de bits dans le champ de bits du sous-ensemble Unicode (USB) et contenue dans la structure de Windows FONTSIGNATURE; cet élément peut se produire plusieurs fois.

msLocale:layoutProgress

N/A

Windows uniquement ; valeurs possibles :

"horizontalRightToLeft"
"verticalBeforeHorizontal"
"verticalBottomToTop"

Les éléments suivants font partie de characters/special/msLocale:fontSignature/msLocale:defaultCodePages et characters/special/msLocale:fontSignature/msLocale:codePages :

msLocale:ansiCodePage
msLocale:ansiOemCodePage
msLocale:oemCodePage

Chacun de ces éléments est strictement un conteneur pour les éléments msLocale:codePage dont la valeur est spécifiée par l'attribut type.

Élément	Remarques
msLocale:codePage	Page de code ; doit être appropriée à l'élément dans lequel elle est contenue ; par exemple, la page de code « 1252 » est une page de code ANSI Windows et fait partie de msLocale:ansiCodePage ; la page de code « 932 » est une page de code ANSI/OEM qui fait partie de msLocale:ansiOemCodePage ; la page de code « 855 » est une page de code OEM qui appartient à msLocale:oemCodePage.

characters/special/msLocale:fontSignature/msLocale:defaultCodePages doit contenir l'un des éléments suivants :

Un seul élément msLocale:ansiOemCodePage qui contient un seul élément msLocale:codePage.
Un seul élément msLocale:ansiCodePage qui contient un seul élément msLocale:codePage et un seul élément msLocale:oemCodePage qui contient un seul élément msLocale:codePage.

Données msLocale:defaultCodePages propres à Windows. Les données characters/special/msLocale:fontSignature/msLocale:codePages sont également des informations propres à Windows. Elles répertorient toutes les pages de code qui peuvent prendre en charge la langue et le script spécifiés. Par conséquent, cette liste peut contenir plusieurs pages de codes du même type. Par exemple :

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

Les éléments du tableau suivant font partie de characters/special/msLocale:fontSignature/msLocale:scripts. Toutes les valeurs sont spécifiées par l'attribut de type. Il s'agit d'informations propres à Windows. Il n'est pas possible de définir ces données dans Windows, mais elles correspondent au retour de la fonction GetStringScripts de Windows.

Élément	Propriété/méthode	Remarques
msLocale:script	N/A	Windows uniquement ; code ISO 15924 de quatre lettres pour un script, tel « Latn » (Latin) ou « Cyrl » (Cyrillique) ; cet élément peut apparaître aussi souvent que nécessaire.

Éléments measurement

Le tableau suivant définit les éléments appartiennent à la catégorie measurement.

Élément	Propriété/méthode	Remarques
measurementSystem	IsMetric	L'attribut type a la valeur « metric » ou « US ».
paperSize	N/A	Windows uniquement ; cet élément est un conteneur pour un élément de hauteur et de largeur ; valeurs possibles : largeur = "216", hauteur = "279" (Lettre) largeur = "216", hauteur = "356" (Légal) largeur = "297", hauteur = "420" (A3) largeur = "210", hauteur = "297" (A4)

measurementSystem

IsMetric

L'attribut type a la valeur « metric » ou « US ».

paperSize

N/A

Windows uniquement ; cet élément est un conteneur pour un élément de hauteur et de largeur ; valeurs possibles :

largeur = "216", hauteur = "279" (Lettre)
largeur = "216", hauteur = "356" (Légal)
largeur = "297", hauteur = "420" (A3)
largeur = "210", hauteur = "297" (A4)

Élément dates

Le seul élément de cette catégorie est l'élément calendars. Il s'agit uniquement d'un élément conteneur.

Remarque
.NET Framework utilise des règles POSIX pour interpréter les formats de date et heure d'un élément LDML standard ou, autrement dit, d'un élément provenant de l'espace de noms LDML au lieu du schéma msLocale.Par exemple, l'indicateur AM/PM est « a ».Les éléments du schéma msLocale suivent les règles Microsoft pour les formats de date et heure.Par exemple, l'indicateur AM/PM est spécifié par le modèle de format « tt ».

.NET Framework utilise des règles POSIX pour interpréter les formats de date et heure d'un élément LDML standard ou, autrement dit, d'un élément provenant de l'espace de noms LDML au lieu du schéma msLocale.Par exemple, l'indicateur AM/PM est « a ».Les éléments du schéma msLocale suivent les règles Microsoft pour les formats de date et heure.Par exemple, l'indicateur AM/PM est spécifié par le modèle de format « tt ».

Le tableau suivant décrit des éléments qui appartiennent à la catégories dates/calendars. Toutes les valeurs sont spécifiées par l'attribut de type.

Élément	Propriété/méthode	Remarques
par défaut	AvailableCalendars	Calendrier par défaut ; l'attribut de type est « metric » ou « US » ; dans les fichiers générés par Microsoft, le calendrier par défaut correspond toujours à AvailableCalendars [0]. Valeurs possibles de calendar : "Gregorian" "Gregorian-US" "Japanese" "Taiwan" "Korean" "Hijri" "Thai" "Hebrew" "Gregorian-ME-French" "Gregorian-Arabic" "Gregorian-XLIT-English" "Gregorian-XLIT-French"
calendar	AvailableCalendars	Indicateur pour les calendriers disponibles ; cet élément peut être répété une fois par calendrier disponible ; les valeurs d'attribut de type possibles sont les mêmes que par défaut ; cet élément sert également de conteneur pour les éléments qui fournissent des données à propos du calendrier. Remarque Pour les calendriers autres que les calendriers par défaut, cet élément est normalement vide. Par conséquent, si les valeurs « Gregorian » et « Gregorian-US » sont disponibles, et que « Gregorian » est la valeur par défaut, l'élément « Gregorian-US » sera simplement <calendar type=" Gregorian-US" />.

par défaut

AvailableCalendars

Calendrier par défaut ; l'attribut de type est « metric » ou « US » ; dans les fichiers générés par Microsoft, le calendrier par défaut correspond toujours à AvailableCalendars [0].

Valeurs possibles de calendar :

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

calendar

AvailableCalendars

Indicateur pour les calendriers disponibles ; cet élément peut être répété une fois par calendrier disponible ; les valeurs d'attribut de type possibles sont les mêmes que par défaut ; cet élément sert également de conteneur pour les éléments qui fournissent des données à propos du calendrier.

Remarque Pour les calendriers autres que les calendriers par défaut, cet élément est normalement vide. Par conséquent, si les valeurs « Gregorian » et « Gregorian-US » sont disponibles, et que « Gregorian » est la valeur par défaut, l'élément « Gregorian-US » sera simplement <calendar type=" Gregorian-US" />.

Les éléments du tableau suivant appartiennent à la catégorie dates/calendars/calendar. Toutes les valeurs sont spécifiées par l'attribut de type.

Élément	Propriété/méthode	Remarques
months	N/A	Conteneur
jours	N/A	Conteneur
week	N/A	Conteneur
am	AMDesignator	CDATA spécifie le texte utilisé pour étiqueter une heure avant midi, par exemple « AM ».
pm	PMDesignator	CDATA spécifie le texte utilisé pour étiqueter une heure après midi, par exemple « PM ».
dateformat	N/A	Conteneur
timeformat	N/A	Conteneur
eras	N/A	Conteneur

Sous dates/calendars/calendar/months se trouve un seul élément monthContext qui doit avoir l'attribut de type « format ». Sous dates/calendriers/calendrier/les mois/monthContext figurent quatre éléments monthWidth.

Élément	Propriété/méthode	Remarques
monthWidth type="wide"	MonthNames	Conteneur
monthWidth type="abbreviated"	AbbreviatedMonthNames	Conteneur
monthWidth type="genitive"	MonthGenitiveNames	Conteneur
monthWidth type="genitiveAbbreviated"	AbbreviatedMonthGenitiveNames	Conteneur

Sous dates/calendars/calendar/months/monthContext/monthWidth doit figurer un élément month pour chaque mois de l'année. Il doit y en avoir 12 ou 13, selon le calendrier. Pour chaque élément month, le type correspond au numéro du mois et le type CDATA indique la chaîne pertinente. Par exemple :

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

Sous dates/calendars/calendar/days se trouve un seul élément dayContext qui doit avoir l'attribut de type « format ». Sous dates/calendars/calendar/days/dayContext doivent figurer trois éléments dayWidth.

Élément	Propriété/méthode	Remarques
dayWidth type="wide"	DayNames	Conteneur
dayWidth type="abbreviated"	AbbreviatedDayNames	Conteneur
dayWidth type="shorter"	ShortestDayNames	Conteneur

Sous dates/calendars/calendar/days/dayContext/dayWidth, il doit y avoir un élément day pour chaque jour de la semaine. Pour chaque élément day, le type correspond à l'une des valeurs « sun », « mon », « tue », « wed », « thu », « fri », « sat ». Le type CDATA indique la chaîne pertinente. Par exemple :

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

Les éléments du tableau suivant appartiennent à la catégorie dates/calendars/calendar/week.

Élément	Propriété/méthode	Remarques
firstDay	FirstDayOfWeek	L'attribut day doit avoir l'une des valeurs suivantes : « sun », « mon », « tue », « wed », « thu », « fri », « sat ».
special	N/A	Conteneur ; tout le contenu vient du schéma msLocale.

Les éléments du tableau suivant appartiennent à la catégorie dates/calendars/calendar/week/special.

Élément	Propriété/méthode	Remarques
msLocale:weekRule	CalendarWeekRule	L'attribut de type doit avoir l'une des valeurs suivantes : firstDay firstFourDayWeek firstFullWeek

msLocale:weekRule

CalendarWeekRule

L'attribut de type doit avoir l'une des valeurs suivantes :

firstDay
firstFourDayWeek
firstFullWeek

L'élément du tableau suivant appartient à la catégorie dates/calendars/calendar/dateformats.

Élément	Remarques
special	Conteneur ; tout le contenu vient du schéma msLocale.

Les éléments du tableau suivant appartiennent à la catégorie dates/calendars/calendar/dateformats/special. Toutes les valeurs sont spécifiées par l'attribut de type.

Élément	Propriété/méthode	Remarques
msLocale:dateFormatLength type="long"	GetAllDateTimePatterns('D')	Conteneur
msLocale:dateFormatLength type="short"	GetAllDateTimePatterns('d')	Conteneur
msLocale:yearMonth	GetAllDateTimePatterns('Y')	Un conteneur pour chaque modèle DateTime pertinent ; l'attribut de type spécifie un index de base zéro unique; il ne doit pas y avoir d'espaces vides.
msLocale:monthDay	MonthDayPattern	Conteneur

Les éléments du tableau suivant font partie de dates/calendars/calendar/dateformats/special/msLocale:dateFormatLength. Toutes les valeurs sont spécifiées par l'attribut de type.

Élément	Propriété/méthode	Remarques
msLocale:default	N/A	Valeur qui correspond à l'attribut de type du format par défaut ; dans les fichiers LDML générés par Microsoft, il s'agit toujours de « 0 ».
msLocale:dateFormat	GetAllDateTimePatterns ('D'), GetAllDateTimePatterns ('d')	Conteneur pour chaque modèle de format DateTime pertinent ; l'attribut de type spécifie un index de base zéro unique ; il ne doit pas y avoir d'espaces vides.

Les éléments suivants sont des conteneurs pour les éléments msLocale:pattern qui fournissent leurs valeurs sous forme de types CDATA :

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

Par exemple :

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

L'élément du tableau suivant appartient à la catégorie dates/calendars/calendar/timeformats.

Élément	Remarques
special	Conteneur ; tout le contenu vient du schéma msLocale.

Les éléments du tableau suivant appartiennent à la catégorie dates/calendars/calendar/timeformats/special. Toutes les valeurs sont spécifiées par l'attribut de type.

Élément	Propriété/méthode	Remarques
msLocale:durationFormats	N/A	Windows uniquement ; conteneur
msLocale:timeFormatLength type="long"	GetAllDateTimePatterns('T')	Conteneur
msLocale:timeFormatLength type="short"	GetAllDateTimePatterns('t')	Conteneur

Les éléments du tableau suivant font partie de dates/calendars/calendar/dateformats/special/msLocale:durationFormats. Toutes les valeurs sont spécifiées par l'attribut de type.

Élément	Propriété/méthode	Remarques
msLocale:default	N/A	Windows uniquement : valeur qui correspond à l'attribut de type du format par défaut ; dans les fichiers LDML générés par Microsoft, il s'agit toujours de « 0 ».
msLocale:durationFormat	N/A	Windows uniquement. Conteneur pour chaque valeur DateTime pertinente ; l'attribut de type spécifie un index de base zéro unique ; il ne doit pas y avoir d'espaces vides.

Les éléments du tableau suivant font partie de dates/calendars/calendar/dateformats/special/msLocale:timeFormatLength. Toutes les valeurs sont spécifiées par l'attribut de type.

Élément	Propriété/méthode	Remarques
msLocale:default	N/A	Valeur qui correspond à l'attribut de type du format par défaut ; dans les fichiers générés par Microsoft, la valeur par défaut est toujours « 0 ».
msLocale:timeFormat	GetAllDateTimePatterns ('T'), GetAllDateTimePatterns ('t')	Conteneur pour chaque valeur DateTime pertinente ; l'attribut de type spécifie un index de base zéro unique ; il ne doit pas y avoir d'espaces vides.

Les éléments suivants sont des conteneurs pour les éléments msLocale:pattern qui fournissent leurs valeurs sous forme de types CDATA :

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

Par exemple :

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

Les éléments contenus dans le tableau suivant font partie de dates/calendars/calendar/eras.

Élément	Propriété/méthode	Remarques
eraAbbr	GetEraName	Conteneur
eraNames	GetAbbreviatedEraName	Conteneur

Un élément d'ère pour chaque ère doit se trouver au-dessous de dates/calendars/calendar/eras/eraAbbr et de dates/calendars/calendar/eras/eraNames. Pour chaque élément d'ère, le type est le nombre de l'ère et le type CDATA indique la chaîne correspondante. Par exemple :

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

Éléments numériques

Le tableau suivant définit les éléments numériques.

Élément	Remarques
symbols	Conteneur
currencies	Conteneur
special	Conteneur ; tout le contenu vient du schéma msLocale.

Éléments numbers/symbols

Les éléments du tableau suivant appartiennent à la catégorie numbers/symbols. Sauf pour les cas mentionnés, ces éléments produisent leurs données en tant que type CDATA.

Élément	Propriété/méthode	Remarques
decimal	NumberDecimalSeparator	Exemple : "."
group	NumberGroupSeparator	Exemple : ","
list	TextInfo.ListSeparator	Exemple : ";"
percentSign	PercentSymbol	Exemple : "%"
infinity type="positive"	PositiveInfinitySymbol,	Exemple : "Infinity"
infinity type="negative"	NegativeInfinitySymbol	Exemple : "-Infinity"
nan	NaNSymbol	Symbole "pas un nombre" Exemple : "NaN".
special	N/A	Conteneur ; tout le contenu vient du schéma msLocale.

Les éléments du tableau suivant appartiennent à la catégorie numbers/symbols/special. Sauf pour les cas mentionnés, ces éléments produisent leurs données en tant que type CDATA.

Élément	Propriété/méthode	Remarques
msLocale:currencyDecimalSeparator	CurrencyDecimalSeparator	Exemple : "."
msLocale:currencyGroupSeparator	CurrencyGroupSeparator	Exemple : ","
msLocale:leadingZero	N/A	Windows uniquement ; pas de CDATA ; l'attribut type doit avoir la valeur « yes » ou « no » pour autoriser ou interdire les zéros non significatifs.

Par exemple :

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

Éléments numbers/currencies

L'élément du tableau suivant appartient à la catégorie numbers/currencies.

Élément	Remarques
currency	Conteneur ; l'attribut de type doit avoir la valeur « default »

Les éléments du tableau suivant appartiennent à la catégorie numbers/currencies/currency. Sauf pour les cas mentionnés, ces éléments produisent leurs données en tant que type CDATA.

Élément	Propriété/méthode	Remarques
symbole	ISOCurrencySymbol	Exemple : "$"
displayName	CurrencyNativeName	Exemple : "Dollar"
special	N/A	Conteneur ; tout le contenu vient du schéma msLocale.

Les éléments du tableau suivant appartiennent à la catégorie numbers/currencies/currency/special. Sauf pour les cas mentionnés, ces éléments produisent leurs données en tant que type CDATA.

Élément	Propriété/méthode	Remarques
msLocale:isoCurrency	ISOCurrencySymbol	Exemple : « USD »
msLocale:currencyEnglishName	CurrencyEnglishName	Exemple : "Dollar"

Par exemple :

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

Les éléments du tableau suivant appartiennent à la catégorie numbers/currencies/special. Sauf indication contraire, toutes les valeurs sont spécifiées par l'attribut de type.

Élément	Propriété/méthode	Remarques
msLocale:decimalDigits	NumberDecimalDigits	Nombre de décimales à utiliser dans les valeurs numériques, spécifié sous forme CDATA ; exemple : « 2 »
msLocale:negativePattern	NumberNegativePattern	Modèle de format pour les valeurs numériques négatives.
msLocale:currencyDecimalDigits	CurrencyDecimalDigits	Nombre de décimales à utiliser dans les valeurs monétaires ; par opposition à msLocale:decimalDigits, cet élément est spécifié dans l'attribut de type. Exemple : « 2 »
msLocale:currencyPositivePattern	CurrencyPositivePattern	Modèle de format pour les valeurs monétaires positives.
msLocale:currencyNagativePattern	CurrencyNegativePattern	Modèle de format pour les valeurs monétaires négatives.
msLocale:percentPositivePattern	PercentPositivePattern	Modèle de format pour les valeurs de pourcentage positives.
msLocale:percentNagativePattern	PercentNegativePattern	Modèle de format pour les valeurs de pourcentage négatives.
msLocale:groupSizes	NumberGroupSizes	Nombre de chiffres dans chaque groupe à gauche des décimales dans les valeurs numériques ; la taille de regroupement réelle est spécifiée sous forme CDATA ; l'attribut de type sert à le sérialiser ; le nombre de ces éléments n'est pas limité ; ils peuvent tous avoir un attribut de type unique, sérialisé à partir de « 0 » ; la valeur démarre à partir du groupe de chiffres de poids faible.
msLocale:nativeDigits	NativeDigits	Chiffres natifs qui équivalent aux chiffres occidentaux de 0 à 9, un pour chaque chiffre ; l'attribut de type est un chiffre de « 0 » à « 9 » ; le type CDATA spécifie le caractère utilisé pour représenter un chiffre.
msLocale:digitSubstitution	DigitSubstitution	Valeur qui spécifie comment l'interface utilisateur graphique affiche la forme d'un chiffre ; les paramètres valides pour l'attribut de type sont : "context" (valeur par défaut) "none" (toujours utiliser un chiffre compris entre "0" et "9") "nativeNational" (toujours substituer)

Par exemple :

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

Voir aussi

Référence

CultureAndRegionInfoBuilder

Partager via

Description d'une culture avec des données LDML

Éléments propres à Windows

Éléments identity

Élément layout

Élément characters

Éléments measurement

Élément dates

Éléments numériques

Éléments numbers/symbols

Éléments numbers/currencies

Voir aussi

Référence

Ressources supplémentaires