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_FONTSIGNATURE
LOCALE_ICALENDARTYPE
LOCALE_ICENTURY
LOCALE_ICONSTRUCTEDLOCALE
LOCALE_ICOUNTRY
LOCALE_ICURRDIGITS
LOCALE_ICURRENCY
LOCALE_IDATE
LOCALE_IDAYLZERO
LOCALE_IDEFAULT* Constants
LOCALE_IDIALINGCODE
LOCALE_IDIGITS
LOCALE_IDIGITSUBSTITUTION
LOCALE_IFIRSTDAYOFWEEK
LOCALE_IFIRSTWEEKOFYEAR
LOCALE_IGEOID
LOCALE_IINTLCURRDIGITS
LOCALE_ILANGUAGE
LOCALE_ILDATE
LOCALE_ILZERO
LOCALE_IMEASURE
LOCALE_IMONLZERO
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_IUSEUTF8LEGACYACP
LOCALE_IUSEUTF8LEGACYOEMCP
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_SORTNAME
LOCALE_SPARENT
LOCALE_SPECIFICDATA
LOCALE_SPERCENT
LOCALE_SPERMILLE
LOCALE_SPM
LOCALE_SPOSINFINITY
LOCALE_SPOSITIVESIGN
LOCALE_SSCRIPTS
LOCALE_SSHORTDATE
LOCALE_SSHORTESTAM
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_ICONSTRUCTEDLOCALE
- 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 |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for