locale Class Reference

Static Public Member Functions
static bool	setAll (const char *value)
static const char *	getAll ()
static bool	isAllSupported ()
static bool	setCollate (const char *value)
static const char *	getCollate ()
static bool	isCollateSupported ()
static bool	setCType (const char *value)
static const char *	getCType ()
static bool	isCTypeSupported ()
static bool	setMessages (const char *value)
static const char *	getMessages ()
static bool	isMessagesSupported ()
static bool	setMonetary (const char *value)
static const char *	getMonetary ()
static bool	isMonetarySupported ()
static bool	setNumeric (const char *value)
static const char *	getNumeric ()
static bool	isNumericSupported ()
static bool	setTime (const char *value)
static const char *	getTime ()
static bool	isTimeSupported ()
static bool	setAddress (const char *value)
static const char *	getAddress ()
static bool	isAddressSupported ()
static bool	setIdentification (const char *value)
static const char *	getIdentification ()
static bool	isIdentificationSupported ()
static bool	setMeasurement (const char *value)
static const char *	getMeasurement ()
static bool	isMeasurementSupported ()
static bool	setName (const char *value)
static const char *	getName ()
static bool	isNameSupported ()
static bool	setPaper (const char *value)
static const char *	getPaper ()
static bool	isPaperSupported ()
static bool	setTelephone (const char *value)
static const char *	getTelephone ()
static bool	isTelephoneSupported ()
static char *	getNumericDecimalPoint ()
static char *	getNumericDigitGroupSeparator ()
static uint8_t	getNumericDigitGroupCount (uint8_t index)
static char *	getMonetaryDecimalPoint ()
static char *	getMonetaryDigitGroupSeparator ()
static uint8_t	getMonetaryDigitGroupCount (uint8_t index)
static char *	getMonetaryPositiveSign ()
static char *	getMonetaryNegativeSign ()
static char *	getLocalCurrencySymbol ()
static uint8_t	getLocalMonetaryDecimalDigits ()
static bool	getLocalCurrencySymbolPreceedsPositiveValue ()
static bool	getLocalSpaceSeparatesCurrencySymbolAndPositiveValue ()
static monetary_sign_position_t	getLocalMonetaryPositiveSignPosition ()
static bool	getLocalCurrencySymbolPreceedsNegativeValue ()
static bool	getLocalSpaceSeparatesCurrencySymbolAndNegativeValue ()
static monetary_sign_position_t	getLocalMonetaryNegativeSignPosition ()
static char *	getInternationalCurrencySymbol ()
static char *	getInternationalCurrencySymbolSeparator ()
static uint8_t	getInternationalMonetaryDecimalDigits ()
static bool	getInternationalCurrencySymbolPreceedsPositiveValue ()
static bool	getInternationalSpaceSeparatesCurrencySymbolAndPositiveValue ()
static monetary_sign_position_t	getInternationalMonetaryPositiveSignPosition ()
static bool	getInternationalCurrencySymbolPreceedsNegativeValue ()
static bool	getInternationalSpaceSeparatesCurrencySymbolAndNegativeValue ()
static monetary_sign_position_t	getInternationalMonetaryNegativeSignPosition ()
static bool	isSupported ()

Member Function Documentation

getAddress()

static const char* locale::getAddress ( )

static

Returns the value of the LC_ADDRESS locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_ADDRESS are not supported.

getAll()

static const char* locale::getAll ( )

static

Returns the value of the LC_ALL locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_ALL are not supported.

getCollate()

static const char* locale::getCollate ( )

static

Returns the value of the LC_COLLATE locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_COLLATE are not supported.

getCType()

static const char* locale::getCType ( )

static

Returns the value of the LC_CTYPE locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_CTYPE are not supported.

getIdentification()

static const char* locale::getIdentification ( )

static

Returns the value of the LC_IDENTIFICATION locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_IDENTIFICATION are not supported.

getInternationalCurrencySymbol()

static char* locale::getInternationalCurrencySymbol ( )

static

Returns the ISO 4217:1995 international currency symbol string, for the current locale. Eg. "USD"

Returns NULL and sets errno on error.

NOTE: This method allocates a buffer internally and returns it. The calling program must deallocate this buffer. The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getInternationalCurrencySymbolPreceedsNegativeValue()

