<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<title>KTimeZone</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<link rel="stylesheet" type="text/css" href="../common/doxygen.css" />
<link rel="stylesheet" media="screen" type="text/css" title="KDE Colors" href="../common/kde.css" />
</head>
<body>
<div id="container">
<div id="header">
<div id="header_top">
<div>
<div>
<img alt ="" src="../common/top-kde.jpg"/>
KDE 4.4 PyKDE API Reference
</div>
</div>
</div>
<div id="header_bottom">
<div id="location">
<ul>
<li>KDE's Python API</li>
</ul>
</div>
<div id="menu">
<ul>
<li><a href="../modules.html">Overview</a></li>
<li><a href="http://techbase.kde.org/Development/Languages/Python">PyKDE Home</a></li>
<li><a href="http://kde.org/family/">Sitemap</a></li>
<li><a href="http://kde.org/contact/">Contact Us</a></li>
</ul>
</div>
</div>
</div>
<div id="body_wrapper">
<div id="body">
<div id="right">
<div class="content">
<div id="main">
<div class="clearer"> </div>
<h1>KTimeZone Class Reference</h1>
<code>from PyKDE4.kdecore import *</code>
<p>
Subclasses: <a href="../kdecore/KSystemTimeZone.html">KSystemTimeZone</a>, <a href="../kdecore/KTzfileTimeZone.html">KTzfileTimeZone</a><br />
<h2>Detailed Description</h2>
<p>Base class representing a time zone.
</p>
<p>
The KTimeZone base class contains general descriptive data about the time zone, and
provides an interface for methods to read and parse time zone definitions, and to
translate between UTC and local time. Derived classes must implement these methods,
and may also hold the actual details of the dates and times of daylight savings
changes, offsets from UTC, etc. They should be tailored to deal with the type and
format of data held by a particular type of time zone database.
</p>
<p>
If this base class is instantiated as a valid instance, it always represents the
UTC time zone.
</p>
<p>
KTimeZone is designed to work in partnership with KTimeZoneSource. KTimeZone
provides access to individual time zones, while classes derived from
KTimeZoneSource read and parse a particular format of time zone definition.
Because time zone sources can differ in what information they provide about time zones,
the parsed data retured by KTimeZoneSource can vary between different sources,
resulting in the need to create different KTimeZone classes to handle the data.
</p>
<p>
KTimeZone instances are often grouped into KTimeZones collections.
</p>
<p>
Copying KTimeZone instances is very efficient since the class data is explicitly
shared, meaning that only a pointer to the data is actually copied. To achieve
this, each class inherited from KTimeZone must have a corresponding backend
class derived from KTimeZoneBackend.
</p>
<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd> Classes derived from KTimeZone should not have their own d-pointer. The
d-pointer is instead contained in their backend class (derived from
KTimeZoneBackend). This allows KTimeZone's reference-counting of private data to
take care of the derived class's data as well, ensuring that instance data is
not deleted while any references to the class instance remains. All virtual
methods which override KTimeZone virtual methods must be defined in the
backend class instead.
</dd></dl> </p>
<p>
Base class representing a time zone
<dl class="see" compact><dt><b>See also:</b></dt><dd> KTimeZoneBackend, KTimeZoneSource, KTimeZoneData
</dd></dl>
<dl class="author" compact><dt><b>Author:</b></dt><dd> David Jarvie <djarvie@kde.org>. </dd></dl>
<dl class="author" compact><dt><b>Author:</b></dt><dd> S.R.Haque <srhaque@iee.org>. </dd></dl>
</p>
<table border="0" cellpadding="0" cellspacing="0"><tr><td colspan="2"><br><h2>Attributes</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#varInvalidOffset">InvalidOffset</a></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">time_t </td><td class="memItemRight" valign="bottom"><a class="el" href="#varInvalidTime_t">InvalidTime_t</a></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="#varUNKNOWN">UNKNOWN</a></td></tr><tr><td colspan="2"><br><h2>Methods</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KTimeZone">__init__</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> name)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KTimeZone">__init__</a> (self, <a href="../kdecore/KTimeZone.html">KTimeZone</a> tz)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KTimeZone">__init__</a> (self, <a href="../kdecore/KTimeZoneBackend.html">KTimeZoneBackend</a> impl)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qbytearray.html">QByteArray</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#abbreviation">abbreviation</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> utcDateTime)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">[<a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qbytearray.html">QByteArray</a>] </td><td class="memItemRight" valign="bottom"><a class="el" href="#abbreviations">abbreviations</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#comment">comment</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#convert">convert</a> (self, <a href="../kdecore/KTimeZone.html">KTimeZone</a> newZone, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> zoneDateTime)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#countryCode">countryCode</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#currentOffset">currentOffset</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qt.html">Qt::TimeSpec</a> basis=Qt.UTC)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KTimeZoneData.html">KTimeZoneData</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#data">data</a> (self, bool create=0)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#fromTime_t">fromTime_t</a> (self, time_t t)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#hasTransitions">hasTransitions</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isDst">isDst</a> (self, time_t t)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isDstAtUtc">isDstAtUtc</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> utcDateTime)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isValid">isValid</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="#latitude">latitude</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">[<a href="../kdecore/KTimeZone.LeapSeconds.html">KTimeZone.LeapSeconds</a>] </td><td class="memItemRight" valign="bottom"><a class="el" href="#leapSecondChanges">leapSecondChanges</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="#longitude">longitude</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#name">name</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#offset">offset</a> (self, time_t t)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#offsetAtUtc">offsetAtUtc</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> utcDateTime)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int, int secondOffset </td><td class="memItemRight" valign="bottom"><a class="el" href="#offsetAtZoneTime">offsetAtZoneTime</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> zoneDateTime)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#operator !=">operator !=</a> (self, <a href="../kdecore/KTimeZone.html">KTimeZone</a> rhs)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#operator ==">operator ==</a> (self, <a href="../kdecore/KTimeZone.html">KTimeZone</a> rhs)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#parse">parse</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">[<a href="../kdecore/KTimeZone.Phase.html">KTimeZone.Phase</a>] </td><td class="memItemRight" valign="bottom"><a class="el" href="#phases">phases</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setData">setData</a> (self, <a href="../kdecore/KTimeZoneData.html">KTimeZoneData</a> data, <a href="../kdecore/KTimeZoneSource.html">KTimeZoneSource</a> source=0)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KTimeZoneSource.html">KTimeZoneSource</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#source">source</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">time_t </td><td class="memItemRight" valign="bottom"><a class="el" href="#toTime_t">toTime_t</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> utcDateTime)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#toUtc">toUtc</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> zoneDateTime)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a>, bool secondOccurrence </td><td class="memItemRight" valign="bottom"><a class="el" href="#toZoneTime">toZoneTime</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> utcDateTime)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int, int secondIndex, bool validTime </td><td class="memItemRight" valign="bottom"><a class="el" href="#transitionIndex">transitionIndex</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> dt)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">[<a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a>] </td><td class="memItemRight" valign="bottom"><a class="el" href="#transitionTimes">transitionTimes</a> (self, <a href="../kdecore/KTimeZone.Phase.html">KTimeZone.Phase</a> phase, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> start=QDateTime(), <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> end=QDateTime())</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">[<a href="../kdecore/KTimeZone.Transition.html">KTimeZone.Transition</a>] </td><td class="memItemRight" valign="bottom"><a class="el" href="#transitions">transitions</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> start=QDateTime(), <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> end=QDateTime())</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qbytearray.html">QByteArray</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#type">type</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#updateBase">updateBase</a> (self, <a href="../kdecore/KTimeZone.html">KTimeZone</a> other)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KTimeZone.html">KTimeZone</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#utc">utc</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">[int] </td><td class="memItemRight" valign="bottom"><a class="el" href="#utcOffsets">utcOffsets</a> (self)</td></tr>
</table>
<hr><h2>Method Documentation</h2><a class="anchor" name="KTimeZone"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>name</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Constructs a UTC time zone.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>name</em> </td><td> name of the UTC time zone
</td></tr>
</table></dl>
<p>
</p></div></div><a class="anchor" name="KTimeZone"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KTimeZone.html">KTimeZone</a> </td>
<td class="paramname"><em>tz</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"></div></div><a class="anchor" name="KTimeZone"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KTimeZoneBackend.html">KTimeZoneBackend</a> </td>
<td class="paramname"><em>impl</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>A representation for unknown locations; this is a float
that does not represent a real latitude or longitude.
</p></div></div><a class="anchor" name="abbreviation"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qbytearray.html">QByteArray</a> abbreviation</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>utcDateTime</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the time zone abbreviation current at a specified time.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>utcDateTime</em> </td><td> UTC date/time. An error occurs if
<b>utcDateTime.timeSpec()</b> is not Qt.UTC.
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> time zone abbreviation, or empty string if error
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> abbreviations()
</dd></dl>
</p></div></div><a class="anchor" name="abbreviations"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">[<a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qbytearray.html">QByteArray</a>] abbreviations</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the list of time zone abbreviations used by the time zone.
This may include historical ones which are no longer in use or have
been superseded.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> list of abbreviations
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> abbreviation()
</dd></dl>
</p></div></div><a class="anchor" name="comment"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> comment</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns any comment for the time zone.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> comment, may be empty
</dd></dl>
</p></div></div><a class="anchor" name="convert"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> convert</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KTimeZone.html">KTimeZone</a> </td>
<td class="paramname"><em>newZone</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>zoneDateTime</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Converts a date/time, which is interpreted as being local time in this
time zone, into local time in another time zone.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>newZone</em> </td><td> other time zone which the time is to be converted into
<tr><td></td><td valign="top"><em>zoneDateTime</em> </td><td> local date/time. An error occurs if
<b>zoneDateTime.timeSpec()</b> is not Qt.LocalTime.
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> converted date/time, or invalid date/time if error
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> toUtc(), toZoneTime()
</dd></dl>
</p></div></div><a class="anchor" name="countryCode"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> countryCode</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the two-letter country code of the time zone.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> upper case ISO 3166 2-character country code, empty if unknown
</dd></dl>
</p></div></div><a class="anchor" name="currentOffset"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">int currentOffset</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qt.html">Qt::TimeSpec</a> </td>
<td class="paramname"><em>basis=Qt.UTC</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the current offset of this time zone to UTC or the local
system time zone. The offset is the number of seconds which you must
add to UTC or the local system time to get local time in this time zone.
</p>
<p>
Take care if you cache the results of this routine; that would
break if the result were stored across a daylight savings change.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>basis</em> </td><td> Qt.UTC to return the offset to UTC, Qt.LocalTime
to return the offset to local system time
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> offset in seconds
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> offsetAtZoneTime(), offsetAtUtc()
</dd></dl>
</p></div></div><a class="anchor" name="data"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../kdecore/KTimeZoneData.html">KTimeZoneData</a> data</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>create=0</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the detailed parsed data for the time zone.
This will return null unless either parse() has been called beforehand, or
<b>create</b> is true.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>create</em> </td><td> true to parse the zone's data first if not already parsed
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> pointer to data, or null if data has not been parsed
</dd></dl>
</p></div></div><a class="anchor" name="fromTime_t"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> fromTime_t</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">time_t </td>
<td class="paramname"><em>t</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Converts a UTC time, measured in seconds since 00:00:00 UTC 1st January 1970
(as returned by time(2)), to a UTC QDateTime value.
QDateTime.setTime_t() is limited to handling <b>t</b> >= 0, since its parameter
is unsigned. This method takes a parameter of time_t which is signed.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> converted time
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> toTime_t()
</dd></dl>
</p></div></div><a class="anchor" name="hasTransitions"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool hasTransitions</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Return whether daylight saving transitions are available for the time zone.
</p>
<p>
The base class returns false.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if transitions are available, false if not
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> transitions(), transition()
</dd></dl>
</p></div></div><a class="anchor" name="isDst"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool isDst</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">time_t </td>
<td class="paramname"><em>t</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns whether daylight savings time is in operation at a specified UTC time.
</p>
<p>
Note that time_t has a more limited range than QDateTime, so consider using
isDstAtUtc() instead.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>t</em> </td><td> the UTC time, measured in seconds since 00:00:00 UTC 1st January 1970
(as returned by time(2))
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if daylight savings time is in operation, false otherwise
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> isDstAtUtc()
</dd></dl>
</p></div></div><a class="anchor" name="isDstAtUtc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool isDstAtUtc</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>utcDateTime</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns whether daylight savings time is in operation at the given UTC date/time.
</p>
<p>
If a derived class needs to work in terms of time_t (as when accessing the
system time functions, for example), it should override both this method and
isDst() so as to implement its offset calculations in isDst(), and reimplement
this method simply as
<pre class="fragment">
isDst(toTime_t(utcDateTime));
</pre>
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>utcDateTime</em> </td><td> the UTC date/time. An error occurs if
<b>utcDateTime.timeSpec()</b> is not Qt.UTC.
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if daylight savings time is in operation, false otherwise
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> isDst()
</dd></dl>
</p></div></div><a class="anchor" name="isValid"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool isValid</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Checks whether the instance is valid.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if valid, false if invalid
</dd></dl>
</p></div></div><a class="anchor" name="latitude"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">float latitude</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the latitude of the time zone.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> latitude in degrees, UNKNOWN if not known
</dd></dl>
</p></div></div><a class="anchor" name="leapSecondChanges"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">[<a href="../kdecore/KTimeZone.LeapSeconds.html">KTimeZone.LeapSeconds</a>] leapSecondChanges</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Return all leap second adjustments, in time order.
</p>
<p>
Note that some time zone data sources (such as system time zones accessed
via the system libraries) may not provide information on leap second
adjustments. In such cases, this method will return an empty list.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> list of adjustments
</dd></dl>
</p></div></div><a class="anchor" name="longitude"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">float longitude</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the latitude of the time zone.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> latitude in degrees, UNKNOWN if not known
</dd></dl>
</p></div></div><a class="anchor" name="name"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> name</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the name of the time zone.
If it is held in a KTimeZones container, the name is the time zone's unique
identifier within that KTimeZones instance.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> name in system-dependent format
</dd></dl>
</p></div></div><a class="anchor" name="offset"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">int offset</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">time_t </td>
<td class="paramname"><em>t</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the offset of this time zone to UTC at a specified UTC time.
</p>
<p>
The offset is the number of seconds which you must add to UTC to get
local time in this time zone.
</p>
<p>
Note that time_t has a more limited range than QDateTime, so consider using
offsetAtUtc() instead.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>t</em> </td><td> the UTC time at which the offset is to be calculated, measured in seconds
since 00:00:00 UTC 1st January 1970 (as returned by time(2))
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> offset in seconds, or 0 if error
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> offsetAtUtc()
</dd></dl>
</p></div></div><a class="anchor" name="offsetAtUtc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">int offsetAtUtc</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>utcDateTime</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the offset of this time zone to UTC at the given UTC date/time.
</p>
<p>
The offset is the number of seconds which you must add to UTC to get
local time in this time zone.
</p>
<p>
If a derived class needs to work in terms of time_t (as when accessing the
system time functions, for example), it should override both this method and
offset() so as to implement its offset calculations in offset(), and
reimplement this method simply as
<pre class="fragment">
offset(toTime_t(utcDateTime));
</pre>
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>utcDateTime</em> </td><td> the UTC date/time at which the offset is to be calculated.
An error occurs if <b>utcDateTime.timeSpec()</b> is not Qt.UTC.
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> offset in seconds, or 0 if error
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> offset(), offsetAtZoneTime(), currentOffset()
</dd></dl>
</p></div></div><a class="anchor" name="offsetAtZoneTime"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">int, int secondOffset offsetAtZoneTime</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>zoneDateTime</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Returns the offset of this time zone to UTC at the given local date/time.
Because of daylight savings time shifts, the date/time may occur twice. Optionally,
the offsets at both occurrences of <b>dateTime</b> are calculated.
</p>
<p>
The offset is the number of seconds which you must add to UTC to get
local time in this time zone.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>zoneDateTime</em> </td><td> the date/time at which the offset is to be calculated. This
is interpreted as a local time in this time zone. An error
occurs if <b>zoneDateTime.timeSpec()</b> is not Qt.LocalTime.
<tr><td></td><td valign="top"><em>secondOffset</em> </td><td> if non-null, and the <b>zoneDateTime</b> occurs twice, receives the
UTC offset for the second occurrence. Otherwise, it is set
the same as the return value.
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> offset in seconds. If <b>zoneDateTime</b> occurs twice, it is the offset at the
first occurrence which is returned. If <b>zoneDateTime</b> does not exist because
of daylight savings time shifts, InvalidOffset is returned. If any other error
occurs, 0 is returned.
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> offsetAtUtc(), currentOffset()
</dd></dl>
</p></div></div><a class="anchor" name="operator !="></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool operator !=</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KTimeZone.html">KTimeZone</a> </td>
<td class="paramname"><em>rhs</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"></div></div><a class="anchor" name="operator =="></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool operator ==</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KTimeZone.html">KTimeZone</a> </td>
<td class="paramname"><em>rhs</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Checks whether this is the same instance as another one.
Note that only the pointers to the time zone data are compared, not the
contents. So it will only return equality if one instance was copied
from the other.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>rhs</em> </td><td> other instance
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the same instance, else false
</dd></dl>
</p></div></div><a class="anchor" name="parse"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool parse</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Extracts time zone detail information for this time zone from the source database.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> false if the parse encountered errors, true otherwise
</dd></dl>
</p></div></div><a class="anchor" name="phases"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">[<a href="../kdecore/KTimeZone.Phase.html">KTimeZone.Phase</a>] phases</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Return all daylight savings time phases for the time zone.
</p>
<p>
Note that some time zone data sources (such as system time zones accessed
via the system libraries) may not allow a list of daylight savings time
changes to be compiled easily. In such cases, this method will return an
empty list.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> list of phases
</dd></dl>
</p></div></div><a class="anchor" name="setData"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> setData</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KTimeZoneData.html">KTimeZoneData</a> </td>
<td class="paramname"><em>data</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KTimeZoneSource.html">KTimeZoneSource</a> </td>
<td class="paramname"><em>source=0</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Sets the detailed parsed data for the time zone, and optionally
a new time zone source object.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>data</em> </td><td> parsed data
<tr><td></td><td valign="top"><em>source</em> </td><td> if non-null, the new source object for the time zone
</td></tr>
</table></dl>
<p> <dl class="see" compact><dt><b>See also:</b></dt><dd> data()
</dd></dl>
</p></div></div><a class="anchor" name="source"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../kdecore/KTimeZoneSource.html">KTimeZoneSource</a> source</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the source reader/parser for the time zone's source database.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> reader/parser
</dd></dl>
</p></div></div><a class="anchor" name="toTime_t"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">time_t toTime_t</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>utcDateTime</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Converts a UTC QDateTime to a UTC time, measured in seconds since 00:00:00 UTC
1st January 1970 (as returned by time(2)).
QDateTime.toTime_t() returns an unsigned value. This method returns a time_t
value, which is signed.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>utcDateTime</em> </td><td> date/time. An error occurs if <b>utcDateTime.timeSpec()</b> is
not Qt.UTC.
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> converted time, or -1 if the date is out of range for time_t or
</dd></dl> <b>utcDateTime.timeSpec()</b> is not Qt.UTC
<dl class="see" compact><dt><b>See also:</b></dt><dd> fromTime_t()
</dd></dl>
</p></div></div><a class="anchor" name="toUtc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> toUtc</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>zoneDateTime</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Converts a date/time, which is interpreted as local time in this time
zone, into UTC.
</p>
<p>
Because of daylight savings time shifts, the date/time may occur twice. In
such cases, this method returns the UTC time for the first occurrence.
If you need the UTC time of the second occurrence, use offsetAtZoneTime().
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>zoneDateTime</em> </td><td> local date/time. An error occurs if
<b>zoneDateTime.timeSpec()</b> is not Qt.LocalTime.
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> UTC date/time, or invalid date/time if error
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> toZoneTime(), convert()
</dd></dl>
</p></div></div><a class="anchor" name="toZoneTime"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a>, bool secondOccurrence toZoneTime</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>utcDateTime</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Converts a UTC date/time into local time in this time zone.
</p>
<p>
Because of daylight savings time shifts, some local date/time values occur
twice. The <b>secondOccurrence</b> parameter may be used to determine whether
the time returned is the first or second occurrence of that time.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>utcDateTime</em> </td><td> UTC date/time. An error occurs if
<b>utcDateTime.timeSpec()</b> is not Qt.UTC.
<tr><td></td><td valign="top"><em>secondOccurrence</em> </td><td> if non-null, returns <b>true</b> if the return value
is the second occurrence of that time, else <b>false</b>
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> local date/time, or invalid date/time if error
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> toUtc(), convert()
</dd></dl>
</p></div></div><a class="anchor" name="transitionIndex"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">int, int secondIndex, bool validTime transitionIndex</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>dt</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Find the index to the last daylight savings time transition at or before
a given UTC or local time. The return value is the index into the transition
list returned by transitions().
</p>
<p>
Because of daylight savings time shifts, a local time may occur twice or
may not occur at all. In the former case, the transitions at or before
both occurrences of <b>dt</b> may optionally be calculated and returned in
<b>secondIndex.</b> The latter case may optionally be detected by use of
<b>validTime.</b>
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>dt</em> </td><td> date/time. <b>dt.timeSpec()</b> may be set to Qt.UTC or Qt.LocalTime.
<tr><td></td><td valign="top"><em>secondIndex</em> </td><td> if non-null, and the <b>dt</b> occurs twice, receives the
index to the transition for the second occurrence. Otherwise,
it is set the same as the return value.
<tr><td></td><td valign="top"><em>validTime</em> </td><td> if non-null, is set to false if <b>dt</b> does not occur, or
to true otherwise
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> index into the time zone transition list, or -1 either if <b>dt</b> is
either outside the defined range of the transition data or if <b>dt</b>
does not occur
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> transition(), transitions(), hasTransitions()
</dd></dl>
</p></div></div><a class="anchor" name="transitionTimes"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">[<a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a>] transitionTimes</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KTimeZone.Phase.html">KTimeZone.Phase</a> </td>
<td class="paramname"><em>phase</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>start=QDateTime()</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>end=QDateTime()</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Return the times of all daylight saving transitions to a given time zone
phase, in time order. If desired, the times returned may be restricted to
a specified time range.
</p>
<p>
Note that some time zone data sources (such as system time zones accessed
via the system libraries) may not allow a list of daylight saving time
changes to be compiled easily. In such cases, this method will return an
empty list.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>phase</em> </td><td> time zone phase
<tr><td></td><td valign="top"><em>start</em> </td><td> start UTC date/time, or invalid date/time to return all transitions
up to <b>end.</b> <b>start.timeSpec()</b> must be Qt.UTC, else
<b>start</b> will be considered invalid.
<tr><td></td><td valign="top"><em>end</em> </td><td> end UTC date/time, or invalid date/time for no end. <b>end.timeSpec()</b>
must be Qt.UTC, else <b>end</b> will be considered invalid.
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> ordered list of transition times
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> hasTransitions(), transition(), transitions()
</dd></dl>
</p></div></div><a class="anchor" name="transitions"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">[<a href="../kdecore/KTimeZone.Transition.html">KTimeZone.Transition</a>] transitions</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>start=QDateTime()</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdatetime.html">QDateTime</a> </td>
<td class="paramname"><em>end=QDateTime()</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Return all daylight saving transitions, in time order. If desired, the
transitions returned may be restricted to a specified time range.
</p>
<p>
Note that some time zone data sources (such as system time zones accessed
via the system libraries) may not allow a list of daylight saving time
changes to be compiled easily. In such cases, this method will return an
empty list.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>start</em> </td><td> start UTC date/time, or invalid date/time to return all transitions
up to <b>end.</b> <b>start.timeSpec()</b> must be Qt.UTC, else
<b>start</b> will be considered invalid.
<tr><td></td><td valign="top"><em>end</em> </td><td> end UTC date/time, or invalid date/time for no end. <b>end.timeSpec()</b>
must be Qt.UTC, else <b>end</b> will be considered invalid.
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> list of transitions, in time order
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> hasTransitions(), transition(), transitionTimes()
</dd></dl>
</p></div></div><a class="anchor" name="type"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qbytearray.html">QByteArray</a> type</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the class name of the data represented by this instance.
If a derived class object has been assigned to this instance, this
method will return the name of that class.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> "KTimeZone" or the class name of a derived class
</dd></dl>
</p></div></div><a class="anchor" name="updateBase"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool updateBase</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../kdecore/KTimeZone.html">KTimeZone</a> </td>
<td class="paramname"><em>other</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Update the definition of the time zone to be identical to another
KTimeZone instance. A prerequisite is that the two instances must
have the same name.
</p>
<p>
The main purpose of this method is to allow updates of the time zone
definition by derived classes without invalidating pointers to the
instance (particularly pointers held by KDateTime objects). Note
that the KTimeZoneData object and KTimeZoneSource pointer are not
updated: the caller class should do this itself by calling setData().
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>other</em> </td><td> time zone whose definition is to be used
</td></tr> </table></dl>
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if definition was updated (i.e. names are the same)
</dd></dl> </p>
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd> setData()
</dd></dl>
</p></div></div><a class="anchor" name="utc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../kdecore/KTimeZone.html">KTimeZone</a> utc</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns a standard UTC time zone, with name "UTC".
</p>
<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd> The KTimeZone returned by this method does not belong to any
KTimeZones collection. Any KTimeZones instance may contain its own UTC
KTimeZone defined by its time zone source data, but that will be a
different instance than this KTimeZone.
</dd></dl> </p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> UTC time zone
</dd></dl>
</p></div></div><a class="anchor" name="utcOffsets"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">[int] utcOffsets</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Returns the complete list of UTC offsets used by the time zone. This may
include historical ones which are no longer in use or have been
superseded.
</p>
<p>
A UTC offset is the number of seconds which you must add to UTC to get
local time in this time zone.
</p>
<p>
If due to the nature of the source data for the time zone, compiling a
complete list would require significant processing, an empty list is
returned instead.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> sorted list of UTC offsets, or empty list if not readily available.
</dd></dl>
</p></div></div><hr><h2>Attribute Documentation</h2><a class="anchor" name="varInvalidOffset"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">int InvalidOffset</td>
</tr>
</table>
</div>
<div class="memdoc"></div></div><p><a class="anchor" name="varInvalidTime_t"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">time_t InvalidTime_t</td>
</tr>
</table>
</div>
<div class="memdoc"></div></div><p><a class="anchor" name="varUNKNOWN"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr><td class="memname">float UNKNOWN</td>
</tr>
</table>
</div>
<div class="memdoc"></div></div><p>
</div>
</div>
</div>
<div id="left">
<div class="menu_box">
<div class="nav_list">
<ul>
<li><a href="../allclasses.html">Full Index</a></li>
</ul>
</div>
<a name="cp-menu" /><div class="menutitle"><div>
<h2 id="cp-menu-project">Modules</h2>
</div></div>
<div class="nav_list">
<ul><li><a href="../akonadi/index.html">akonadi</a></li>
<li><a href="../dnssd/index.html">dnssd</a></li>
<li><a href="../kdecore/index.html">kdecore</a></li>
<li><a href="../kdeui/index.html">kdeui</a></li>
<li><a href="../khtml/index.html">khtml</a></li>
<li><a href="../kio/index.html">kio</a></li>
<li><a href="../knewstuff/index.html">knewstuff</a></li>
<li><a href="../kparts/index.html">kparts</a></li>
<li><a href="../kutils/index.html">kutils</a></li>
<li><a href="../nepomuk/index.html">nepomuk</a></li>
<li><a href="../phonon/index.html">phonon</a></li>
<li><a href="../plasma/index.html">plasma</a></li>
<li><a href="../polkitqt/index.html">polkitqt</a></li>
<li><a href="../solid/index.html">solid</a></li>
<li><a href="../soprano/index.html">soprano</a></li>
</ul></div></div>
</div>
</div>
<div class="clearer"/>
</div>
<div id="end_body"></div>
</div>
<div id="footer"><div id="footer_text">
This documentation is maintained by <a href="mailto:simon@simonzone.com">Simon Edwards</a>.<br />
KDE<sup>®</sup> and <a href="../images/kde_gear_black.png">the K Desktop Environment<sup>®</sup> logo</a> are registered trademarks of <a href="http://ev.kde.org/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
<a href="http://www.kde.org/contact/impressum.php">Legal</a>
</div></div>
</body>
</html>
distrib
>
Mandriva
>
current
>
i586
>
media
>
main-updates
>
by-pkgid
>
b77dda48f87d4eda8cc559e40c49a652
>
files
>
338
