The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Locale Information Constants

This section defines the constants that NLS uses to specify particular pieces of locale information. All the names begin with "LOCALE_". Names of constants that represent integer values begin with "LOCALE_I". All values for these constants are null-terminated Unicode strings. Maximum string lengths include the terminating null character. If no maximum length is indicated for a constant, its values can vary in length.

The following locale information constants are defined by NLS:

LOCALE_ALL

LOCALE_ALLOW_NEUTRAL

LOCALE_ALLOW_NEUTRAL_NAMES

LOCALE_ALTERNATE_SORTS

LOCALE_CUSTOM* Constants

LOCALE_IDEFAULT* Constants

LOCALE_IDIALINGCODE

LOCALE_IDIGITS

LOCALE_IDIGITSUBSTITUTION

LOCALE_IFIRSTDAYOFWEEK

LOCALE_IFIRSTWEEKOFYEAR

LOCALE_IGEOID

LOCALE_IINTLCURRDIGITS

LOCALE_INEG* Constants

LOCALE_INEGATIVEPERCENT

LOCALE_INEUTRAL

LOCALE_INVARIANT

LOCALE_IOPTIONALCALENDAR

LOCALE_IPAPERSIZE

LOCALE_IPOSITIVEPERCENT

LOCALE_IPOS* Constants

LOCALE_IREADINGLAYOUT

LOCALE_ITIME

LOCALE_ITIMEMARKPOSN

LOCALE_ITLZERO

LOCALE_NAME* Constants

LOCALE_NEUTRAL

LOCALE_NEUTRALDATA

LOCALE_NOUSEROVERRIDE

LOCALE_REPLACEMENT

LOCALE_RETURN* Constants

LOCALE_S1159

LOCALE_S2359

LOCALE_SABBREV* Constants

LOCALE_SAM

LOCALE_SCONSOLEFALLBACKNAME

LOCALE_SCOUNTRY

LOCALE_SCURRENCY

LOCALE_SDATE

LOCALE_SDAYNAME* Constants

LOCALE_SDECIMAL

LOCALE_SDURATION

LOCALE_SENG* Constants

LOCALE_SENGLISH* Constants

LOCALE_SGROUPING

LOCALE_SIETFLANGUAGE

LOCALE_SINTLSYMBOL

LOCALE_SISO* Constants

LOCALE_SKEYBOARDSTOINSTALL

LOCALE_SLANGDISPLAYNAME

LOCALE_SLANGUAGE

LOCALE_SLIST

LOCALE_SLOCALIZED* Constants

LOCALE_SLONGDATE

LOCALE_SMON* Constants

LOCALE_SMONTHDAY

LOCALE_SMONTHNAME* Constants

LOCALE_SNAME

LOCALE_SNAN

LOCALE_SNATIVE* Constants

LOCALE_SNEGATIVESIGN

LOCALE_SNEGINFINITY

LOCALE_SOPENTYPELANGUAGETAG

LOCALE_SSHORTESTDAYNAME* Constants

LOCALE_SSHORTESTPM

LOCALE_SSHORTTIME

LOCALE_SSORT* Constants

LOCALE_STHOUSAND

LOCALE_STIME* Constants

LOCALE_SUPPLEMENTAL

LOCALE_SYEARMONTH

LOCALE_SYSTEM_DEFAULT

LOCALE_USE_CP_ACP

LOCALE_USER_DEFAULT

LOCALE_WINDOWS

Combining Constants

The following constants can be combined with other constants using the binary OR operator. The remainder of the constants are mutually exclusive, and therefore cannot be combined with one another.

LOCALE_NOUSEROVERRIDE
LOCALE_RETURN_NUMBER
LOCALE_USE_CP_ACP

Default and Neutral Locale Identifier Constants

The following constants represent default and neutral locale identifiers.

LOCALE_CUSTOM_DEFAULT
LOCALE_CUSTOM_UI_DEFAULT
LOCALE_CUSTOM_UNSPECIFIED
LOCALE_INVARIANT
LOCALE_NEUTRAL
LOCALE_SYSTEM_DEFAULT
LOCALE_USER_DEFAULT

Locale Name Constants

The following constants are used to specify a locale name. They are used by functions such as GetLocaleInfoEx.

LOCALE_NAME_INVARIANT
LOCALE_NAME_SYSTEM_DEFAULT
LOCALE_NAME_USER_DEFAULT

Locale Definition Constants