static bool locale::getInternationalCurrencySymbolPreceedsNegativeValue ( )

static

Returns true if the currency symbol preceeds a internationally formatted negative monetary value, for the current locale, and false otherwise.

Eg.

• true for -$100
• false for 100$-

Returns false and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getInternationalCurrencySymbolPreceedsPositiveValue()

static bool locale::getInternationalCurrencySymbolPreceedsPositiveValue ( )

static

Returns true if the currency symbol preceeds a positive monetary value, for the current locale, and false otherwise.

Eg.

• true for $100
• false for 100$

Returns false and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getInternationalCurrencySymbolSeparator()

static char* locale::getInternationalCurrencySymbolSeparator ( )

static

Returns the separator character that goes between the ISO 4217:1995 international currency symbol and the monetary amount, for the current locale. Eg. " " (a space)

Returns NULL and sets errno on error.

NOTE: This method allocates a buffer internally and returns it. The calling program must deallocate this buffer. The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getInternationalMonetaryDecimalDigits()

static uint8_t locale::getInternationalMonetaryDecimalDigits ( )

static

Returns the number of digits after the decimal point for an internationally formatted monetary value, for the current locale.

Returns 0 and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getInternationalMonetaryNegativeSignPosition()

static monetary_sign_position_t locale::getInternationalMonetaryNegativeSignPosition ( )

static

Returns the position of the sign, for internationally formatted negative monetary values, for the current locale, as follows:

MONETARY_SIGN_POSITION_PARENTHESES if parentheses surround the entire string. Eg. (-$100)

MONETARY_SIGN_POSITION_BEFORE_STRING if the sign comes before the entire string. Eg. -$100

MONETARY_SIGN_POSITION_AFTER_STRING if the sign comes after the entire string. Eg. $100-

MONETARY_SIGN_POSITION_BEFORE_SYMBOL if the sign comes immediately before the currency symbol. Eg. 100-$

MONETARY_SIGN_POSITION_AFTER_SYMBOL if the sign comes immediately after the currency symbol. Eg. 100$-

MONETARY_SIGN_POSITION_ERROR and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getInternationalMonetaryPositiveSignPosition()

static monetary_sign_position_t locale::getInternationalMonetaryPositiveSignPosition ( )

static

Returns the position of the sign, for internationally formatted positive monetary values, for the current locale, as follows:

MONETARY_SIGN_POSITION_PARENTHESES if parentheses surround the entire string. Eg. ($100)

MONETARY_SIGN_POSITION_BEFORE_STRING if the sign comes before the entire string. Eg. +$100

MONETARY_SIGN_POSITION_AFTER_STRING if the sign comes after the entire string. Eg. $100+

MONETARY_SIGN_POSITION_BEFORE_SYMBOL if the sign comes immediately before the currency symbol. Eg. 100+$

MONETARY_SIGN_POSITION_AFTER_SYMBOL if the sign comes immediately after the currency symbol. Eg. 100$+

MONETARY_SIGN_POSITION_ERROR and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getInternationalSpaceSeparatesCurrencySymbolAndNegativeValue()

static bool locale::getInternationalSpaceSeparatesCurrencySymbolAndNegativeValue ( )

static

Returns true if a space separates the currency symbol and a internationally formatted negative monetary value, for the current locale, and false otherwise.

Eg.

• true for -$ 100
• false for -$100

Returns false and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getInternationalSpaceSeparatesCurrencySymbolAndPositiveValue()

static bool locale::getInternationalSpaceSeparatesCurrencySymbolAndPositiveValue ( )

static

Returns true if a space separates the currency symbol and a internationally formatted positive monetary value, for the current locale, and false otherwise.

Eg.

• true for $ 100
• false for $100

Returns false and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getLocalCurrencySymbol()

static char* locale::getLocalCurrencySymbol ( )

static

Returns the local currency symbol string, for the current locale. Eg. "$"

Returns NULL and sets errno on error.

NOTE: This method allocates a buffer internally and returns it. The calling program must deallocate this buffer. The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getLocalCurrencySymbolPreceedsNegativeValue()

static bool locale::getLocalCurrencySymbolPreceedsNegativeValue ( )

