StelLocaleMgr Class Reference

Manage i18n operations such as message translation and date/time localization. More...

#include <StelLocaleMgr.hpp>

List of all members.

Public Types
enum	STimeFormat { STime24h, STime12h, STimeSystemDefault }
enum	SDateFormat { SDateMMDDYYYY, SDateDDMMYYYY, SDateSystemDefault, SDateYYYYMMDD }
enum	STzFormat { STzCustom, STzGMTShift, STzSystemDefault }
Public Member Functions
void	init ()
QString	getAppLanguage () const
void	setAppLanguage (const QString &newAppLangName)
StelTranslator &	getAppStelTranslator () const
QString	getSkyLanguage () const
void	setSkyLanguage (const QString &newSkyLangName)
StelTranslator &	getSkyTranslator ()
QString	getTimeFormatStr (void) const
void	setTimeFormatStr (const QString &tf)
QString	getDateFormatStr (void) const
void	setDateFormatStr (const QString &df)
void	setCustomTimezone (QString tZ)
QString	getPrintableDateLocal (double JD) const
QString	getPrintableTimeLocal (double JD) const
void	setGMTShift (int t)
float	getGMTShift (double JD=0) const
void	setCustomTzName (const QString &tzname)
QString	getCustomTzName (void) const
STzFormat	getTzFormat (void) const
QString	getISO8601TimeLocal (double JD) const
double	getJdFromISO8601TimeLocal (const QString &str, bool *ok) const
Static Public Member Functions
static QString	countryCodeToString (const QString &countryCode)
static QStringList	getAllCountryNames ()

---

Detailed Description

Manage i18n operations such as message translation and date/time localization.

Author:

Fabien Chereau

---

Member Enumeration Documentation

enum StelLocaleMgr::SDateFormat

The date display format.

Enumerator:

SDateMMDDYYYY	e.g. "07-05-1998" for July 5th 1998
SDateDDMMYYYY	e.g. "05-07-1998" for July 5th 1998
SDateSystemDefault	Use the system default date format.
SDateYYYYMMDD	e.g. "1998-07-05" for July 5th 1998

enum StelLocaleMgr::STimeFormat

The time display format.

Enumerator:

STime24h	24 hour clock, e.g. "18:22:00"
STime12h	12 hour clock, e.g. "06:22:00 pm"
STimeSystemDefault	use the system default format.

enum StelLocaleMgr::STzFormat

Enumerator:

STzCustom	User-specified timezone.
STzGMTShift	GMT + offset.
STzSystemDefault	System default.

---

Member Function Documentation

QString StelLocaleMgr::getAppLanguage

(

)

const [inline]

Get the application language currently used for GUI etc.

This function has no permanent effect on the global locale.

Returns:

the abbreviated name of the language (e.g "fr").

QString StelLocaleMgr::getDateFormatStr

(

void

)

const [inline]

Get the format string which describes the current date format.

Valid values:

• "mmddyyyy"
• "ddmmyyyy"
• "system_default"
• "yyyymmdd"

These values correspond to the similarly named values in the SDateFormat enum.

QString StelLocaleMgr::getISO8601TimeLocal

(

double

JD

)

const

Return the time in ISO 8601 format that is : Y-m-dTH:M:S.

Parameters:

JD

the time and date expressed as a Julian date value.

double StelLocaleMgr::getJdFromISO8601TimeLocal	(	const QString &	str,
		bool *	ok
	)			const

Return the JD time for a local time ISO 8601 format that is: Y-m-dTH:M:S, but Y can be a large number with sign, and Y can be zero.

Parameters:

	str	the local time in ISO 8601 format.
	ok	set to false if the string was an invalid date.

QString StelLocaleMgr::getSkyLanguage

(

)

const

Get the language currently used for sky objects.

This function has no permanent effect on the global locale.

Returns:

the name of the language (e.g fr).

QString StelLocaleMgr::getTimeFormatStr

(

void

)

const [inline]

Get the format string which describes the current time format.

Valid values are:

• "system_default"
• "24h"
• "12h"

These values correspond to the similarly named values in the STimeFormat enum.

void StelLocaleMgr::init

(

)

Initialize object.

This process includes:

• Setting the sky and application languages
• Setting the time and date formats
• Setting up the time zone

void StelLocaleMgr::setAppLanguage

(

const QString &

newAppLangName

)

Set the application language.

This applies to GUI etc. This function has no permanent effect on the global locale.

Parameters:

newAppLangName

the abbreviated name of the language (e.g fr).

void StelLocaleMgr::setCustomTimezone

(

QString

tZ

)

[inline]

Set the time zone.

Parameters:

tZ

the time zone string as parsed from the TZ environment varibale by the tzset function from libc.

void StelLocaleMgr::setSkyLanguage

(

const QString &

newSkyLangName

)

Set the sky language and reload the sky object names with the new translation.

This function has no permanent effect on the global locale.

Parameters:

newSkyLangName

The abbreviated name of the locale (e.g fr) to use for sky object labels.

void StelLocaleMgr::setTimeFormatStr

(

const QString &

tf

)

[inline]

Set the time format from a format string.

Parameters:

tf

values are the same as the return values for getTimeFormatStr().