The following constants define the locale for NLS functions such as EnumSystemLocalesEx and EnumLocalesProcEx.

LOCALE_ALL
LOCALE_ALTERNATE_SORTS
LOCALE_REPLACEMENT
LOCALE_SUPPLEMENTAL
LOCALE_WINDOWS

Constants Used in the LCType Parameter of GetLocaleInfo, GetLocaleInfoEx, and SetLocaleInfo

This section lists the locale information constants that the application can use for the LCType parameter of GetLocaleInfo (Windows Me/98, Windows NT 4.0), GetLocaleInfoEx (Windows Vista), and SetLocaleInfo. The locale information is passed either as strings (default) or as integers. An integer value is specified by using the binary OR operator to combine a particular constant with a combining constant. See Combining Constants.

Constants Used by GetLocaleInfo and GetLocaleInfoEx Only

GetLocaleInfo and GetLocaleInfoEx use the following constants to retrieve certain pieces of locale information that SetLocaleInfo cannot set. These constants are mutually exclusive of one another and of the constants used by both SetLocaleInfo and GetLocaleInfo/GetLocaleInfoEx. However, they can be combined with the combining constants using the binary OR operator. See Combining Constants.

LOCALE_FONTSIGNATURE
LOCALE_ICENTURY
LOCALE_ICOUNTRY
LOCALE_IDATE
LOCALE_IDAYLZERO
LOCALE_IDEFAULTANSICODEPAGE
LOCALE_IDEFAULTCODEPAGE
LOCALE_IDEFAULTCOUNTRY
LOCALE_IDEFAULTEBCDICCODEPAGE
LOCALE_IDEFAULTLANGUAGE
LOCALE_IDEFAULTMACCODEPAGE
LOCALE_IDIALINGCODE
LOCALE_IGEOID
LOCALE_IINTLCURRDIGITS
LOCALE_ILANGUAGE
LOCALE_ILDATE
LOCALE_IMONLZERO
LOCALE_INEGATIVEPERCENT
LOCALE_INEGSEPBYSPACE
LOCALE_INEGSIGNPOSN
LOCALE_INEGSYMPRECEDES
LOCALE_IOPTIONALCALENDAR
LOCALE_IPOSITIVEPERCENT
LOCALE_IPOSSEPBYSPACE
LOCALE_IPOSSIGNPOSN
LOCALE_IPOSSYMPRECEDES
LOCALE_ITIMEMARKPOSN
LOCALE_ITLZERO
LOCALE_SABBREVCTRYNAME
LOCALE_SABBREVDAYNAME1
LOCALE_SABBREVDAYNAME2
LOCALE_SABBREVDAYNAME3
LOCALE_SABBREVDAYNAME4
LOCALE_SABBREVDAYNAME5
LOCALE_SABBREVDAYNAME6
LOCALE_SABBREVDAYNAME7
LOCALE_SABBREVLANGNAME
LOCALE_SABBREVMONTHNAME1
LOCALE_SABBREVMONTHNAME2
LOCALE_SABBREVMONTHNAME3
LOCALE_SABBREVMONTHNAME4
LOCALE_SABBREVMONTHNAME5
LOCALE_SABBREVMONTHNAME6
LOCALE_SABBREVMONTHNAME7
LOCALE_SABBREVMONTHNAME8
LOCALE_SABBREVMONTHNAME9
LOCALE_SABBREVMONTHNAME10
LOCALE_SABBREVMONTHNAME11
LOCALE_SABBREVMONTHNAME12
LOCALE_SABBREVMONTHNAME13
LOCALE_SCONSOLEFALLBACKNAME
LOCALE_SDAYNAME1
LOCALE_SDAYNAME2
LOCALE_SDAYNAME3
LOCALE_SDAYNAME4
LOCALE_SDAYNAME5
LOCALE_SDAYNAME6
LOCALE_SDAYNAME7
LOCALE_SDURATION
LOCALE_SENGCURRNAME
LOCALE_SENGLISHCOUNTRYNAME
LOCALE_SENGLISHDISPLAYNAME
LOCALE_SENGLISHLANGUAGENAME
LOCALE_SINTLSYMBOL
LOCALE_SIETFLANGUAGE
LOCALE_SISO3166CTRYNAME
LOCALE_SISO3166CTRYNAME2
LOCALE_SISO639LANGNAME
LOCALE_SISO639LANGNAME2
LOCALE_SKEYBOARDSTOINSTALL
LOCALE_SMONTHNAME1
LOCALE_SMONTHNAME2
LOCALE_SMONTHNAME3
LOCALE_SMONTHNAME4
LOCALE_SMONTHNAME5
LOCALE_SMONTHNAME6
LOCALE_SMONTHNAME7
LOCALE_SMONTHNAME8
LOCALE_SMONTHNAME9
LOCALE_SMONTHNAME10
LOCALE_SMONTHNAME11
LOCALE_SMONTHNAME12
LOCALE_SMONTHNAME13
LOCALE_SNAME
LOCALE_SNAN
LOCALE_SNATIVECOUNTRYNAME
LOCALE_SNATIVECURRNAME
LOCALE_SNATIVEDISPLAYNAME
LOCALE_SNATIVELANGUAGENAME
LOCALE_SNEGINFINITY
LOCALE_SPARENT
LOCALE_SPERCENT
LOCALE_SPOSINFINITY
LOCALE_SSCRIPTS
LOCALE_SSHORTESTAM
LOCALE_SSHORTESTDAYNAME1
LOCALE_SSHORTESTDAYNAME2
LOCALE_SSHORTESTDAYNAME3
LOCALE_SSHORTESTDAYNAME4
LOCALE_SSHORTESTDAYNAME5
LOCALE_SSHORTESTDAYNAME6
LOCALE_SSHORTESTDAYNAME7
LOCALE_SSHORTESTPM
LOCALE_SSORTNAME

