ULSQueryLocaleItem: Difference between revisions
Appearance
m →Example |
mNo edit summary |
||
Line 30: | Line 30: | ||
|- | |- | ||
|sAbbrevDayName5||11||Abbreviation of day 5 (Fri) | |sAbbrevDayName5||11||Abbreviation of day 5 (Fri) | ||
|- | |||
|sAbbrevDayName6||12||Abbreviation of day 6 (Sat) | |||
|- | |||
|sDayName7||13||Name of day of week 7 (Sun) | |||
|- | |||
|sDayName1||14||Name of day of week 1 (Mon) | |||
|- | |||
|sDayName2||15||Name of day of week 2 (Tue) | |||
|- | |||
|sDayName3||16||Name of day of week 3 (Wed) | |||
|- | |||
|sDayName4||17||Name of day of week 4 (Thu) | |||
|- | |||
|sDayName5||18||Name of day of week 5 (Fri) | |||
|- | |||
|sDayName6||19||Name of day of week 6 (Sat) | |||
|- | |||
|sAbbrevMonthName1||20||Abbreviation of month 1 | |||
|- | |||
|sAbbrevMonthName2||21||Abbreviation of month 2 | |||
|- | |||
|sAbbrevMonthName3||22||Abbreviation of month 3 | |||
|- | |||
|sAbbrevMonthName4||23||Abbreviation of month 4 | |||
|- | |||
|sAbbrevMonthName5||24||Abbreviation of month 5 | |||
|- | |||
|sAbbrevMonthName6||25||Abbreviation of month 6 | |||
|- | |||
|sAbbrevMonthName7||26||Abbreviation of month 7 | |||
|- | |||
|sAbbrevMonthName8||27||Abbreviation of month 8 | |||
|- | |||
|sAbbrevMonthName9||28||Abbreviation of month 9 | |||
|- | |||
|sAbbrevMonthName10||29||Abbreviation of month 10 | |||
|- | |||
|sAbbrevMonthName11||30||Abbreviation of month 11 | |||
|- | |||
|sAbbrevMonthName12||31||Abbreviation of month 12 | |||
|- | |||
|sMonthName1||32||Name of month 1 | |||
|- | |||
|sMonthName2||33||Name of month 2 | |||
|- | |||
|sMonthName3||34||Name of month 3 | |||
|- | |||
|sMonthName4||35||Name of month 4 | |||
|- | |||
|sMonthName5||36||Name of month 5 | |||
|- | |||
|sMonthName6||37||Name of month 6 | |||
|- | |||
|sMonthName7||38||Name of month 7 | |||
|- | |||
|sMonthName8||39||Name of month 8 | |||
|- | |||
|sMonthName9||40||Name of month 9 | |||
|- | |||
|sMonthName10||41||Name of month 10 | |||
|- | |||
|sMonthName11||42||Name of month 11 | |||
|- | |||
|sMonthName12||43||Name of month 12 | |||
|- | |||
|sDecimal||44||Decimal point | |||
|- | |||
|sThousand||45||Triad separator | |||
|- | |||
|sYesString||46||Yes string | |||
|- | |||
|sNoString||47||No string | |||
|- | |||
|sCurrency||48||Currency symbol | |||
|- | |||
|sCodeSet||49||Locale codeset | |||
|- | |||
|xLocaleToken||50||IBM Locale Token | |||
|- | |||
|xWinLocale||51||Win32 Locale ID | |||
|- | |||
|iLocaleResnum||52||Resource number for description | |||
|- | |||
|sNativeDigits||53||String of native digits | |||
|- | |||
|iMaxItem 54 Maximum item number | |||
|- | |||
|sTimeMark 55 Time mark (am/pm) format | |||
|- | |||
|sEra||56||Era definition | |||
|- | |||
|sAltShortDate 57 Alternate short date format string | |||
|- | |||
|sAltDateTime 58 Alternate date and time format | |||
|- | |||
|sAltTimeFormat 59 Alternate time format | |||
|- | |||
|sAltDigits 60 XPG4 alternate digits | |||
|- | |||
|sYesExpr 61 XPG4 Yes expression | |||
|- | |||
|sNoExpr 62 XPG4 No expression | |||
|- | |||
|sDate||63||Short date separator | |||
|- | |||
|sTime||64||Time separator | |||
|- | |||
|sList||65||List separator | |||
|- | |||
|sMonDecimalSep||66||Monetary currency separator | |||
|- | |||
|sMonThousandSep||67||Monetary triad separator | |||
|- | |||
|sGrouping||68||Grouping of digits | |||
|- | |||
|sMonGrouping||69||Monetary groupings | |||
|- | |||
|iMeasure||70||Measurement (Metric, British) | |||
|- | |||
|iPaper||71||Normal paper size | |||
|- | |||
|iDigits||72||Digits to right of decimal | |||
|- | |||
|iTime||73||Clock format | |||
|- | |||
|iDate||74||Format of short date | |||
|- | |||
|iCurrency||75||Format of currency | |||
|- | |||
|iCurrDigits||76||Digits to right for currency | |||
|- | |||
|iLzero||77||Leading zero used | |||
|- | |||
|iNegNumber||78||Format of negative number | |||
|- | |||
|iLDate||79||Format of long date | |||
|- | |||
|iCalendarType||80||Type of default calendar | |||
|- | |||
|iFirstDayOfWeek||81||First day of week (0=Mon) | |||
|- | |||
|iFirstWeekOfYear||82||First week of year | |||
|- | |||
|iNegCurr||83||Format of negative currency | |||
|- | |||
|iTLzero||84||Leading zero on time | |||
|- | |||
|iTimePrefix||85||AM/PM preceeds time | |||
|- | |||
|iOptionalCalendar||86||Alternate calendar type | |||
|- | |||
|sIntlSymbol||87||International currency symbol | |||
|- | |||
|sAbbrevLangName||88||Windows language abbreviation | |||
|- | |||
|sCollate||89||Collation table | |||
|- | |||
|iUpperType||90||Upper case algorithm | |||
|- | |||
|iUpperMissing||91||Action for missing upper case | |||
|- | |||
|sPositiveSign||92||Positive sign | |||
|- | |||
|sNegativeSign||93||Negative sign | |||
|- | |||
|sLeftNegative||94||Left paren for negative | |||
|- | |||
|sRightNegative||95||Right paren for negative | |||
|- | |||
|sLongDate||96||Long date formatting string | |||
|- | |||
|sAltLongDate||97||Alternate long date format string | |||
|- | |||
|sMonthName13||98||Name of month 13 | |||
|- | |||
|sAbbrevMonthName13||99||Abbreviation of month 13 | |||
|- | |||
|sName||100||OS/2 locale name | |||
|- | |||
|sLanguageID||101||Abbreviation for language (ISO) | |||
|- | |||
|sCountryID||102||Abbreviation for country (ISO) | |||
|- | |||
|sEngLanguage||103||English name of Language | |||
|- | |||
|sLanguage||104||Native name of language | |||
|- | |||
|sEngCountry||105||English name of country | |||
|- | |||
|sCountry||106||Localized country name | |||
|- | |||
|sNativeCtryName||107||Name of country in native language | |||
|- | |||
|iCountry||108||Country code | |||
|- | |||
|sISOCodepage||109||ISO codepage name | |||
|- | |||
|iAnsiCodepage 110 Windows codepage | |||
|- | |||
|iCodepage 111 OS/2 primary codepage | |||
|- | |||
|iAltCodepage 112 OS/2 alternate codepage | |||
|- | |||
|iMacCodepage 113 Mac codepage | |||
|- | |||
|iEbcdicCodepage 114 Ebcdic codepage | |||
|- | |||
|sOtherCodepages 115 Other ASCII codepages | |||
|- | |||
|sSetCodepage 116 Codpage to set on activation | |||
|- | |||
|sKeyboard 117 Primary keyboard name | |||
|- | |||
|sAltKeyboard 118 Alternate keyboard name | |||
|- | |||
|sSetKeyboard 119 Keyboard to set on activation | |||
|- | |||
|sDebit 120 Debit string | |||
|- | |||
|sCredit 121 Credit string | |||
|- | |||
|sLatin1Locale 122 Locale for Latin 1 names | |||
|- | |||
|wTimeFormat 123 Win32 Time format | |||
|- | |||
|wShortDate 124 Win32 Date format | |||
|- | |||
|wLongDate 125 Win32 Long date format | |||
|- | |||
|jISO3CountryName 126 Java abbrev for country (ISO-3) | |||
|- | |||
|jPercentPattern 127 Java percent pattern | |||
|- | |||
|jPercentSign 128 Java percent symbol | |||
|- | |||
|jExponent 129 Java exponential symbol | |||
|- | |||
|jFullTimeFormat 130 Java full time format | |||
|- | |||
|jLongTimeFormat 131 Java long time format | |||
|- | |||
|jShortTimeFormat 132 Java short time format | |||
|- | |||
|jFullDateFormat 133 Java full date format | |||
|- | |||
|jMediumDateFormat 134 Java medium date format | |||
|- | |||
|jDateTimePattern 135 Java date time format pattern | |||
|- | |||
|jEraStrings 136 Java era strings | |||
|} | |} | ||
;locale:The name of the locale whose values are being queried. Locale names are usually of the form "xx_YY", where "xx" is a language and YY is a country (e.g. "en_US", "zh_TW", "it_IT", etc.) The default is to use the current locale as defined by the LANG and LC_* environment variables. | ;locale:The name of the locale whose values are being queried. Locale names are usually of the form "xx_YY", where "xx" is a language and YY is a country (e.g. "en_US", "zh_TW", "it_IT", etc.) The default is to use the current locale as defined by the LANG and LC_* environment variables. | ||
;codepage:The codepage into which the returned value will be converted. (Locale item values are stored internally as Unicode UCS-2 text. To return the value in UCS-2, specify codepage 1200.) | ;codepage:The codepage into which the returned value will be converted. (Locale item values are stored internally as Unicode UCS-2 text. To return the value in UCS-2, specify codepage 1200.) |
Revision as of 20:02, 12 December 2022
Queries the value of the specified locale item.
Arguments
ULSQueryLocaleItem( item [, locale][, codepage][, subchar ])
Parameters
- item
- The name or number of the locale item to be queried. This must be one of the items listed below. (The name, if used, is not case-sensitive.)
NAME | NUMBER | DESCRIPTION |
---|---|---|
sDateTime | 1 | Date and time format string |
sShortDate | 2 | Short date format |
sTimeFormat | 3 | Time format string |
s1159 | 4 | AM string |
s2359 | 5 | PM string |
sAbbrevDayName7 | 6 | Abbreviation of day 7 (Sun) |
sAbbrevDayName1 | 7 | Abbreviation of day 1 (Mon) |
sAbbrevDayName2 | 8 | Abbreviation of day 2 (Tue) |
sAbbrevDayName3 | 9 | Abbreviation of day 3 (Wed) |
sAbbrevDayName4 | 10 | Abbreviation of day 4 (Thu) |
sAbbrevDayName5 | 11 | Abbreviation of day 5 (Fri) |
sAbbrevDayName6 | 12 | Abbreviation of day 6 (Sat) |
sDayName7 | 13 | Name of day of week 7 (Sun) |
sDayName1 | 14 | Name of day of week 1 (Mon) |
sDayName2 | 15 | Name of day of week 2 (Tue) |
sDayName3 | 16 | Name of day of week 3 (Wed) |
sDayName4 | 17 | Name of day of week 4 (Thu) |
sDayName5 | 18 | Name of day of week 5 (Fri) |
sDayName6 | 19 | Name of day of week 6 (Sat) |
sAbbrevMonthName1 | 20 | Abbreviation of month 1 |
sAbbrevMonthName2 | 21 | Abbreviation of month 2 |
sAbbrevMonthName3 | 22 | Abbreviation of month 3 |
sAbbrevMonthName4 | 23 | Abbreviation of month 4 |
sAbbrevMonthName5 | 24 | Abbreviation of month 5 |
sAbbrevMonthName6 | 25 | Abbreviation of month 6 |
sAbbrevMonthName7 | 26 | Abbreviation of month 7 |
sAbbrevMonthName8 | 27 | Abbreviation of month 8 |
sAbbrevMonthName9 | 28 | Abbreviation of month 9 |
sAbbrevMonthName10 | 29 | Abbreviation of month 10 |
sAbbrevMonthName11 | 30 | Abbreviation of month 11 |
sAbbrevMonthName12 | 31 | Abbreviation of month 12 |
sMonthName1 | 32 | Name of month 1 |
sMonthName2 | 33 | Name of month 2 |
sMonthName3 | 34 | Name of month 3 |
sMonthName4 | 35 | Name of month 4 |
sMonthName5 | 36 | Name of month 5 |
sMonthName6 | 37 | Name of month 6 |
sMonthName7 | 38 | Name of month 7 |
sMonthName8 | 39 | Name of month 8 |
sMonthName9 | 40 | Name of month 9 |
sMonthName10 | 41 | Name of month 10 |
sMonthName11 | 42 | Name of month 11 |
sMonthName12 | 43 | Name of month 12 |
sDecimal | 44 | Decimal point |
sThousand | 45 | Triad separator |
sYesString | 46 | Yes string |
sNoString | 47 | No string |
sCurrency | 48 | Currency symbol |
sCodeSet | 49 | Locale codeset |
xLocaleToken | 50 | IBM Locale Token |
xWinLocale | 51 | Win32 Locale ID |
iLocaleResnum | 52 | Resource number for description |
sNativeDigits | 53 | String of native digits |
iMaxItem 54 Maximum item number | ||
sTimeMark 55 Time mark (am/pm) format | ||
sEra | 56 | Era definition |
sAltShortDate 57 Alternate short date format string | ||
sAltDateTime 58 Alternate date and time format | ||
sAltTimeFormat 59 Alternate time format | ||
sAltDigits 60 XPG4 alternate digits | ||
sYesExpr 61 XPG4 Yes expression | ||
sNoExpr 62 XPG4 No expression | ||
sDate | 63 | Short date separator |
sTime | 64 | Time separator |
sList | 65 | List separator |
sMonDecimalSep | 66 | Monetary currency separator |
sMonThousandSep | 67 | Monetary triad separator |
sGrouping | 68 | Grouping of digits |
sMonGrouping | 69 | Monetary groupings |
iMeasure | 70 | Measurement (Metric, British) |
iPaper | 71 | Normal paper size |
iDigits | 72 | Digits to right of decimal |
iTime | 73 | Clock format |
iDate | 74 | Format of short date |
iCurrency | 75 | Format of currency |
iCurrDigits | 76 | Digits to right for currency |
iLzero | 77 | Leading zero used |
iNegNumber | 78 | Format of negative number |
iLDate | 79 | Format of long date |
iCalendarType | 80 | Type of default calendar |
iFirstDayOfWeek | 81 | First day of week (0=Mon) |
iFirstWeekOfYear | 82 | First week of year |
iNegCurr | 83 | Format of negative currency |
iTLzero | 84 | Leading zero on time |
iTimePrefix | 85 | AM/PM preceeds time |
iOptionalCalendar | 86 | Alternate calendar type |
sIntlSymbol | 87 | International currency symbol |
sAbbrevLangName | 88 | Windows language abbreviation |
sCollate | 89 | Collation table |
iUpperType | 90 | Upper case algorithm |
iUpperMissing | 91 | Action for missing upper case |
sPositiveSign | 92 | Positive sign |
sNegativeSign | 93 | Negative sign |
sLeftNegative | 94 | Left paren for negative |
sRightNegative | 95 | Right paren for negative |
sLongDate | 96 | Long date formatting string |
sAltLongDate | 97 | Alternate long date format string |
sMonthName13 | 98 | Name of month 13 |
sAbbrevMonthName13 | 99 | Abbreviation of month 13 |
sName | 100 | OS/2 locale name |
sLanguageID | 101 | Abbreviation for language (ISO) |
sCountryID | 102 | Abbreviation for country (ISO) |
sEngLanguage | 103 | English name of Language |
sLanguage | 104 | Native name of language |
sEngCountry | 105 | English name of country |
sCountry | 106 | Localized country name |
sNativeCtryName | 107 | Name of country in native language |
iCountry | 108 | Country code |
sISOCodepage | 109 | ISO codepage name |
iAnsiCodepage 110 Windows codepage | ||
iCodepage 111 OS/2 primary codepage | ||
iAltCodepage 112 OS/2 alternate codepage | ||
iMacCodepage 113 Mac codepage | ||
iEbcdicCodepage 114 Ebcdic codepage | ||
sOtherCodepages 115 Other ASCII codepages | ||
sSetCodepage 116 Codpage to set on activation | ||
sKeyboard 117 Primary keyboard name | ||
sAltKeyboard 118 Alternate keyboard name | ||
sSetKeyboard 119 Keyboard to set on activation | ||
sDebit 120 Debit string | ||
sCredit 121 Credit string | ||
sLatin1Locale 122 Locale for Latin 1 names | ||
wTimeFormat 123 Win32 Time format | ||
wShortDate 124 Win32 Date format | ||
wLongDate 125 Win32 Long date format | ||
jISO3CountryName 126 Java abbrev for country (ISO-3) | ||
jPercentPattern 127 Java percent pattern | ||
jPercentSign 128 Java percent symbol | ||
jExponent 129 Java exponential symbol | ||
jFullTimeFormat 130 Java full time format | ||
jLongTimeFormat 131 Java long time format | ||
jShortTimeFormat 132 Java short time format | ||
jFullDateFormat 133 Java full date format | ||
jMediumDateFormat 134 Java medium date format | ||
jDateTimePattern 135 Java date time format pattern | ||
jEraStrings 136 Java era strings |
- locale
- The name of the locale whose values are being queried. Locale names are usually of the form "xx_YY", where "xx" is a language and YY is a country (e.g. "en_US", "zh_TW", "it_IT", etc.) The default is to use the current locale as defined by the LANG and LC_* environment variables.
- codepage
- The codepage into which the returned value will be converted. (Locale item values are stored internally as Unicode UCS-2 text. To return the value in UCS-2, specify codepage 1200.)
- subchar
- The substitution character for the target codepage. This is a two-letter hexadecimal value between 00 and FF which represents the character in the target codepage which will be used to represent substituted (i.e. unsupported) characters. The default value depends on the codepage; for most single-byte codepages it is 0x7F (?).
- NOTE: Not all codepages appear to honour this setting!
Returns
The value of the specified locale item, as converted into the requested codepage.
Example
Code
/* Query the name of the language for locale 'es_AR' (Argentina) * in both English and the localized language itself. */ englang = ULSQueryLocaleItem('sEngLanguage', 'es_AR', 850 ) IF ULSERR \= '0' THEN DO SAY ULSERR RETURN END natlang = ULSQueryLocaleItem('sLanguage', 'es_AR', 850 ) IF ULSERR \= '0' THEN DO SAY ULSERR RETURN END SAY 'The default language for locale es_AR is "'englang'" ("'natlang'")'
Output
The default language for locale es_AR is "Spanish" ("Español")