Platforms to show: All Mac Windows Linux Cross-Platform

Back to NSLocaleMBS class.

NSLocaleMBS.autoupdatingCurrentLocale as NSLocaleMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 9.1 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns the current logical locale for the current user.

The current logical locale for the current user. The locale is formed from the settings for the current user's chosen system locale overlaid with any custom settings the user has specified in System Preferences.

The object always reflects the current state of the current user's locale settings.

Settings you get from this locale do change as the user's settings change (contrast with currentLocale).

Note that if you cache values based on the locale or related information, those caches will of course not be automatically updated by the updating of the locale object.

Available in Mac OS X v10.5 and later.

NSLocaleMBS.availableLocaleIdentifiers as string()

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 7.4 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns an array of strings, each of which identifies a locale available on the system.
Example
MsgBox join(NSLocaleMBS.availableLocaleIdentifiers,", ")

// shows "zh_Hans_CN, sq_AL, he_IL, uz_Latn, en_CA, zh, kk_Cyrl, sr_Cyrl,
// fr_CA, sr_Cyrl_RS, fr_LU, bg_BG, es_ES, da_DK, el_CY, ja_JP, kok_IN,
// mt_MT, ar_JO, de_LU, uz_Cyrl, pt_PT, af, ms_MY, nl_BE, es_US, en_PH,
// es_HN, be, sr_Latn_BA, es_CR, ca, vi_VN, zh_Hant_HK, bg, gu_IN, si_LK,
// am, or_IN, en_ZA, ar_YE, da, uk_UA, ar_OM, es_PE, cs_CZ, kk_Cyrl_KZ,
// de_AT, lv_LV, en_NZ, ar_BH, ar, en_AU, az_Cyrl, de, as, bn, zh_Hans_SG,
// es_PY, es_EC, ne_IN, pa_Guru_IN, fa, sw_KE, es_AR, az, fr_FR,
// en_US_POSIX, sr_Cyrl_BA, cs, zh_Hans, eu_ES, ga, en_PK, ar_LB, el,
// zh_Hant_TW, et_EE, fi, en, uz_Arab_AF, sw_TZ, it_CH, en_ZW, ha, eo,
// ar_SA, cy, th_TH, bn_BD, te_IN, ml_IN, he, es, fo, en_IN, et, om_KE,
// haw, eu, gl, ta_IN, zh_Hans_MO, id, fr, hi, ja, es_SV, hu_HU, en_SG,
// nn_NO, az_Latn, ii, id_ID, es_DO, fr_CH, ka, es_UY, en_MT, ar_QA, ar_TN,
// gu, de_CH, gv, sk_SK, hr, kn_IN, de_LI, ar_EG, el_GR, ar_SD, hu, af_NA,
// zh_Hant, ti_ER, ar_LY, is, ka_GE, it, om_ET, hy, ii_CN, hr_HR, ps_AF,
// pa_Arab_PK, es_NI, en_TT, pa_Guru, kk, kl, be_BY, km, zh_Hans_HK, kn,
// sv_SE, es_BO, ko, nb, ne_NP, pa_Arab, fr_MC, is_IS, ne, ar_SY, mk,
// uz_Arab, so_KE, ml, it_IT, hy_AM, sl_SI, ti_ET, uz_Latn_UZ, ar_AE,
// lt_LT, kw, pa, lt, nl, lv, so_SO, mr, nn, ru_RU, ms, ga_IE, fo_FO, mt,
// om, ar_MA, ms_BN, pl, ha_Latn, kok, mk_MK, or, uz_Cyrl_UZ, so_ET, de_DE,
// gl_ES, en_BW, en_JM, ar_IQ, ps, az_Latn_AZ, ta, pt, so_DJ, nl_NL, af_ZA,
// nb_NO, en_HK, fr_SN, si, km_KH, te, ro, ko_KR, mr_IN, sk, en_BE, en_MH,
// sl, th, ti, fr_BE, es_CL, pt_BR, en_VI, es_VE, sr_Latn_ME, so, hi_IN,
//as_IN, ru, de_BE, sq, en_GB, sr, fa_AF, es_MX, kw_GB, es_PR, ro_RO, uk,
// cy_GB, en_NA, fi_FI, ca_ES, az_Cyrl_AZ, en_IE, gv_GB, sv, tr, sw, vi,
// en_BZ, en_US, hy_AM_REVISED, ru_UA, ur_PK, ur, sr_Latn_RS, am_ET, bn_IN,
// ar_KW, haw_US, sr_Cyrl_ME, es_PA, es_CO, kl_GL, sr_Latn, uz, ur_IN,
// zh_Hant_MO, ha_Latn_NG, es_GT, tr_TR, fa_IR, pl_PL, sv_FI, ar_DZ"