Constants Used by Both SetLocaleInfo and GetLocaleInfo/GetLocaleInfoEx

SetLocaleInfo uses the following constants to set particular pieces of user locale information, and GetLocaleInfo or GetLocaleInfoEx uses these same constants to retrieve those pieces of information. These constants are mutually exclusive of one another and of the constants used by GetLocaleInfo or GetLocaleInfoEx only. However, they can be combined with the combining constants using the binary OR operator. See Combining Constants.

LOCALE_ICALENDARTYPE
LOCALE_ICURRDIGITS
LOCALE_ICURRENCY
LOCALE_IDIGITS
LOCALE_IDIGITSUBSTITUTION
LOCALE_IFIRSTDAYOFWEEK
LOCALE_IFIRSTWEEKOFYEAR
LOCALE_ILZERO
LOCALE_IMEASURE
LOCALE_INEGCURR
LOCALE_INEGNUMBER
LOCALE_IPAPERSIZE
LOCALE_IREADINGLAYOUT
LOCALE_ITIME
LOCALE_S1159
LOCALE_S2359
LOCALE_SAM
LOCALE_SCURRENCY
LOCALE_SDATE
LOCALE_SDECIMAL
LOCALE_SGROUPING
LOCALE_SLIST
LOCALE_SLONGDATE
LOCALE_SMONDECIMALSEP
LOCALE_SMONGROUPING
LOCALE_SMONTHOUSANDSEP
LOCALE_SNATIVEDIGITS
LOCALE_SNEGATIVESIGN
LOCALE_SPM
LOCALE_SPOSITIVESIGN
LOCALE_SSHORTDATE
LOCALE_SSHORTTIME
LOCALE_STHOUSAND
LOCALE_STIME
LOCALE_STIMEFORMAT
LOCALE_SYEARMONTH

Closely Related Locale Information Constants

Many of the locale information constants previously listed are closely related, so that changing one affects the value of the others. The following table shows the relationships among these constants.

Value	Constants affected
LOCALE_ICURRENCY	LOCALE_IPOSSEPBYSPACE, LOCALE_IPOSSYMPRECEDES
LOCALE_INEGCURR	LOCALE_SPOSITIVESIGN, LOCALE_INEGSEPBYSPACE, LOCALE_INEGSYMPRECEDES, LOCALE_INEGSIGNPOSN, LOCALE_IPOSSIGNPOSN
LOCALE_SSHORTDATE	LOCALE_SDATE, LOCALE_IDATE, LOCALE_ICENTURY, LOCALE_IDAYLZERO, LOCALE_IMONLZERO
LOCALE_SLONGDATE	LOCALE_ILDATE
LOCALE_STIMEFORMAT	LOCALE_STIME, LOCALE_ITIME, LOCALE_ITLZERO, LOCALE_ITIMEMARKPOSN

Deutsch	English	Español	Français
Italiano	日本語	한국어	Português
Pусский	简体中文	繁體中文