OobsTimeConfig

OobsTimeConfig — Object that represents time configuration

Synopsis

                    OobsTimeConfig;
OobsObject*         oobs_time_config_get                (void);
glong               oobs_time_config_get_unix_time      (OobsTimeConfig *config);
void                oobs_time_config_set_unix_time      (OobsTimeConfig *config,
                                                         glong unix_time);
void                oobs_time_config_get_time           (OobsTimeConfig *config,
                                                         gint *year,
                                                         gint *month,
                                                         gint *day,
                                                         gint *hour,
                                                         gint *minute,
                                                         gint *second);
void                oobs_time_config_set_time           (OobsTimeConfig *config,
                                                         gint year,
                                                         gint month,
                                                         gint day,
                                                         gint hour,
                                                         gint minute,
                                                         gint second);
void                oobs_time_config_get_utc_time       (OobsTimeConfig *config,
                                                         gint *year,
                                                         gint *month,
                                                         gint *day,
                                                         gint *hour,
                                                         gint *minute,
                                                         gint *second);
void                oobs_time_config_set_utc_time       (OobsTimeConfig *config,
                                                         gint year,
                                                         gint month,
                                                         gint day,
                                                         gint hour,
                                                         gint minute,
                                                         gint second);
const gchar*        oobs_time_config_get_timezone       (OobsTimeConfig *config);
void                oobs_time_config_set_timezone       (OobsTimeConfig *config,
                                                         const gchar *timezone);

Object Hierarchy

  GObject
   +----OobsObject
         +----OobsTimeConfig

Properties

  "timezone"                 gchar*                : Read / Write
  "unix-time"                glong                 : Read / Write

Description

Details

OobsTimeConfig

typedef struct _OobsTimeConfig OobsTimeConfig;

oobs_time_config_get ()

OobsObject*         oobs_time_config_get                (void);

Returns the OobsTimeConfig singleton, this object represents the date and time configuration.

Returns :

 the singleton OobsTimeConfig.

oobs_time_config_get_unix_time ()

glong               oobs_time_config_get_unix_time      (OobsTimeConfig *config);

Returns the time, measured in seconds, since the "epoch" (1970-01-01T00:00:00Z).

config :

 An OobsTimeConfig.

Returns :

 The unix time of the system.

oobs_time_config_set_unix_time ()

void                oobs_time_config_set_unix_time      (OobsTimeConfig *config,
                                                         glong unix_time);

This function sets the config time to be unix_time. unix_time is measured in seconds, since the "epoch" (1970-01-01T00:00:00Z).

config :

 An OobsTimeConfig.

unix_time :

 new Unix time.

oobs_time_config_get_time ()

void                oobs_time_config_get_time           (OobsTimeConfig *config,
                                                         gint *year,
                                                         gint *month,
                                                         gint *day,
                                                         gint *hour,
                                                         gint *minute,
                                                         gint *second);

Gets the system time and date in human readable values.

config :

 An OobsTimeConfig.

year :

 gint pointer to store the year, or NULL.

month :

 gint pointer to store the month, or NULL.

day :

 gint pointer to store the day, or NULL.

hour :

 gint pointer to store the hour, or NULL.

minute :

 gint pointer to store the minute, or NULL.

second :

 gint pointer to store the second, or NULL.

oobs_time_config_set_time ()

void                oobs_time_config_set_time           (OobsTimeConfig *config,
                                                         gint year,
                                                         gint month,
                                                         gint day,
                                                         gint hour,
                                                         gint minute,
                                                         gint second);

Sets the time and date of config to be the specified in the parameters.

config :

 An OobsTimeConfig.

year :

 year.

month :

 month.

day :

 day.

hour :

 hour.

minute :

 minute.

second :

 second.

oobs_time_config_get_utc_time ()

void                oobs_time_config_get_utc_time       (OobsTimeConfig *config,
                                                         gint *year,
                                                         gint *month,
                                                         gint *day,
                                                         gint *hour,
                                                         gint *minute,
                                                         gint *second);

Gets the system time and date in human readable values (UTC).

config :

 An OobsTimeConfig.

year :

 gint pointer to store the year, or NULL.

month :

 gint pointer to store the month, or NULL.

day :

 gint pointer to store the day, or NULL.

hour :

 gint pointer to store the hour, or NULL.

minute :

 gint pointer to store the minute, or NULL.

second :

 gint pointer to store the second, or NULL.

oobs_time_config_set_utc_time ()

void                oobs_time_config_set_utc_time       (OobsTimeConfig *config,
                                                         gint year,
                                                         gint month,
                                                         gint day,
                                                         gint hour,
                                                         gint minute,
                                                         gint second);

Sets the time and date of config to be the specified in the parameters (assuming they're in UTC).

config :

 An OobsTimeConfig.

year :

 year.

month :

 month.

day :

 day.

hour :

 hour.

minute :

 minute.

second :

 second.

oobs_time_config_get_timezone ()

const gchar*        oobs_time_config_get_timezone       (OobsTimeConfig *config);

Returns the timezone set for config.

config :

 An OobsTimeConfig.

Returns :

 A pointer to the timezone as a string or NULL. This string must not be freed, modified or stored.

oobs_time_config_set_timezone ()

void                oobs_time_config_set_timezone       (OobsTimeConfig *config,
                                                         const gchar *timezone);

Sets the timezone of config to be timezone, overwriting the previous one.

config :

 An OobsTimeConfig.

timezone :

 A new timezone for config.

Property Details

The "timezone" property

  "timezone"                 gchar*                : Read / Write

Timezone for the computer.

Default value: NULL

The "unix-time" property

  "unix-time"                glong                 : Read / Write

Current unix time for the computer.

Allowed values: >= 0

Default value: 0

See Also

OobsNTPConfig, OobsNTPServer