Available in Mac OS X v10.4 and later.

Some examples using this method:

NSLocaleMBS.canonicalLanguageIdentifierFromString(s as string) as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 9.6 ✅ Yes ❌ No ❌ No ✅ Yes All
eturns a canonical language identifier by mapping an arbitrary locale identification string to the canonical identifier.

s: A string representation of an arbitrary locale identifier.
Returns a string that represents the canonical language identifier for the specified arbitrary locale identifier.
Available in Mac OS X v10.6 and later.

NSLocaleMBS.canonicalLocaleIdentifierFromString(s as string) as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 7.4 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns the canonical identifier for a given locale identification string.

Available in Mac OS X v10.4 and later.

NSLocaleMBS.characterDirectionForLanguage(isoLangCode as string) as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 9.6 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns the character direction for the specified ISO language code.

Returns the character direction for the language. See constants for possible values. If the appropriate direction can't be determined NSLocaleLanguageDirectionUnknown is returned.

Available in Mac OS X v10.6 and later.

NSLocaleMBS.commonISOCurrencyCodes as string()

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 9.6 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns an array of common ISO currency codes.
Example
MsgBox join(NSLocaleMBS.commonISOCurrencyCodes,", ")

// shows "AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN,
// BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN,
// BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUP, CVE,
// CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP,
// GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GWP, GYD, HKD, HNL, HRK,
// HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES,
// KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD,
// LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO,
// MUR, MVR, MWK, MXN, MYR, MZE, MZN, NAD, NGN, NIO, NOK, NPR,
// NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD,
// RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SKK, SLL, SOS,
// SRD, STD, SVC, SYP, SZL, THB, TJS, TMM, TND, TOP, TRY, TTD,
// TWD, TZS, UAH, UGX, USD, UYU, UZS, VEF, VND, VUV, WST, XAF,
// XCD, XOF, XPF, YER, ZAR, ZMK, ZWD"

Common codes may include, for example, AED, AUD, BZD, DKK, EUR, GBP, JPY, KES, MXN, OMR, STD, USD, XCD, and ZWD.
Available in Mac OS X v10.5 and later.

NSLocaleMBS.currentLocale as NSLocaleMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 7.4 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns the logical locale for the current user.

Available in Mac OS X v10.4 and later.

The logical locale for the current user. The locale is formed from the settings for the current user's chosen system locale overlaid with any custom settings the user has specified in System Preferences.

This method may return a retained cached object.

Discussion:
Settings you get from this locale do not change as System Preferences are changed so that your operations are consistent. Typically you perform some operations on the returned object and then allow it to be disposed of. Moreover, since the returned object may be cached, you do not need to hold on to it indefinitely.

NSLocaleMBS.ISOCountryCodes as string()

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 7.4 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns an array of strings that represents all known legal country codes.
Example
MsgBox join(NSLocaleMBS.ISOCountryCodes,", ")

// shows "AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU,
// AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO,
// BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL,
// CM, CN, CO, CR, CU, CV, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC,
// EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE,
// GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK,
// HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE,
// JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB,
// LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH,
// MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ,
// NA, NC, NE, NF, NG, NI, NL, false, NP, NR, NU, NZ, OM, PA, PE, PF,
// PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU,
// RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR,
// ST, SV, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR,
// TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN,
// VU, WF, WS, YE, YT, ZA, ZM, ZW"

Available in Mac OS X v10.4 and later.
Note that many of country codes do not have any supporting locale data in Mac OS X.

NSLocaleMBS.ISOCurrencyCodes as string()

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 7.4 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns an array of strings that represents all known legal ISO currency codes.
Example
MsgBox join(NSLocaleMBS.ISOCurrencyCodes,", ")

