LDML 데이터를 사용하여 Culture 설명

아티클
08/09/2011

응용 프로그램에서 Save를 사용하여 문화권을 저장하면 CultureAndRegionInfoBuilder 개체가 LDML(Locale Data Markup Language) 버전 1.1 형식에 따라 XML로 표현됩니다. CreateFromLdml 메서드는 Save와 반대로 이 XML 파일에서 로드합니다.

문화권을 설명하는 대부분의 의미 있는 데이터는 XML 파일 내의 special 요소에 포함되어 있습니다. LDML special 요소는 제품별 주석 및 데이터를 포함할 수 있습니다.

.NET Framework에서는 msLocale 스키마(https://schemas.microsoft.com/globalization/2005/carib/ldml)에서 가져온 데이터가 들어 있는 특수 요소를 사용합니다. 일반적인 스키마와 같이 이 URI는 고유 이름을 제공하지만 실제 문서의 URL이 아닙니다.

대부분의 관련 XML 요소는 CultureAndRegionInfoBuilder 및 CultureInfo와 같이 문화권을 설명하는 클래스의 속성이나 메서드의 반환 값에 해당합니다. 일부 요소는 .NET Framework가 아닌 Windows와 관련되며 CultureAndRegionInfoBuilder의 속성으로 포함되지 않습니다.

LDML 표준에 대한 자세한 내용은 Unicode Home Page의 Unicode Technical Standard #35, "Locale Data Markup Language (LDML)"를 참조하십시오.

Windows 전용 요소

이 항목의 일부 요소는 "Windows 전용"으로 설명되어 있습니다. 이러한 요소는 비관리 Windows 코드와 관련되며 .NET Framework와는 관련이 없습니다. 응용 프로그램이 .NET Framework 외부에서 LDML 파일을 만든 다음 프레임워크를 사용하여 등록하면 해당 파일을 .NET Framework뿐 아니라 Windows에서도 사용할 수 있게 됩니다. 응용 프로그램이 .NET Framework에서 기존 문화권 정의로 시작하여 이를 수정하고 사용자 지정 문화권으로 저장하면 Windows 전용 요소가 원래 문화권에서 저장된 문화권으로 그대로 전달됩니다.

identity 요소

다음 표에서는 identity 요소를 보여 줍니다.

요소	참고
version	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	중립 문화권에만 사용되며, type은 항상 "neutral"입니다.
msLocale:cultureInfoVersion	N/A	현재는 "1.0"입니다.
msLocale:geoId	GeoId	예: "244". 이 값은 type 특성이 아닌 텍스트 CDATA로 지정됩니다.
msLocale:parentName	Parent	예: "en"
msLocale:specificCulture	CreateSpecificCulture	예: "en-US". 기본 특정 문화권을 나타내는 중립 문화권에만 관련됩니다.
msLocale:languageNameAbbr	ThreeLetterWindowsLanguageName	예: "ENU"
msLocale:languageIsoName type="threeLetters"	ThreeLetterISOLanguageName	예: "eng". 이 값은 type 특성이 아닌 텍스트 CDATA로 지정됩니다. type은 "threeLetters"입니다.
msLocale:languageIsoName type="twoLetters"	TwoLetterISOLanguageName	예: "en". 이 값은 type 특성이 아닌 텍스트 CDATA로 지정됩니다. type은 "twoLetters"입니다.
msLocale:nativeDisplayName	CultureNativeName	예: "English(United States)", "Deutsch(Deutschland)"
msLocale:englishName	CultureEnglishName	예: "English(United States)", "German(Germany)"
msLocale:countryCode	N/A	Windows 전용이며 값은 CDATA로 지정됩니다. 캐나다(코드 2)의 경우를 제외하고 이 값은 전화 통신용 국제 전화 코드와 동일합니다. Windows에서 LCTYPE을 LOCALE_ICOUNTRY로 지정하여 GetLocaleInfo 또는 GetLocaleInfoEx를 통해 이 값에 액세스할 수 있습니다.
msLocale:regionNativeName	RegionNativeName	예: " United States", " Deutschland"
msLocale:regionEnglishName	RegionEnglishName	예: " United States", " Germany"
msLocale:regionIsoName type="threeLetters"	ThreeLetterISORegionName	예: "USA". 이 값은 type 특성이 아닌 텍스트 CDATA로 지정됩니다. type은 "threeLetters"입니다.
msLocale:regionIsoName type="twoLetters"	TwoLetterISORegionName	예: "US". 이 값은 type 특성이 아닌 텍스트 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	N/A	msLocale 스키마에서 가져온 추가 콘텐츠가 들어 있는 컨테이너입니다.
mslocale:scripts	N/A	msLocale 스키마에서 가져온 추가 콘텐츠가 들어 있는 컨테이너입니다.

characters/special/msLocale:fontSignature에는 다음 요소가 포함됩니다.

msLocale:unicodeRanges
msLocale:defaultCodePages
msLocale:codePages

이러한 각 요소는 실제로는 msLocale 스키마에서 가져온 추가 콘텐츠가 들어 있는 컨테이너입니다.

다음 표에서는 characters/special/msLocale:fontSignature/msLocale:unicodeRanges에 포함되는 요소를 보여 줍니다. 모든 값은 type 특성으로 지정됩니다. 이는 Windows 전용 정보이며, 부분적으로 Windows의 LOCALESIGNATURE 구조체에 해당합니다.

요소	속성/메서드	참고
msLocale:range	N/A	Windows 전용이며, Windows의 FONTSIGNATURE 구조체에 들어 있는 USB(Unicode Subset Bitfield)의 비트 숫자를 나타내는 0에서 122 사이의 값입니다.
msLocale:layoutProgress	N/A	Windows 전용이며, 사용할 수 있는 값은 다음과 같습니다. "horizontalRightToLeft" "verticalBeforeHorizontal" "verticalBottomToTop"

msLocale:range

N/A

Windows 전용이며, Windows의 FONTSIGNATURE 구조체에 들어 있는 USB(Unicode Subset Bitfield)의 비트 숫자를 나타내는 0에서 122 사이의 값입니다.

msLocale:layoutProgress

N/A

Windows 전용이며, 사용할 수 있는 값은 다음과 같습니다.

"horizontalRightToLeft"
"verticalBeforeHorizontal"
"verticalBottomToTop"

characters/special/msLocale:fontSignature/msLocale:defaultCodePages 및 characters/special/msLocale:fontSignature/msLocale:codePages에는 다음 요소가 포함됩니다.

msLocale:ansiCodePage
msLocale:ansiOemCodePage
msLocale:oemCodePage

이러한 각 요소는 실제로는 값이 type 특성으로 지정된 msLocale:codePage 요소가 들어 있는 컨테이너입니다.

요소	참고
msLocale:codePages	코드 페이지이며, 자신이 포함된 요소와 맞아야 합니다. 예를 들어 코드 페이지 "1252"는 Windows ANSI 코드 페이지이며 msLocale:ansiCodePage에 속하고, 코드 페이지 "932"는 ANSI/OEM 코드 페이지이며 msLocale:ansiOemCodePage에 속하고, 코드 페이지 "855"는 OEM 코드 페이지며 msLocale:oemCodePage에 속합니다.

characters/special/msLocale:fontSignature/msLocale:defaultCodePages에는 다음 중 하나가 포함되어야 합니다.

단일 msLocale:codePage 요소가 들어 있는 단일 msLocale:ansiOemCodePage 요소
단일 msLocale:codePage 요소가 들어 있는 단일 msLocale:ansiCodePage 요소 및 단일 msLocale:codePage 요소가 들어 있는 단일 msLocale:oemCodePage 요소

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	N/A	Windows 전용이며, "Latn"(라틴어) 또는 "Cyrl"(키릴 자모)과 같이 스크립트에 대한 4글자 IS0 15924 코드입니다. 이 요소는 여러 번 나올 수 있습니다.

measurement 요소

다음 표에서는 measurement에 포함되는 요소를 정의합니다.

요소	속성/메서드	참고
measurementSystem	IsMetric	type 특성은 "metric" 또는 "US" 중 하나입니다.
paperSize	N/A	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

N/A

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 요소의 날짜 및 시간 형식을 해석합니다. 즉, msLocale 스키마가 아닌 LDML 네임스페이스에서 요소를 가져옵니다.예를 들어 AM/PM 표시 문자는 "a"입니다.msLocale 스키마의 요소는 Microsoft 규칙의 날짜 및 시간 형식을 따릅니다.예를 들어 AM/PM 지정자는 "tt" 형식 패턴으로 지정됩니다.

.NET Framework에서는 POSIX 규칙에 따라 표준 LDML 요소의 날짜 및 시간 형식을 해석합니다. 즉, msLocale 스키마가 아닌 LDML 네임스페이스에서 요소를 가져옵니다.예를 들어 AM/PM 표시 문자는 "a"입니다.msLocale 스키마의 요소는 Microsoft 규칙의 날짜 및 시간 형식을 따릅니다.예를 들어 AM/PM 지정자는 "tt" 형식 패턴으로 지정됩니다.

다음 표에서는 dates/calendars에 포함되는 요소를 보여 줍니다. 모든 값은 type 특성으로 지정됩니다.

요소	속성/메서드	참고
default	AvailableCalendars	기본 달력으로, type 특성은 "metric" 또는 "US"입니다. Microsoft에서 생성한 파일의 경우 기본 달력은 항상 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 특성 값은 default 요소와 같으며, 이 요소는 달력에 대한 데이터를 제공하는 요소의 컨테이너 역할도 합니다. 기본값이 아닌 달력의 경우 이 요소는 일반적으로 비어 있습니다. 따라서 "Gregorian"과 "Gregorian-US"를 모두 사용할 수 있으면 "Gregorian"이 기본값이고 "Gregorian-US"에 대한 요소는 단순히 <calendar type=" Gregorian-US" />가 됩니다.

default

AvailableCalendars

기본 달력으로, type 특성은 "metric" 또는 "US"입니다. Microsoft에서 생성한 파일의 경우 기본 달력은 항상 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 특성 값은 default 요소와 같으며, 이 요소는 달력에 대한 데이터를 제공하는 요소의 컨테이너 역할도 합니다.

기본값이 아닌 달력의 경우 이 요소는 일반적으로 비어 있습니다. 따라서 "Gregorian"과 "Gregorian-US"를 모두 사용할 수 있으면 "Gregorian"이 기본값이고 "Gregorian-US"에 대한 요소는 단순히 <calendar type=" Gregorian-US" />가 됩니다.

다음 표에서는 dates/calendars/calendar에 포함되는 요소를 보여 줍니다. 모든 값은 type 특성으로 지정됩니다.

요소	속성/메서드	참고
months	N/A	컨테이너입니다.
days	N/A	컨테이너입니다.
week	N/A	컨테이너입니다.
am	AMDesignator	"AM"과 같이 오전 시간의 레이블로 사용되는 텍스트를 지정하는 CDATA입니다.
pm	PMDesignator	"PM"과 같이 오후 시간의 레이블로 사용되는 텍스트를 지정하는 CDATA입니다.
dateformat	N/A	컨테이너입니다.
timeformat	N/A	컨테이너입니다.
eras	N/A	컨테이너입니다.

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에는 1년의 각 달에 대해 month 요소가 하나씩 포함되어야 합니다. 달력에 따라 이 요소가 12개 또는 13개 있습니다. 각 month 요소에서 type은 월 번호이고 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 요소가 하나씩 포함됩니다. 각 day 요소에 대해 type 값은 "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	N/A	컨테이너이며, 모든 콘텐츠는 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 특성은 고유한 인덱스(0부터 시작)을 지정하며, 빈 인덱스가 없어야 합니다.
msLocale:monthDay	MonthDayPattern	컨테이너입니다.

다음 표에서는 dates/calendars/calendar/dateformats/special/msLocale:dateFormatLength에 포함되는 요소를 보여 줍니다. 모든 값은 type 특성으로 지정됩니다.

요소	속성/메서드	참고
msLocale:default	N/A	기본 형식의 type 특성에 해당하는 값으로, Microsoft에서 생성한 LDML 파일에서는 기본값이 항상 "0"입니다.
msLocale:dateFormat	GetAllDateTimePatterns ('D'), GetAllDateTimePatterns ('d')	관련된 각 DateTime 형식에 대한 컨테이너입니다. type 특성은 고유한 인덱스(0부터 시작)을 지정하며, 빈 인덱스가 없어야 합니다.

다음 요소는 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	N/A	Windows 전용이며 컨테이너입니다.
msLocale:timeFormatLength type="long"	GetAllDateTimePatterns('T')	컨테이너입니다.
msLocale:timeFormatLength type="short"	GetAllDateTimePatterns('t')	컨테이너입니다.

다음 표에서는 dates/calendars/calendar/dateformats/special/msLocale:durationFormats에 포함되는 요소를 보여 줍니다. 모든 값은 type 특성으로 지정됩니다.

요소	속성/메서드	참고
msLocale:default	N/A	Windows 전용이며, 기본 형식의 type 특성에 해당하는 값입니다. Microsoft에서 생성한 파일에서는 기본값이 항상 "0"입니다.
msLocale:durationFormat	N/A	Windows 전용. 관련된 각 DateTime 값에 대한 컨테이너입니다. type 특성은 고유한 인덱스(0부터 시작)을 지정하며, 빈 인덱스가 없어야 합니다.

다음 표에서는 dates/calendars/calendar/dateformats/special/msLocale:timeFormatLength에 포함되는 요소를 보여 줍니다. 모든 값은 type 특성으로 지정됩니다.

요소	속성/메서드	참고
msLocale:default	N/A	기본 형식의 type 특성에 해당하는 값으로, Microsoft에서 생성한 파일에서는 기본값이 항상 "0"입니다.
msLocale:timeFormat	GetAllDateTimePatterns ('T'), GetAllDateTimePatterns ('t')	관련된 각 DateTime 값에 대한 컨테이너입니다. type 특성은 고유한 인덱스(0부터 시작)을 지정하며, 빈 인덱스가 없어야 합니다.

다음 요소는 msLocale:pattern 요소에 대한 컨테이너이며 해당 값이 CDATA 형식으로 지정됩니다.

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	컨테이너입니다.

ates/calendars/calendar/eras/eraAbbr 및 dates/calendars/calendar/eras/eraNames에는 모두 각 era에 대해 era 요소가 하나씩 포함되어야 합니다. 각 era 요소에서 type은 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	N/A	컨테이너이며, 모든 콘텐츠는 msLocale 스키마에서 가져옵니다.

다음 표에서는 numbers/symbols/special에 포함되는 요소를 보여 줍니다. 별도로 언급하지 않는 한 이러한 속성의 데이터는 CDATA 형식으로 지정됩니다.

요소	속성/메서드	참고
msLocale:currencyDecimalSeparator	CurrencyDecimalSeparator	예: "."
msLocale:currencyGroupSeparator	CurrencyGroupSeparator	예: ","
msLocale:leadingZero	N/A	Windows 전용이며 CDATA가 아닙니다. type 특성은 "yes"(앞에 0이 올 수 있음) 또는 "no"(앞에 0이 올 수 없음) 중 하나여야 합니다.

예를 들면 다음과 같습니다.

<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	예: "Dollar"
special	N/A	컨테이너이며, 모든 콘텐츠는 msLocale 스키마에서 가져옵니다.

다음 표에서는 numbers/currencies/currency/special에 포함되는 요소를 보여 줍니다. 별도로 언급하지 않는 한 이러한 속성의 데이터는 CDATA 형식으로 지정됩니다.

요소	속성/메서드	참고
msLocale:isoCurrency	ISOCurrencySymbol	예: "USD"
msLocale:currencyEnglishName	CurrencyEnglishName	예: "Dollar"

예를 들면 다음과 같습니다.

<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 특성은 이 요소에 일련 번호를 부여합니다. 이러한 요소는 개수에 제한 없이 여러 개가 있을 수 있으며 각 요소에는 "0"부터 시작되는 일련 번호가 부여된 고유한 type 특성이 있습니다. 값은 최하위 그룹 자릿수에서 시작됩니다.
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 데이터를 사용하여 Culture 설명

Windows 전용 요소

identity 요소

layout 요소

characters 요소

measurement 요소

dates 요소

numbers 요소

numbers/symbols에 포함되는 요소

numbers/currencies에 포함되는 요소

참고 항목

참조

추가 리소스