object represents a specific geographical, political, or cultural region.
An operation that requires a Locale to perform
its task is called locale-sensitive and uses the
Locale to tailor information for the user. For example,
displaying a number is a locale-sensitive operation; the number
should be formatted according to the customs/conventions of the
user's native country, region, or culture.
Because a Locale object is just an identifier for a
region, no validity check is performed. If you want to see whether
particular resources are available for the Locale, use
the XLocale::getAvailableLocales method to ask for the
locales it supports.
Note: When you ask for a resource for a
particular locale, you get the best available match, not necessarily
precisely what you asked for. For more information, see
Each implementation that performs locale-sensitive operations
allows you to get all the available objects of that type. Use the
::com::sun::star::resource::XLocale interface to set the locale.
contains a variant of the locale; codes are vendor and
For example, use WIN for Windows, MAC for Macintosh, and POSIX
for POSIX. Wherever there are two variants, separate them with an
underscore, and put the most important one first. For example, a
traditional Spanish collation might construct a locale with parameters
for language, country and variant as: "es", "ES", "Traditional_WIN".
Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation.
The Apache feather logo is a trademark of The Apache Software Foundation.
Other names appearing on the site may be trademarks of their respective owners.