// shows "ADP, AED, AFA, AFN, ALK, ALL, AMD, ANG, AOA, AOK, AON, AOR,
// ARA, ARP, ARS, ATS, AUD, AWG, AZM, AZN, BAD, BAM, BBD, BDT, BEC,
// BEF, BEL, BGL, BGM, BGN, BHD, BIF, BMD, BND, BOB, BOP, BOV, BRB,
// BRC, BRE, BRL, BRN, BRR, BSD, BTN, BUK, BWP, BYB, BYR, BZD, CAD,
// CDF, CHE, CHF, CHW, CLF, CLP, CNX, CNY, COP, COU, CRC, CSD, CSK,
// CUP, CVE, CYP, CZK, DDM, DEM, DJF, DKK, DOP, DZD, ECS, ECV, EEK,
// EGP, EQE, ERN, ESA, ESB, ESP, ETB, EUR, FIM, FJD, FKP, FRF, GBP,
// GEK, GEL, GHC, GHS, GIP, GMD, GNF, GNS, GQE, GRD, GTQ, GWE, GWP,
// GYD, HKD, HNL, HRD, HRK, HTG, HUF, IDR, IEP, ILP, ILS, INR, IQD,
// IRR, ISK, ITL, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD,
// KYD, KZT, LAK, LBP, LKR, LRD, LSL, LSM, LTL, LTT, LUC, LUF, LUL,
// LVL, LVR, LYD, MAD, MAF, MDL, MGA, MGF, MKD, MLF, MMK, MNT, MOP,
// MRO, MTL, MTP, MUR, MVR, MWK, MXN, MXP, MXV, MYR, MZE, MZM, MZN,
// NAD, NGN, NIC, NIO, NLG, NOK, NPR, NZD, OMR, PAB, PEI, PEN, PES,
// PGK, PHP, PKR, PLN, PLZ, PTE, PYG, QAR, RHD, ROL, RON, RSD, RUB,
// RUR, RWF, SAR, SBD, SCR, SDD, SDG, SDP, SEK, SGD, SHP, SIT, SKK,
// SLL, SOS, SRD, SRG, STD, SUR, SVC, SYP, SZL, THB, TJR, TJS, TMM,
// TND, TOP, TPE, TRL, TRY, TTD, TWD, TZS, UAH, UAK, UGS, UGX, USD,
// USN, USS, UYP, UYI, UYU, UZS, VEB, VEF, VND, VUV, WST, XAF, XAG,
// XAU, XBA, XBB, XBC, XBD, XCD, XDR, XEU, XFO, XFU, XOF, XPD, XPF,
// XPT, XRE, XTS, XXX, YDD, YER, YUD, YUM, YUN, ZAL, ZAR, ZMK, ZRN,
// ZRZ, ZWD"

Available in Mac OS X v10.4 and later.

Note that some of the currency codes may not have any supporting locale data in Mac OS X.

NSLocaleMBS.ISOLanguageCodes as string()

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 7.4 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns an array of strings that represents all known legal ISO language codes.
Example
MsgBox join(NSLocaleMBS.ISOLanguageCodes,", ")