static

Returns true if the currency symbol preceeds a locally formatted negative monetary value, for the current locale, and false otherwise.

Eg.

• true for -$100
• false for 100$-

Returns false and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getLocalCurrencySymbolPreceedsPositiveValue()

static bool locale::getLocalCurrencySymbolPreceedsPositiveValue ( )

static

Returns true if the currency symbol preceeds a positive monetary value, for the current locale, and false otherwise.

Eg.

• true for $100
• false for 100$

Returns false and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getLocalMonetaryDecimalDigits()

static uint8_t locale::getLocalMonetaryDecimalDigits ( )

static

Returns the number of digits after the decimal point for an locally formatted monetary value, for the current locale.

Returns 0 and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getLocalMonetaryNegativeSignPosition()

static monetary_sign_position_t locale::getLocalMonetaryNegativeSignPosition ( )

static

Returns the position of the sign, for locally formatted negative monetary values, for the current locale, as follows:

MONETARY_SIGN_POSITION_PARENTHESES if parentheses surround the entire string. Eg. (-$100)

MONETARY_SIGN_POSITION_BEFORE_STRING if the sign comes before the entire string. Eg. -$100

MONETARY_SIGN_POSITION_AFTER_STRING if the sign comes after the entire string. Eg. $100-

MONETARY_SIGN_POSITION_BEFORE_SYMBOL if the sign comes immediately before the currency symbol. Eg. 100-$

MONETARY_SIGN_POSITION_AFTER_SYMBOL if the sign comes immediately after the currency symbol. Eg. 100$-

MONETARY_SIGN_POSITION_ERROR and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getLocalMonetaryPositiveSignPosition()

static monetary_sign_position_t locale::getLocalMonetaryPositiveSignPosition ( )

static

Returns the position of the sign, for locally formatted positive monetary values, for the current locale, as follows:

MONETARY_SIGN_POSITION_PARENTHESES if parentheses surround the entire string. Eg. ($100)

MONETARY_SIGN_POSITION_BEFORE_STRING if the sign comes before the entire string. Eg. +$100

MONETARY_SIGN_POSITION_AFTER_STRING if the sign comes after the entire string. Eg. $100+

MONETARY_SIGN_POSITION_BEFORE_SYMBOL if the sign comes immediately before the currency symbol. Eg. 100+$

MONETARY_SIGN_POSITION_AFTER_SYMBOL if the sign comes immediately after the currency symbol. Eg. 100$+

MONETARY_SIGN_POSITION_ERROR and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getLocalSpaceSeparatesCurrencySymbolAndNegativeValue()

static bool locale::getLocalSpaceSeparatesCurrencySymbolAndNegativeValue ( )

static

Returns true if a space separates the currency symbol and a locally formatted negative monetary value, for the current locale, and false otherwise.

Eg.

• true for -$ 100
• false for -$100

Returns false and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getLocalSpaceSeparatesCurrencySymbolAndPositiveValue()

static bool locale::getLocalSpaceSeparatesCurrencySymbolAndPositiveValue ( )

static

Returns true if a space separates the currency symbol and a locally formatted positive monetary value, for the current locale, and false otherwise.

Eg.

• true for $ 100
• false for $100

Returns false and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getMeasurement()

static const char* locale::getMeasurement ( )

static

Returns the value of the LC_MEASUREMENT locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_MEASUREMENT are not supported.

getMessages()

static const char* locale::getMessages ( )

static

Returns the value of the LC_MESSAGES locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_MESSAGES are not supported.

getMonetary()

static const char* locale::getMonetary ( )

static

Returns the value of the LC_MONETARY locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_MONETARY are not supported.

getMonetaryDecimalPoint()

static char* locale::getMonetaryDecimalPoint ( )

static

Returns the decimal point string, for monetary values, for the current locale.

Returns NULL and sets errno on error.

NOTE: This method allocates a buffer internally and returns it. The calling program must deallocate this buffer. The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getMonetaryDigitGroupCount()

static uint8_t locale::getMonetaryDigitGroupCount ( uint8_t  index )

static

Returns the number of digits in a group, where index 0 is the rightmost group, and subsequent indices refer to groups of digits to the left of the rightmost group, for monetary values, for the current locale.

