Locale Information Constants (Compact 2013)

  • Article

3/28/2014

This topic describes the LCTYPE constants used with the National/Regional Language Support (NLS) Functions.

An LCTYPE constant specifies a particular component of locale information, such as the name of the associated language or country/region.

All values are null-terminated Unicode strings. All maximum lengths indicated include the terminating null character.

The following list enumerates the locale, or LCTYPE, constants:

  • LOCALE_ALL
    Enumerate all locales. Using this constant is equivalent to using LOCALE_WINDOWS | LOCALE_SUPPLEMENTAL | LOCALE_ALTERNATE_SORTS | LOCALE_NEUTRALDATA.
  • LOCALE_ALLOW_NEUTRAL
    Consider neutral locales to be valid.
  • LOCALE_ALTERNATE_SORTS
    Enumerate only the alternate sorts, locales with a nonzero sort order identifier.
  • LOCALE_CUSTOM_DEFAULT
    The default custom locale. When an NLS function must return a locale identifier for a supplemental locale for the current user, the function returns this value instead of LOCALE_USER_DEFAULT.
  • LOCALE_CUSTOM_UI_DEFAULT
    The default custom locale for MUI. The user preferred UI languages and the system preferred UI languages can include at most a single language that is implemented by a Language Interface Pack (LIP) and for which the language identifier corresponds to a supplemental locale. If there is such a language in a list, the constant is used to refer to that language in certain contexts.
  • LOCALE_CUSTOM_UNSPECIFIED
    An unspecified custom locale, used to identify all supplemental locales except the locale for the current user. Supplemental locales cannot be distinguished from one another by their locale identifiers, but can be distinguished by their locale names. Certain NLS functions can return this constant to indicate that they cannot provide a useful identifier for a particular locale.
  • LOCALE_FONTSIGNATURE
    A specific bit pattern that determines the relationship between the character coverage needed to support the locale and the font contents. Note that LOCALE_FONTSIGNATURE data takes a different form from all other locale information. All other locale information can be expressed in a string form or as a number. LOCALE_FONTSIGNATURE data is retrieved in a LOCALESIGNATURE structure.

  • LOCALE_ICENTURY
    A 2-digit or 4-digit year for the short date only. One of the following values.

    Value

    Description

    0

    Abbreviated 2-digit year

    1

    Full 4-digit year

    It is preferred for your application to use LOCALE_SSHORTDATE instead of LOCALE_ICENTURY.

  • LOCALE_ICOUNTRY
    Country/region code, based on international phone codes, also referred to as IBM country/region codes. The maximum number of characters allowed for this string is 6.
  • LOCALE_ICURRDIGITS
    Number of digits for the fractional portion of the locale monetary format.

  • LOCALE_ICURRENCY
    Position of the monetary symbol in the positive currency mode. One of the following values:

    Value

    Description

    0

    Prefix, no separation

    1

    Suffix, no separation

    2

    Prefix, 1-char. separation

    3

    Suffix, 1-char. separation

  • LOCALE_IDATE
    Short date format-ordering specifier. One of the following values:

    Value

    Description

    0

    Month-Day-Year

    1

    Day-Month-Year

    2

    Year-Month-Day

    It is preferred for your application to use LOCALE_SSHORTDATE instead of LOCALE_IDATE.

  • LOCALE_IDAYLZERO
    Specifier for leading zeros in day fields for a short date only. One of the following values:

    Value

    Description

    0

    No leading zeros for days

    1

    Leading zeros for days

    It is preferred for your application to use the LOCALE_SSHORTDATE constant instead of LOCALE_IDAYLZERO.

  • LOCALE_IDEFAULTANSICODEPAGE
    The ANSI code page used by a locale for applications that do not support Unicode. The maximum number of characters allowed for this string is six. If no ANSI code page is available, only Unicode can be used for the locale. In this case, the value is CP_ACP (0).
  • LOCALE_IDEFAULTCODEPAGE
    Original equipment manufacturer (OEM) code page associated with the country/region. The maximum number of characters allowed for this string is 6.
  • LOCALE_IDEFAULTCOUNTRY
    Deprecated. Do not use.
  • LOCALE_IDEFAULTEBCDICCODEPAGE
    Default Extended Binary Coded Decimal Interchange Code (EBCDIC) code page associated with the locale. The maximum number of characters allowed for this string is six.
  • LOCALE_IDEFAULTLANGUAGE
    Deprecated. Do not use.
  • LOCALE_IDEFAULTMACCODEPAGE
    Default Macintosh code page associated with the locale. The maximum number of characters allowed for this string is six. If the locale does not use a Macintosh code page, the value is CP_MACCP (2).
  • LOCALE_IDIGITS
    Number of fractional digits placed after the decimal separator. The maximum number of characters allowed for this string is two. For example, 2 for 5.00, 1 for 5.0.

  • LOCALE_IDIGITSUBSTITUTION
    Determines the shape of the digits. For example, Arabic, Thai, and Indic digits have classical shapes that are different from those of western digits. The specifier can be one of these values.

    Value

    Description

    0

    Context. The shape depends on the previous text in the same output.

    1

    No substitution. Full Unicode compatibility.

    2

    Native digit substitution. National/Regional shapes determined by LOCALE_SNATIVEDIGITS.

  • LOCALE_IFIRSTDAYOFWEEK
    The first day in a week. One of these values:

    • LOCALE_SDAYNAME1 (Monday)
    • LOCALE_SDAYNAME2 (Tuesday)
    • LOCALE_SDAYNAME3 (Wednesday)
    • LOCALE_SDAYNAME4 (Thursday)
    • LOCALE_SDAYNAME5 (Friday)
    • LOCALE_SDAYNAME6 (Saturday)
    • LOCALE_SDAYNAME7 (Sunday)

  • LOCALE_IFIRSTWEEKOFYEAR
    The first week of the year. The specification is one of these values:

    Value

    Description

    0

    Week containing 1/1 is the first week of that year.

    1

    First full week following 1/1 is the first week of that year.

    2

    First week containing at least 4 days is the first week of that year.
  • LOCALE_IGEOID
    A 32-bit signed number that uniquely identifies a geographical location. The application can use this constant to provide locale-specific services to customers. For a list of values, see Geographic Location Identifiers.
  • LOCALE_IINTLCURRDIGITS
    Number of fractional digits for the international monetary format. The maximum number of characters allowed for this string is 3, including a terminating null character. For example, the number of fractional digits for the international monetary format of US Dollars is 2, as in $345.25.

  • LOCALE_ILANGUAGE
    Language identifier (LCID) as a four digit hexadecimal value. For example, English (United States) has the value 0409, which represents 0x0409 (1033 decimal).

    It is preferred for your application to use the LOCALE_SNAME constant instead of LOCALE_ILANGUAGE.

  • LOCALE_ILDATE
    Long date format-ordering specification. One of the following values:

    Value

    Description

    0

    Month-Day-Year

    1

    Day-Month-Year

    2

    Year-Month-Day

    It is preferred for your application to use the LOCALE_SLONGDATE constant instead of LOCALE_ILDATE.

  • LOCALE_ILZERO
    Specification for leading zeros in decimal fields. One of the following values:

    Value

    Description

    0

    No leading zeros

    1

    Leading zeros
  • LOCALE_IMEASURE
    System of measurement. This value is 0 if the metric system (Systéme International d'Unités, or S.I.) is used and 1 if the U.S. system is used.

  • LOCALE_IMONLZERO
    Specification for leading zeros in month fields for a short date only. One of the following values:

    Value

    Description

    0

    No leading zeros for months

    1

    Leading zeros for months

    It is preferred for your application to use the LOCALE_SSHORTDATE constant instead of LOCALE_IMONLZERO.

  • LOCALE_INEGATIVEPERCENT
    Negative percentage formatting pattern for the locale. Only one of the following values can be used.

    Value

    Format

    0

    Negative sign, number, space, percent; for example, -# %

    1

    Negative sign, number, percent; for example, -#%

    2

    Negative sign, percent, number; for example, -%#

    3

    Percent, negative sign, number; for example, %-#

    4

    Percent, number, negative sign; for example, %#-

    5

    Number, negative sign, percent; for example, #-%

    6

    Number, percent, negative sign; for example, #%-

    7

    Negative sign, percent, space, number; for example, -% #

    8

    Number, space, percent, negative sign; for example, # %-

    9

    Percent, space, number, negative sign; for example, % #-

    10

    Percent, space, negative sign, number; for example, % -#

    11

    Number, negative sign, space, percent; for example, #- %

    If more than one format is used for the locale, choose the preferred option. For example, if a negative percentage is displayed "-9 %" for "negative nine percent", the appropriate choice for this constant is 0.

  • LOCALE_INEGCURR
    Negative currency mode. One of the following values:

    Value

    Example

    0

    ($1.1)

    1

    $1.1

    2

    $1.1

    3

    $1.1

    4

    (1.1$)

    5

    1.1$

    6

    1.1$

    7

    1.1$

    8

    1.1 $ (space before $)

    9

    $ 1.1 (space after $)

    10

    1.1 $ (space before $)

    11

    $ 1.1 (space after $)

    12

    $ 1.1 (space after $)

    13

    1.1 $ (space before $)

    14

    ($ 1.1) (space after $)

    15

    (1.1 $) (space before $)

  • LOCALE_INEGNUMBER
    Negative number mode, that is, the format for a negative number. The mode is one of the following values:

    Value

    Example

    0

    (1.1)

    1

    -1.1

    2

    - 1.1 (space after -)

    3

    1.1-

    4

    1.1 -(space before -)
  • LOCALE_INEGSEPBYSPACE
    Separation of monetary symbol in a negative monetary value. This value is 1 if the monetary symbol is separated by a space from the negative amount, 0 if it is not.

  • LOCALE_INEGSIGNPOSN
    Formatting index for negative currency values. One of the following values.

    Value

    Description

    0

    Parentheses surround the amount and the monetary symbol.

    1

    The sign precedes the number.

    2

    The sign follows the number.

    3

    The sign precedes the monetary symbol.

    4

    The sign follows the monetary symbol.
  • LOCALE_INEGSYMPRECEDES
    Position of monetary symbol in a negative monetary value. This value is 1 if the monetary symbol precedes the negative amount, 0 if it follows it.
  • LOCALE_INEUTRAL
    Locale type. This value is 1 for a neutral locale, or zero (0) for a specific locale.
  • LOCALE_INVARIANT
    The locale used for operating system-level functions that require consistent and locale-independent results.

  • LOCALE_IOPTIONALCALENDAR

    • An optional calendar type that is available for a locale. The calendar type can only represent an optional calendar that is available for the corresponding locale.

  • LOCALE_IPAPERSIZE
    Default paper size associated with the locale. The following table shows the supported values.

    Value

    Description

    1

    US Letter

    5

    US Legal

    8

    A3

    9

    A4

  • LOCALE_IPOSITIVEPERCENT
    Positive percentage formatting pattern for the locale. One of the following values:

    Value

    Format

    0

    Number, space, percent; for example, # %

    1

    Number, percent; for example, #%

    2

    Percent, number; for example, %#

    3

    Percent, space, number; for example, % #
  • LOCALE_IPOSSEPBYSPACE
    Separation of monetary symbol in a positive monetary value. This value is 1 if the monetary symbol is separated by a space from a positive amount, 0 if it is not.

  • LOCALE_IPOSSIGNPOSN
    Formatting index for positive currency values. One of the following values:

    Value

    Description

    1

    The sign string precedes the amount and the monetary symbol.

    2

    The sign string succeeds the amount and the monetary symbol.

    3

    The sign string immediately precedes the monetary symbol.

    4

    The sign string immediately succeeds the monetary symbol.
  • LOCALE_IPOSSYMPRECEDES
    Position of monetary symbol in a positive monetary value. This value is 1 if the monetary symbol precedes the positive amount, 0 if it follows it.

  • LOCALE_IREADINGLAYOUT
    The reading layout for text. One of the following values:

    • 0
      Read from left to right, as for English locales.
    • 1
      Read from right to left, as for Arabic locales.
    • 2
      Read vertically from top to bottom with columns to the left, and read from left to right, as for the Japanese locale.
    • 3
      Read vertically from top to bottom with columns proceeding to the right.
  • LOCALE_ITIME
    Time format specification. This value is 1 if time is in the 24-hour format, zero if it is in the AM / PM 12-hour format.

  • LOCALE_ITLZERO
    Specification for leading zeros in time fields. This value is 1 if leading zeros are used for single digit hours; zero if they are not.

    It is preferred for your application to use the LOCALE_STIMEFORMAT constant instead of LOCALE_ITIME.

  • LOCALE_ITIMEMARKPOSN
    Specifier indicating whether the time marker string (AM or PM) precedes (1) or follows (zero) the time string.

    It is preferred for your application to use the LOCALE_STIMEFORMAT constant instead of LOCALE_ITIMEMARKPOSN.

  • LOCALE_ITLZERO
    Specifier for leading zeros in time fields. This value is 1 if leading zeros are used for single digit hours; zero if they are not.

    It is preferred for your application to use the LOCALE_STIMEFORMAT constant instead of LOCALE_ITLZERO.

  • LOCALE_NAME_INVARIANT
    Name of an invariant locale that provides stable locale and calendar data.

  • LOCALE_NAME_MAX_LENGTH
    Maximum length of a locale name.

    Note

    Your application must use the constant for the maximum locale name length, instead of hard-coding the value "85".

  • LOCALE_NAME_SYSTEM_DEFAULT
    Name of the current operating system locale.
  • LOCALE_NAME_USER_DEFAULT
    Name of the current user locale, matching the preference set in the regional and language options portion of Control Panel. This locale can be different from the locale for the current user interface language.
  • LOCALE_NEUTRAL
    The neutral locale. Your applications generally do not use this constant. Instead, they use either LOCALE_SYSTEM_DEFAULT or LOCALE_USER_DEFAULT.
  • LOCALE_NEUTRALDATA
    Neutral locale data, that is, data defined by language only. Country/region data uses the default.

  • LOCALE_NOUSEROVERRIDE

    Warning

    Since LOCALE_NOUSEROVERRIDE disables user preferences, its use is strongly discouraged. This constant does not guarantee data stability since custom locales, service updates, different operating system versions, and other scenarios can change data in unexpected ways.

    You can use the OR operator to combine this value with any other LCTYPE constant in a call to the GetLocaleInfo function. This always causes the function to bypass any user overrides, and return the system default value for the other LCTYPE specified in the function call.

  • LOCALE_REPLACEMENT
    Enumerate replacement locales. This constant is valid input only for EnumLocalesProcEx.

  • LOCALE_RETURN_GENITIVE_NAMES
    Retrieve the genitive names of months, which are the names used when the month names are combined with other items.

    Note

    Genitive month names do not exist in all languages.

  • LOCALE_RETURN_NUMBER
    Retrieve a number. This constant causes GetLocaleInfo or GetLocaleInfoEx to retrieve a value as a number instead of as a string. The buffer that receives the value must be at least the length of a DWORD value. This constant can be combined with any other constant having a name that begins with "LOCALE_I".
  • LOCALE_S1159
    String for the AM designator.
  • LOCALE_S2359
    String for the PM designator.
  • LOCALE_SABBREVCTRYNAME
    Abbreviated name of the country/region from the ISO Standard 3166.
  • LOCALE_SABBREVDAYNAME1
    Native abbreviated name for Monday.
  • LOCALE_SABBREVDAYNAME2
    Native abbreviated name for Tuesday.
  • LOCALE_SABBREVDAYNAME3
    Native abbreviated name for Wednesday.
  • LOCALE_SABBREVDAYNAME4
    Native abbreviated name for Thursday.
  • LOCALE_SABBREVDAYNAME5
    Native abbreviated name for Friday.
  • LOCALE_SABBREVDAYNAME6
    Native abbreviated name for Saturday.
  • LOCALE_SABBREVDAYNAME7
    Native abbreviated name for Sunday.
  • LOCALE_SABBREVLANGNAME
    Abbreviated name of the language, created by taking the 2-letter language abbreviation from the ISO Standard 639 and adding a third letter, as appropriate, to indicate the sublanguage. For example, the abbreviated name for the language corresponding to the English (United States) locale is ENU.
  • LOCALE_SABBREVMONTHNAME1
    Native abbreviated name for January.
  • LOCALE_SABBREVMONTHNAME2
    Native abbreviated name for February.
  • LOCALE_SABBREVMONTHNAME3
    Native abbreviated name for March.
  • LOCALE_SABBREVMONTHNAME4
    Native abbreviated name for April.
  • LOCALE_SABBREVMONTHNAME5
    Native abbreviated name for May.
  • LOCALE_SABBREVMONTHNAME6
    Native abbreviated name for June.
  • LOCALE_SABBREVMONTHNAME7
    Native abbreviated name for July.
  • LOCALE_SABBREVMONTHNAME8
    Native abbreviated name for August.
  • LOCALE_SABBREVMONTHNAME9
    Native abbreviated name for September.
  • LOCALE_SABBREVMONTHNAME10
    Native abbreviated name for October.
  • LOCALE_SABBREVMONTHNAME11
    Native abbreviated name for November.
  • LOCALE_SABBREVMONTHNAME12
    Native abbreviated name for December.
  • LOCALE_SABBREVMONTHNAME13
    Native abbreviated name for 13th month, if it exists.

  • LOCALE_SCONSOLEFALLBACKNAME
    Preferred locale to use for console display.

    Note

    In general, applications should not make direct use of LOCALE_SCONSOLEFALLBACKNAME data. To determine what language resources to use in a console window, an application should call either SetThreadUILanguage or SetThreadPreferredUILanguages.

  • LOCALE_SCOUNTRY
    Deprecated for Compact 2013. Full localized name of the country/region. Use LOCALE_SLOCALIZEDCOUNTRYNAME instead.
  • LOCALE_SCURRENCY
    String used as the local monetary symbol.

  • LOCALE_SDATE
    Character(s) for the date separator.

    Deprecated, use LOCALE_SSHORTDATE instead. A custom locale might not have a single, uniform separator character. For example, a format such as "12/31, 2006" is valid.

  • LOCALE_SDAYNAME1
    Native long name for Monday.
  • LOCALE_SDAYNAME2
    Native long name for Tuesday.
  • LOCALE_SDAYNAME3
    Native long name for Wednesday.
  • LOCALE_SDAYNAME4
    Native long name for Thursday.
  • LOCALE_SDAYNAME5
    Native long name for Friday.
  • LOCALE_SDAYNAME6
    Native long name for Saturday.
  • LOCALE_SDAYNAME7
    Native long name for Sunday.
  • LOCALE_SDECIMAL
    Character(s) used as the decimal separator.

  • LOCALE_SDURATION
    Time duration format. The format is similar to the format for LOCALE_STIMEFORMAT. The format is described in format pictures composed of the strings listed in the following table.

    Value

    Description

    h

    Hours without leading zeros for single-digit hours

    hh

    Hours with leading zeros for single-digit hours

    m

    Minutes without leading zeros for single-digit minutes

    mm

    Minutes with leading zeros for single-digit minutes

    s

    Seconds without leading zeros for single-digit seconds

    ss

    Seconds with leading zeros for single-digit seconds

    f

    Tenths of a second

    ff

    Hundredths of a second

    fff

    Thousandths of a second; character "f" can occur up to nine consecutive times (fffffffff).

    Ee491958.note(en-us,WinEmbedded.80).gifNote:
    Support for frequency timers is limited to 100 nanoseconds. Therefore if more than seven characters are used the eighth and ninth digits will always be zero.

    As with LOCALE_STIMEFORMAT, this format can also include any string of characters enclosed in single quotes. Formats can include, for example, "h':'mm':'ss", or "d'd 'h'h 'm'm 's.fff's'". Because this format is for duration, not time, it does not specify a 12- or 24-hour clock system, or include an AM/PM indicator. This constant might be used, for example, for a multi-media application that displays file time or a sporting event application that displays finish times.

  • LOCALE_SENGCOUNTRY
    Deprecated. Full English name of the country/region. See LOCALE_SENGLISHCOUNTRYNAME.
  • LOCALE_SENGCURRNAME
    The full English name of the currency associated with the locale.
  • LOCALE_SENGLANGUAGE
    Deprecated. Full English name of the language from ISO Standard 639. See LOCALE_SENGLISHLANGUAGENAME.
  • LOCALE_SENGLISHCOUNTRYNAME
    English name of the country/region, for example, Germany for Deutschland. This name is always restricted to characters that can be mapped into the ASCII 127-character subset.
  • LOCALE_SENGLISHDISPLAYNAME
    Display name of the locale in English. Usually the display name consists of the language and the country/region, for example, German (Germany) for Deutsch (Deutschland).
  • LOCALE_SENGLISHLANGUAGENAME
    English name of the language, for example, German for Deutsch, from International ISO Standard 639. This name is always restricted to characters that can be mapped into the ASCII 127-character subset.

  • LOCALE_SGROUPING
    Sizes for each group of digits to the left of the decimal. An explicit size is needed for each group; semicolons separate sizes. If the last value is zero, the preceding value is repeated. For example, to group thousands, specify 3;0. Indic locales group the first thousand and then group by hundreds; for example 12,34,56,789 is represented by 3;2;0.

    The following table contains examples

    Specification

    Resulting string

    3;0

    3,000,000,000,000

    3;2;0

    30,00,00,00,00,000

    3

    3000000000,000

    3;2

    30000000,00,000
  • LOCALE_SINTLSYMBOL
    International currency code. The first three characters of the alphabetic code specified in ISO 4217, "Codes for the Representation of Currencies and Funds," followed by the character separating this string from the amount.
  • LOCALE_SISO3166CTRYNAME
    Country/region name, based on ISO Standard 3166, for example, "US" for the United States.
  • LOCALE_SISO3166CTRYNAME2
    Three-letter ISO region name (ISO 3166 three-letter code for the country/region), for example, "USA" for the United States.
  • LOCALE_SISO639LANGNAME
    The abbreviated name of the language based entirely on the ISO Standard 639 values, in lowercase form, for example, "en" for English.
  • LOCALE_SISO639LANGNAME2
    Three-letter ISO language name, in lowercase form (ISO 639-2 three-letter code for the language), for example, "eng" for English.
  • LOCALE_SKEYBOARDSTOINSTALL
    A semicolon-delimited list of keyboards to potentially install for the locale and to be used internally by Windows. There is no limit on the number of characters allowed for this string. To retrieve the name of the active input locale identifier (formerly called the keyboard layout), your application can call the GetKeyboardLayoutName function.
  • LOCALE_SLANGUAGE
    Deprecated. Full localized name of the language. Use LOCALE_SLOCALIZEDLANGUAGENAME instead.
  • LOCALE_SLIST
    Character(s) used to separate list items. For example, a comma is used in many locales.
  • LOCALE_SLOCALIZEDCOUNTRYNAME
    Full localized name of the country/region, for example, Deutschland for Germany. The maximum number of characters allowed for this string is 80, including a terminating null character. Since this name is based on the localization of the product, it changes for each localized version.
  • LOCALE_SLOCALIZEDDISPLAYNAME
    Full localized name of the locale for the user interface language, for example, Deutsch (Deutschland) for German (Germany)" There is no limit on the number of characters allowed for this string. Since this name is based on the localization of the product, it changes for each localized version.
  • LOCALE_SLOCALIZEDLANGUAGENAME
    Full localized primary name of the user interface language included in a localized display name, for example, Deutsch representing German. Since this name is based on the localization of the product, it changes for each localized version.
  • LOCALE_SLONGDATE
    Long date formatting string for this locale. For the details of composing a date formatting string, see Day, Month, Year, and Era Format Pictures.
  • LOCALE_SMONDECIMALSEP
    Character(s) used as the monetary decimal separator. For example ".".
  • LOCALE_SMONGROUPING
    Sizes for each group of monetary digits to the left of the decimal. An explicit size is needed for each group; semicolons separate sizes. If the last value is zero, the preceding value is repeated. For example, to group thousands, specify 3;0. Indic languages group the first thousand and then group by hundreds; for example, 12,34,56,789is represented by 3;2;0. The maximum number of characters allowed for this string is four.
  • LOCALE_SMONTHDAY
    Format string for displaying only the month and the day. The formatting is similar to that defined for LOCALE_SLONGDATE. For example, if the month/day pattern is the full month name followed by the day number with leading zeros, as in "September 03", the format string is "MMMM dd". A locale can specify only one month/day format.
  • LOCALE_SMONTHNAME1
    Native long name for January.
  • LOCALE_SMONTHNAME2
    Native long name for February.
  • LOCALE_SMONTHNAME3
    Native long name for March.
  • LOCALE_SMONTHNAME4
    Native long name for April.
  • LOCALE_SMONTHNAME5
    Native long name for May.
  • LOCALE_SMONTHNAME6
    Native long name for June.
  • LOCALE_SMONTHNAME7
    Native long name for July.
  • LOCALE_SMONTHNAME8
    Native long name for August.
  • LOCALE_SMONTHNAME9
    Native long name for September.
  • LOCALE_SMONTHNAME10
    Native long name for October.
  • LOCALE_SMONTHNAME11
    Native long name for November.
  • LOCALE_SMONTHNAME12
    Native long name for December.
  • LOCALE_SMONTHNAME13
    Native name for 13th month, if exists.
  • LOCALE_SMONTHOUSANDSEP
    Character(s) used as the monetary separator between groups of digits to the left of the decimal.
  • LOCALE_SNAME
    Locale name, a multi-part tag to uniquely identify the locale. The tag is based on the language tagging conventions of RFC 4646. The pattern to use is described in Locale Names.
  • LOCALE_SNAN
    String value for "Not a number", for example, "Nan" for the English (United States) locale.
  • LOCALE_SNATIVECTRYNAME
    Native name of the country/region.
  • LOCALE_SNATIVEDIGITS
    Native equivalents to ASCII 0 through 9.
  • LOCALE_SNATIVELANGNAME
    Native name of the language.
  • LOCALE_SNEGATIVESIGN
    String value for the negative sign.
  • LOCALE_SNEGINFINITY
    String value for "negative infinity", for example, "-Infinity" for the English (United States) locale.
  • LOCALE_SOPENTYPELANGUAGETAG
    OpenType language tag used to retrieve culturally appropriate typographic features from a font. For more information, see OPENTYPE_TAG.
  • LOCALE_SORTNAME
    Locale name to use for sorting, if different from the locale specified by LOCALE_SNAME. This constant is used by custom locales. See also LOCALE_SSORTNAME.
  • LOCALE_SPARENT
    Fallback locale, used by the resource loader. Locales have a hierarchy in which the parent of a specific locale is a neutral locale.
  • LOCALE_SPECIFICDATA
    Locale data specified by both language and country/region.
  • LOCALE_SPERCENT
    Symbol used to indicate percentage, for example, "%".
  • LOCALE_SPERMILLE
    Symbol used to indicate the permille (U+2030) symbol, that is, ‰.
  • LOCALE_SPOSINFINITY
    String value for "positive infinity", for example, "Infinity" for the English (United States) locale.
  • LOCALE_SPOSITIVESIGN
    String value for the positive sign, for example, "+" for the English (United States) locale.

  • LOCALE_SSCRIPTS
    A string representing a list of scripts, using the 4-character notation used in ISO 15924. Each script name consists of four Latin characters and the list is arranged in alphabetical order with each name, including the last, followed by a semicolon.

    For example, (ja-JP locale) Hani;Hira;Jpan;Kana;

LOCALE_SSHORTESTDAYNAME1

Short native name of the first day of the week. This name is often shorter than LOCALE_SABBREVDAYNAME1, and it is useful for calendar titles.

LOCALE_SSHORTESTDAYNAME2

Short native name of the second day of the week. This name is often shorter than LOCALE_SABBREVDAYNAME2, and it is useful for calendar titles.

LOCALE_SSHORTESTDAYNAME3

Short native name of the third day of the week. This name is often shorter than LOCALE_SABBREVDAYNAME3, and it is useful for calendar titles.

LOCALE_SSHORTESTDAYNAME4

Short native name of the fourth day of the week. This name is often shorter than LOCALE_SABBREVDAYNAME4, and it is useful for calendar titles.

LOCALE_SSHORTESTDAYNAME5

Short native name of the fifth day of the week. This name is often shorter than LOCALE_SABBREVDAYNAME5, and it is useful for calendar titles.

LOCALE_SSHORTESTDAYNAME6

Short native name of the sixth day of the week. This name is often shorter than LOCALE_SABBREVDAYNAME6, and it is useful for calendar titles.

LOCALE_SSHORTESTDAYNAME7

Short native name of the seventh day of the week. This name is often shorter than LOCALE_SABBREVDAYNAME7, and it is useful for calendar titles.

LOCALE_SSHORTTIME

Short time formatting string for the locale. Patterns are typically derived by removing the "ss" (seconds) value from the long time format pattern. For example, if the long time format is "h:mm:ss tt", the short time format is most likely "h:mm tt". This constant can specify multiple formats in a semicolon-delimited list. However, the preferred short time format should be the first value listed.

LOCALE_SSORTLOCALE

Name of the locale to use for sorting, collation, or capitalization behavior.

LOCALE_SSORTNAME

The full localized name of the sort for the specified locale identifier, dependent on the language of the shell. This constant is used to determine casing and sorting behavior.

LOCALE_STHOUSAND

Characters used to separate groups of digits to the left of the decimal. The maximum number of characters allowed for this string is four. Typically, these groups represent thousands. However, depending on the value specified for LOCALE_SGROUPING, they can represent something else.

LOCALE_STIME

Characters for the time separator.

Deprecated. Use LOCALE_STIMEFORMAT instead. A custom locale might not have a single, uniform separator character. For example, a format such as "03:56'23" is valid.

LOCALE_STIMEFORMAT

Time formatting strings for this locale. See, Hour, Minute, and Second Format Pictures.

LOCALE_SUPPLEMENTAL

Enumerate supplemental locales.

LOCALE_SYEARMONTH

The Year/Month formatting string for the locale. This string shows the proper format for a date string that contains only the year and the month. See, Hour, Minute, and Second Format Pictures.

LOCALE_SYSTEM_DEFAULT

The default locale for the operating system.

LOCALE_USE_CP_ACP

System default Windows ANSI code page (ACP) instead of the locale code page used for string translation.

LOCALE_USER_DEFAULT

The default locale for the user or process.

LOCALE_WINDOWS

Enumerate all locales that come with the operating system, including replacement locales, but excluding alternate sorts.

Requirements

Header

winnls.h

Library

Coreloc.lib

See Also

Reference

National/Regional Language Support (NLS) Constants