Platform SDK: International Features |
An LCTYPE constant is a constant that specifies a particular piece of locale information. The values in the following list correspond to the names of these values in the configuration registry, under both the user's preferences (as values in the registry key HKEY_CURRENT_USER\Control Panel\International) and the system's installed languages (as files pointed to by registry keys, one key per language installed, under HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\NLS). All values are null-terminated Unicode strings. If no maximum length is indicated, the strings may vary in length.
The following are locale, or LCTYPE, constants.
Value | Meaning |
---|---|
1 | Gregorian (localized) |
2 | Gregorian (English strings always) |
3 | Era: Year of the Emperor (Japan) |
4 | Era: Year of Taiwan |
5 | Tangun Era (Korea) |
6 | Hijri (Arabic lunar) |
7 | Thai |
8 | Hebrew (Lunar) |
9 | Gregorian Middle East French calendar |
10 | Gregorian Arabic calendar |
11 | Gregorian Transliterated English calendar |
12 | Gregorian Transliterated French calendar |
Value | Meaning |
---|---|
0 | Abbreviated 2-digit century |
1 | Full 4-digit century |
Value | Meaning |
---|---|
0 | Prefix, no separation, for example $1.1 |
1 | Suffix, no separation, for example 1.1$ |
2 | Prefix, 1-character separation, for example $ 1.1 |
3 | Suffix, 1-character separation, for example 1.1 $ |
Value | Meaning |
---|---|
0 | Month-Day-Year |
1 | Day-Month-Year |
2 | Year-Month-Day |
Value | Meaning |
---|---|
0 | No leading zeros for days |
1 | Leading zeros for days |
Value | Meaning |
---|---|
0 | Context—the shape depends on the previous text in the same output. |
1 | None/Arabic—gives full Unicode compatibility. |
2 | Native—national shapes determined by LOCALE_SNATIVEDIGITS. |
Value | Meaning |
---|---|
0 | LOCALE_SDAYNAME1 |
1 | LOCALE_SDAYNAME2 |
2 | LOCALE_SDAYNAME3 |
3 | LOCALE_SDAYNAME4 |
4 | LOCALE_SDAYNAME5 |
5 | LOCALE_SDAYNAME6 |
6 | LOCALE_SDAYNAME7 |
Value | Meaning |
---|---|
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 four days is the first week of that year. |
Value | Meaning |
---|---|
0 | Month-Day-Year |
1 | Day-Month-Year |
2 | Year-Month-Day |
Value | Meaning |
---|---|
0 | No leading zeros |
1 | Leading zeros |
Value | Meaning |
---|---|
0 | No leading zeros for months |
1 | Leading zeros for months |
Mode | Format for a negative currency |
---|---|
0 | Left parenthesis,monetary symbol,number,right parenthesis.
Example: ($1.1) |
1 | Negative sign, monetary symbol, number. Example: -$1.1 |
2 | Monetary symbol, negative sign, number. Example: $-1.1 |
3 | Monetary symbol, number, negative sign. Example: $1.1- |
4 | Left parenthesis, number, monetary symbol, right parenthesis. Example: (1.1$) |
5 | Negative sign, number, monetary symbol. Example: -1.1$ |
6 | Number, negative sign, monetary symbol. Example: 1.1-$ |
7 | Number, monetary symbol, negative sign. Example: 1.1$- |
8 | Negative sign, number, space, monetary symbol (like #5, but with a space before the monetary symbol). Example: -1.1 $ |
9 | Negative sign, monetary symbol, space, number (like #1, but with a space after the monetary symbol). Example: -$ 1.1 |
10 | Number, space, monetary symbol, negative sign (like #7, but with a space before the monetary symbol). Example: 1.1 $- |
11 | Monetary symbol, space, number, negative sign (like #3, but with a space after the monetary symbol). Example: $ 1.1- |
12 | Monetary symbol, space, negative sign, number (like #2, but with a space after the monetary symbol). Example: $ -1.1 |
13 | Number, negative sign, space, monetary symbol (like #6, but with a space before the monetary symbol). Example: 1.1- $ |
14 | Left parenthesis, monetary symbol, space, number, right
parenthesis (like #0, but with a space after the monetary symbol). Example: ($ 1.1) |
15 | Left parenthesis, number, space, monetary symbol, right parenthesis (like #4, but with a space before the monetary symbol). Example: (1.1 $) |
Value | Format |
---|---|
0 | Left parenthesis, number, right parenthesis. Example: (1.1) |
1 | Negative sign, number. Example: -1.1 |
2 | Negative sign, space, number. Example: - 1.1 |
3 | Number, negative sign. Example: 1.1- |
4 | Number, space, negative sign. Example: 1.1 - |
Value | Meaning |
---|---|
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. |
Value | Meaning |
---|---|
0 | No additional types valid |
1 | Gregorian (localized) |
2 | Gregorian (English strings always) |
3 | Era: Year of the Emperor (Japan) |
4 | Era: Year of Taiwan |
5 | Tangun Era (Korea) |
6 | Hijri (Arabic lunar) |
7 | Thai |
8 | Hebrew (Lunar) |
9 | Gregorian Middle East French calendar |
10 | Gregorian Arabic calendar |
11 | Gregorian-transliterated English calendar |
12 | Gregorian-transliterated French calendar |
Value | Meaning |
---|---|
1 | US Letter |
5 | US legal |
8 | A3 |
9 | A4 |
Value | Meaning |
---|---|
0 | AM / PM 12-hour format. |
1 | 24-hour format. |
Value | Meaning |
---|---|
0 | Use as suffix. |
1 | Use as prefix. |
Value | Meaning |
---|---|
0 | Use with 12-hour clock. |
1 | Use with 24-hour clock. |
2 | Use with both 12-hour and 24-hour clocks. |
3 | Never use. |
Value | Meaning |
---|---|
0 | No leading zeros for hours. |
1 | Leading zeros for hours. |
Note Calling the GetLocaleInfo function with a LOCALE_SMONTHNAMExx flag returns the stand-alone, or nominative, form of the month name. To get the genitive form of the month name, call GetDateFormat with a date picture of ddMMMM and remove the two digits from the beginning of the returned string.
Many of the locale types previously listed are closely related, such that changing one affects the value of the others. The following table shows the relationships between these types.
Constant | Affects |
---|---|
LOCALE_ICURRENCY | LOCALE_IPOSSEPBYSPACE, LOCALE_IPOSSYMPRECEDES |
LOCALE_INEGCURR | LOCALE_SNEGATIVE, LOCALE_SPOSITIVE, LOCALE_INEGSEPBYSPACE, LOCALE_INEGSYMPRECEDES, LOCALE_INEGSIGNPOSN, LOCALE_IPOSSIGNPOSN |
LOCALE_SSHORTDATE | LOCALE_SDATE, LOCALE_IDATE |
LOCALE_SLONGDATE | LOCALE_ILDATE |
LOCALE_STIMEFORMAT | LOCALE_STIME, LOCALE_ITIME, LOCALE_ITLZERO, LOCALE_ITIMEMARKPOSN |