For example...

If an amount is grouped like: $100,000,000,000 Then:

• getMonetaryDigitGroupCount(0) would return 3
• getMonetaryDigitGroupCount(1) would return 3
• getMonetaryDigitGroupCount(2) would return 3
• getMonetaryDigitGroupCount(>2) would return 3

If an amount is grouped like: $100,000,00,00 Then:

• getMonetaryDigitGroupCount(0) would return 2
• getMonetaryDigitGroupCount(1) would return 2
• getMonetaryDigitGroupCount(2) would return 3
• getMonetaryDigitGroupCount(>2) would return 3

If an amount is grouped like: $100,000,00,0 Then:

• getMonetaryDigitGroupCount(0) would return 1
• getMonetaryDigitGroupCount(1) would return 2
• getMonetaryDigitGroupCount(2) would return 3
• getMonetaryDigitGroupCount(>2) would return 3

Returns 0 if no grouping is performed at that index. Returns 0 and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getMonetaryDigitGroupSeparator()

static char* locale::getMonetaryDigitGroupSeparator ( )

static

Returns the separator string for groups of digits before the decimal point, for monetary values, for the current locale.

Returns NULL and sets errno on error.

NOTE: This method allocates a buffer internally and returns it. The calling program must deallocate this buffer. The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getMonetaryNegativeSign()

static char* locale::getMonetaryNegativeSign ( )

static

Returns the negative sign string, for monetary values, for the current locale. Eg. "-"

Returns NULL and sets errno on error.

NOTE: This method allocates a buffer internally and returns it. The calling program must deallocate this buffer. The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getMonetaryPositiveSign()

static char* locale::getMonetaryPositiveSign ( )

static

Returns the positive sign string, for monetary values, for the current locale. Eg. "+" but usually "" (empty string).

Returns NULL and sets errno on error.

NOTE: This method allocates a buffer internally and returns it. The calling program must deallocate this buffer. The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getName()

static const char* locale::getName ( )

static

Returns the value of the LC_NAME locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_NAME are not supported.

getNumeric()

static const char* locale::getNumeric ( )

static

Returns the value of the LC_NUMERIC locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_NUMERIC are not supported.

getNumericDecimalPoint()

static char* locale::getNumericDecimalPoint ( )

static

Returns the decimal point string, for non-monetary values, for the current locale.

Returns NULL and sets errno on error.

NOTE: This method allocates a buffer internally and returns it. The calling program must deallocate this buffer. The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getNumericDigitGroupCount()

static uint8_t locale::getNumericDigitGroupCount ( uint8_t  index )

static

Returns the number of digits in a group, where index 0 is the rightmost group, and subsequent indices refer to groups of digits to the left of the rightmost group, for non-monetary values, for the current locale.

For example...

If a number is grouped like: 100,000,000,000 Then:

• getNumericDigitGroupCount(0) would return 3
• getNumericDigitGroupCount(1) would return 3
• getNumericDigitGroupCount(2) would return 3
• getNumericDigitGroupCount(>2) would return 3

If a number is grouped like: 100,000,00,00 Then:

• getNumericDigitGroupCount(0) would return 2
• getNumericDigitGroupCount(1) would return 2
• getNumericDigitGroupCount(2) would return 3
• getNumericDigitGroupCount(>2) would return 3

If a number is grouped like: 100,000,00,0 Then:

• getNumericDigitGroupCount(0) would return 1
• getNumericDigitGroupCount(1) would return 2
• getNumericDigitGroupCount(2) would return 3
• getNumericDigitGroupCount(>2) would return 3

Returns 0 if no grouping is performed at that index. Returns 0 and sets errno on error.

NOTE: The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getNumericDigitGroupSeparator()

static char* locale::getNumericDigitGroupSeparator ( )

static

Returns the separator string for groups of digits before the decimal point, for non-monetary values, for the current locale.

Returns NULL and sets errno on error.

NOTE: This method allocates a buffer internally and returns it. The calling program must deallocate this buffer. The get*() methods of this class are not thread-safe, and must be protected by a mutex if multiple threads could call any of them simultaneously.

getPaper()

static const char* locale::getPaper ( )

static

Returns the value of the LC_PAPER locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_PAPER are not supported.

