XEP 0202

1.6 Documentation

«  XEP 0199   ::   Contents   ::   XEP 0203  »

XEP 0202

class slixmpp.plugins.xep_0202.XEP_0202(xmpp, config=None)[source]

XEP-0202: Entity Time

get_entity_time(to, ifrom=None, **iqargs)[source]

Request the time from another entity.

Parameters

to (JID) – JID of the entity to query.

stanza = <module 'slixmpp.plugins.xep_0202.stanza' from '/home/docs/checkouts/readthedocs.org/user_builds/slixmpp/checkouts/slix-1.6.0/slixmpp/plugins/xep_0202/stanza.py'>

Stanza elements

Slixmpp: The Slick XMPP Library Copyright (C) 2010 Nathanael C. Fritz This file is part of Slixmpp.

See the file LICENSE for copying permission.

class slixmpp.plugins.xep_0202.stanza.EntityTime(xml=None, parent=None)[source]

The <time> element represents the local time for an XMPP agent. The time is expressed in UTC to make synchronization easier between entities, but the offset for the local timezone is also included.

Example <time> stanzas:

<iq type="result">
  <time xmlns="urn:xmpp:time">
    <utc>2011-07-03T11:37:12.234569</utc>
    <tzo>-07:00</tzo>
  </time>
</iq>

Stanza Interface:

time -- The local time for the entity (updates utc and tzo).
utc  -- The UTC equivalent to local time.
tzo  -- The local timezone offset from UTC.
del_time()[source]

Remove both the UTC and TZO fields.

get_time()[source]

Return the entity’s local time based on the UTC and TZO data.

get_tzo()[source]

Return the timezone offset from UTC as a tzinfo object.

get_utc()[source]

Return the time in UTC as a datetime object.

interfaces = {'time', 'tzo', 'utc'}
name = 'time'
namespace = 'urn:xmpp:time'
plugin_attrib = 'entity_time'
set_time(value)[source]

Set both the UTC and TZO fields given a time object.

Parameters

value – A datetime object or properly formatted string equivalent.

set_tzo(value)[source]

Set the timezone offset from UTC.

Parameters

value – Either a tzinfo object or the number of seconds (positive or negative) to offset.

set_utc(value)[source]

Set the time in UTC.

Parameters

value – A datetime object or properly formatted string equivalent.

sub_interfaces = {'time', 'tzo', 'utc'}

«  XEP 0199   ::   Contents   ::   XEP 0203  »