GnomeDesktop.WallClock

Subclasses:

None

Methods

Inherited:

GObject.Object (37)

Structs:

GObject.ObjectClass (5)

class	new ()
	get_clock ()
	get_timezone ()
	string_for_datetime (now, clock_format, show_weekday, show_full_date, show_seconds)

Virtual Methods

Inherited:

GObject.Object (7)

Properties

Name	Type	Flags	Short Description
clock	str	r
force-seconds	bool	r/w
time-only	bool	r/w
timezone	GLib.TimeZone	r

Signals

Inherited:

GObject.Object (1)

Fields

Inherited:

GObject.Object (1)

Name	Type	Access	Description
parent_object	GObject.Object	r

Class Details

class GnomeDesktop.WallClock(**kwargs)

Bases:

GObject.Object

Abstract:

No

Structure:

GnomeDesktop.WallClockClass

classmethod new()

Returns:

the new clock

Return type:

GnomeDesktop.WallClock

Creates a new GnomeDesktop.WallClock

get_clock()

Returns:

the time of the clock as a string. This string points to internally allocated storage and must not be freed, modified or stored.

Return type:

str

Returns the string representing the current time of this clock according to the user settings.

get_timezone()

Returns:

the GLib.TimeZone of the clock.

Return type:

GLib.TimeZone

Returns the current local time zone used by this clock.

string_for_datetime(now, clock_format, show_weekday, show_full_date, show_seconds)

Parameters:

• now (GLib.DateTime) –

• clock_format (GDesktopEnums.ClockFormat) –

• show_weekday (bool) –

• show_full_date (bool) –

• show_seconds (bool) –

Returns:

a newly allocated string representing the date & time passed, with the options applied.

Return type:

str

Property Details

GnomeDesktop.WallClock.props.clock

Name:

clock

Type:

str

Default Value:

None

Flags:

READABLE

A formatted string representing the current clock display.

GnomeDesktop.WallClock.props.force_seconds

Name:

force-seconds

Type:

bool

Default Value:

False

Flags:

READABLE, WRITABLE

If True, the formatted clock will always have seconds precision and the ‘clock’ property will always be updated every second, irrespective of system configuration.

GnomeDesktop.WallClock.props.time_only

Name:

time-only

Type:

bool

Default Value:

False

Flags:

READABLE, WRITABLE

If True, the formatted clock will never include a date or the day of the week, irrespective of configuration.

GnomeDesktop.WallClock.props.timezone

Name:

timezone

Type:

GLib.TimeZone

Default Value:

None

Flags:

READABLE

The timezone used for this clock