getTelephone()

static const char* locale::getTelephone ( )

static

Returns the value of the LC_TELEPHONE locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_TELEPHONE are not supported.

getTime()

static const char* locale::getTime ( )

static

Returns the value of the LC_TIME locale category.

Returns the value on success and NULL on failure, eg. if either locales or LC_TIME are not supported.

isAddressSupported()

static bool locale::isAddressSupported ( )

static

Returns true if the LC_ADDRESS category is supported and false otherwise.

isAllSupported()

static bool locale::isAllSupported ( )

static

Returns true if the LC_ALL category is supported and false otherwise.

isCollateSupported()

static bool locale::isCollateSupported ( )

static

Returns true if the LC_COLLATE category is supported and false otherwise.

isCTypeSupported()

static bool locale::isCTypeSupported ( )

static

Returns true if the LC_CTYPE category is supported and false otherwise.

isIdentificationSupported()

static bool locale::isIdentificationSupported ( )

static

Returns true if the LC_IDENTIFICATION category is supported and false otherwise.

isMeasurementSupported()

static bool locale::isMeasurementSupported ( )

static

Returns true if the LC_MEASUREMENT category is supported and false otherwise.

isMessagesSupported()

static bool locale::isMessagesSupported ( )

static

Returns true if the LC_MESSAGES category is supported and false otherwise.

isMonetarySupported()

static bool locale::isMonetarySupported ( )

static

Returns true if the LC_MONETARY category is supported and false otherwise.

isNameSupported()

static bool locale::isNameSupported ( )

static

Returns true if the LC_NAME category is supported and false otherwise.

isNumericSupported()

static bool locale::isNumericSupported ( )

static

Returns true if the LC_NUMERIC category is supported and false otherwise.

isPaperSupported()

static bool locale::isPaperSupported ( )

static

Returns true if the LC_PAPER category is supported and false otherwise.

isSupported()

static bool locale::isSupported ( )

static

Returns true if the platform supports locales and false otherwise.

isTelephoneSupported()

static bool locale::isTelephoneSupported ( )

static

Returns true if the LC_TELEPHONE category is supported and false otherwise.

isTimeSupported()

static bool locale::isTimeSupported ( )

static

Returns true if the LC_TIME category is supported and false otherwise.

setAddress()

static bool locale::setAddress ( const char *  value )

static

Sets the value of the LC_ADDRESS locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_ADDRESS are not supported.

setAll()

static bool locale::setAll ( const char *  value )

static

Sets the value of the LC_ALL locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_ALL are not supported.

setCollate()

static bool locale::setCollate ( const char *  value )

static

Sets the value of the LC_COLLATE locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_COLLATE are not supported.

setCType()

static bool locale::setCType ( const char *  value )

static

Sets the value of the LC_CTYPE locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_CTYPE are not supported.

setIdentification()

static bool locale::setIdentification ( const char *  value )

static

Sets the value of the LC_IDENTIFICATION locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_IDENTIFICATION are not supported.

setMeasurement()

static bool locale::setMeasurement ( const char *  value )

static

Sets the value of the LC_MEASUREMENT locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_MEASUREMENT are not supported.

setMessages()

static bool locale::setMessages ( const char *  value )

static

Sets the value of the LC_MESSAGES locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_MESSAGES are not supported.

setMonetary()

static bool locale::setMonetary ( const char *  value )

static

Sets the value of the LC_MONETARY locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_MONETARY are not supported.

setName()

static bool locale::setName ( const char *  value )

static

Sets the value of the LC_NAME locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_NAME are not supported.

setNumeric()

static bool locale::setNumeric ( const char *  value )

static

Sets the value of the LC_NUMERIC locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_NUMERIC are not supported.

setPaper()

static bool locale::setPaper ( const char *  value )

static

Sets the value of the LC_PAPER locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_PAPER are not supported.

setTelephone()

static bool locale::setTelephone ( const char *  value )

static

Sets the value of the LC_TELEPHONE locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_TELEPHONE are not supported.

setTime()

static bool locale::setTime ( const char *  value )

static

Sets the value of the LC_TIME locale category to "value".

Returns true on success and false on failure, eg. if either locales or LC_TIME are not supported.