// shows "aa, ab, ace, ach, ada, ady, ae, af, afa, afh, ain, ak, akk,
// ale, alg, alt, am, an, ang, anp, apa, ar, arc, arn, arp, art, arw,
// as, ast, ath, aus, av, awa, ay, az, ba, bad, bai, bal, ban, bas,
// bat, be, bej, bem, ber, bg, bh, bho, bi, bik, bin, bla, bm, bn, bnt,
// bo, br, bra, bs, btk, bua, bug, byn, ca, cad, cai, car, cau, cch,
// ce, ceb, cel, ch, chb, chg, chk, chm, chn, cho, chp, chr, chy, cmc,
// co, cop, cpe, cpf, cpp, cr, crh, crp, cs, csb, cu, cus, cv, cy, da,
// dak, dar, day, de, del, den, dgr, din, doi, dra, dsb, dua, dum, dv,
// dyu, dz, ee, efi, egy, eka, el, elx, en, enm, eo, es, et, eu, ewo,
// fa, fan, fat, ff, fi, fil, fiu, fj, fo, fon, fr, frm, fro, frr, frs,
// fur, fy, ga, gaa, gay, gba, gd, gem, gez, gil, gl, gmh, gn, goh,
// gon, gor, got, grb, grc, gsw, gu, gv, gwi, ha, hai, haw, he, hi,
// hil, him, hit, hmn, ho, hr, hsb, ht, hu, hup, hy, hz, ia, iba, id,
// ie, ig, ii, ijo, ik, ilo, inc, ine, inh, io, ira, iro, is, it, iu,
// ja, jbo, jpr, jrb, jv, ka, kaa, kab, kac, kaj, kam, kar, kaw, kbd,
// kcg, kfo, kg, kha, khi, kho, ki, kj, kk, kl, km, kmb, kn, ko, kok,
// kos, kpe, kr, krc, krl, kro, kru, ks, ku, kum, kut, kv, kw, ky, la,
// lad, lah, lam, lb, lez, lg, li, ln, lo, lol, loz, lt, lu, lua, lui,
// lun, luo, lus, lv, mad, mag, mai, mak, man, map, mas, mdf, mdr, men,
// mg, mga, mh, mi, mic, min, mis, mk, mkh, ml, mn, mnc, mni, mno, mo,
// moh, mos, mr, ms, mt, mul, mun, mus, mwl, mwr, my, myn, myv, na,
// nah, nai, nap, nb, nd, nds, ne, new, ng, nia, nic, niu, nl, nn, no,
// nog, non, nqo, nr, nso, nub, nv, nwc, ny, nym, nyn, nyo, nzi, oc,
// oj, om, or, os, osa, ota, oto, pa, paa, pag, pal, pam, pap, pau,
// peo, phi, phn, pi, pl, pon, pra, pro, ps, pt, qu, raj, rap, rar, rm,
// rn, ro, roa, rom, ru, rup, rw, sa, sad, sah, sai, sal, sam, sas,
// sat, sc, scn, sco, sd, se, sel, sem, sg, sga, sgn, shn, si, sid,
// sio, sit, sk, sl, sla, sm, sma, smi, smj, smn, sms, sn, snk, so,
// sog, son, sq, sr, srn, srr, ss, ssa, st, su, suk, sus, sux, sv, sw,
// syc, syr, ta, tai, te, tem, ter, tet, tg, th, ti, tig, tiv, tk, tkl,
// tl, tlh, tli, tmh, tn, to, tog, tpi, tr, ts, tsi, tt, tum, tup, tut,
// tvl, tw, ty, tyv, udm, ug, uga, uk, umb, und, ur, uz, vai, ve, vi,
// vo, vot, wa, wak, wal, war, was, wen, wo, xal, xh, yao, yap, yi, yo,
// ypk, za, zap, zbl, zen, zh, znd, zu, zun, zxx, zza"

Available in Mac OS X v10.4 and later.

Note that many of the language codes will not have any supporting locale data in Mac OS X.

NSLocaleMBS.lineDirectionForLanguage(isoLangCode as string) as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 9.6 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns the line direction for the specified ISO language code.

Returns the line direction for the language. See constants for possible values. If the appropriate direction can't be determined NSLocaleLanguageDirectionUnknown is returned.

Available in Mac OS X v10.6 and later.

NSLocaleMBS.localeIdentifierFromWindowsLocaleCode(code as Integer) as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 9.6 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns a locale identifier from a Windows locale code.

Available in Mac OS X v10.6 and later.

NSLocaleMBS.localeWithLocaleIdentifier(LocaleIdentifier as String) as NSLocaleMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 24.3 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns a locale initialized using the given locale identifier.
Example
Var l As NSLocaleMBS = NSLocaleMBS.localeWithLocaleIdentifier("en_US")
MessageBox l.localeIdentifier+": "+l.localizedStringForLocaleIdentifier(l.localeIdentifier)

NSLocaleMBS.preferredLanguages as string()

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 9.6 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns the user's language preference order as an array of strings.
Example
MsgBox join(NSLocaleMBS.preferredLanguages,", ")

// shows "de, en, fr, es, it, pt, pt-PT, nl, sv, nb, da, fi, ru, pl, zh-Hans, ja, zh-Hant, ko"

The user's language preference order as an array of String objects, each of which is a canonicalized IETF BCP 47 language identifier.

Available in Mac OS X v10.5 and later.
This is the language the user prefers. To get the country linked to the number and date formats, use the CountryCode property.

NSLocaleMBS.systemLocale as NSLocaleMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 7.4 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns the "root", canonical locale, that contains fixed "backstop" settings that provide values for otherwise undefined keys.

Available in Mac OS X v10.4 and later.

NSLocaleMBS.windowsLocaleCodeFromLocaleIdentifier(s as string) as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Currency, Date and Time Format MBS MacBase Plugin 9.6 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns a Window locale code from the locale identifier.

Available in Mac OS X v10.6 and later.

The items on this page are in the following plugins: MBS MacBase Plugin.


The biggest plugin in space...