1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
6
<title>KLocalizedDate</title>
7
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8
<meta http-equiv="Content-Style-Type" content="text/css" />
9
<link rel="stylesheet" type="text/css" href="../common/doxygen.css" />
10
<link rel="stylesheet" media="screen" type="text/css" title="KDE Colors" href="../common/kde.css" />
18
<img alt ="" src="../common/top-kde.jpg"/>
19
KDE 4.6 PyKDE API Reference
23
<div id="header_bottom">
26
<li>KDE's Python API</li>
32
<li><a href="../modules.html">Overview</a></li>
33
<li><a href="http://techbase.kde.org/Development/Languages/Python">PyKDE Home</a></li>
34
<li><a href="http://kde.org/family/">Sitemap</a></li>
35
<li><a href="http://kde.org/contact/">Contact Us</a></li>
41
<div id="body_wrapper">
46
<div class="clearer"> </div>
48
<h1>KLocalizedDate Class Reference</h1>
49
<code>from PyKDE4.kdecore import *</code>
54
<h2>Detailed Description</h2>
56
<p>A class representing a date localized using the local calendar system, language and formats
70
This class provides a simple and convenient way to localize dates
73
<b>Calendar System </b>
76
KDE supports the use of different calendar systems.
79
<b>Default and Custom Locale and Calendar System </b>
82
In most cases you will want to use the default Global Locale and Calendar
83
System, in which case you need only create a default KLocalizedDate. If
84
however you specifically need a different Calendar System or Locale settings
85
then you need to take some extra steps.
88
The simplest method is just changing the Calendar System while keeping the
89
current Locale settings. This is easily done using setCalendarSystem()
90
which will copy the current Locale being used and apply this to the new
91
Calendar System. Note this means any changes to the old locale settings,
92
either the Global Locale or a custom Locale (see below) will not apply
93
to that date instance.
96
You may however wish to use a custom Locale with the Calendar System.
97
For example, if you want your app to normally show dates using the Global
98
Locale and Calendar System, but wish to show an info box with the Islamic
99
date in Arabic language and format, then you need a custom Locale to do
103
<pre class="fragment">
104
KLocale *myLocale = new KLocale("myapp", "ar", "eg");
105
KCalendarSystem *myCalendar = KCalendarSystem.create(KLocale.IslamicCivilCalendar, myLocale);
106
KLocalizedDate myDate(QDate(2010,1,1), myCalendar);
110
In this case you are responsible for the memory management of the KLocale
111
and KCalendarSystem. This allows you to reuse this calendar across multiple
112
date instances without it being deleted under you. It also allows you to
113
change any setting in the Locale and have it apply across all those date
114
instances. <dl class="warning" compact><dt><b>Warning:</b></dt><dd> Don't try changing the Calendar System via your Locale
115
instance, your KCalendarSystem instance will be deleted and all the dates
119
<dl class="see" compact><dt><b>See also:</b></dt><dd>
122
<b>Date Formatting </b>
125
When you display dates or date components to users in a GUI, they will
126
expect them to be displayed in their language and digit set following their
127
local date formatting conventions. Directly displaying values returned by
128
the normal date component methods such as day() will not conform to these
129
expectations, so you need to use different methods to obtain the localized
130
string form of the date or component.
133
You can either format the entire date, or just a single component of the
134
date such as the month or day.
137
When formatting a full date, it is preferred to use one of the standard date
138
formats defined in the Locale, although you can provide your own format in
139
either the KDE, POSIX, or UNICODE standards.
142
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate() formatDate()
148
Basic concepts on date parsing, then full details on KLocale.ReadDateFlags
149
formats, definging your own date format strings, and setting how strictly
150
the format is appplied.
153
You can choose how strictly a date format is applied in parsing. Currently
154
only liberal Parsing is supported.
157
The KLocale.LiberalParsing mode applies the following rules:
160
1) You must supply a format and string containing at least one of the following combinations to
162
<li> a month and day of month </li>
163
<li> a day of year </li>
164
<li> a ISO week number and day of week </li>
167
2) If a year number is not supplied then the current year will be assumed.
170
3) All date components must be separated by a non-numeric character.
173
4) The format is not applied strictly to the input string:
174
<li> extra whitespace is ignored </li>
175
<li> leading 0's on numbers are ignored </li>
176
<li> capitalisation of literals is ignored </li>
179
<dl class="see" compact><dt><b>See also:</b></dt><dd> readDate()
185
A full set of date maths functions are provided which operate in a consistent
186
manner, i.e. you can safely round-trip.
188
<table border="0" cellpadding="0" cellspacing="0"><tr><td colspan="2"><br><h2>Methods</h2></td></tr>
189
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KLocalizedDate">__init__</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> date=QDate(), <a href="../kdecore/KCalendarSystem.html">KCalendarSystem</a> calendar=0)</td></tr>
190
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KLocalizedDate">__init__</a> (self, int year, int month, int day, <a href="../kdecore/KCalendarSystem.html">KCalendarSystem</a> calendar=0)</td></tr>
191
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#KLocalizedDate">__init__</a> (self, <a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> rhs)</td></tr>
192
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#addDays">addDays</a> (self, int days)</td></tr>
193
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#addDaysTo">addDaysTo</a> (self, int days)</td></tr>
194
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#addMonths">addMonths</a> (self, int months)</td></tr>
195
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#addMonthsTo">addMonthsTo</a> (self, int months)</td></tr>
196
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#addYears">addYears</a> (self, int years)</td></tr>
197
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#addYearsTo">addYearsTo</a> (self, int years)</td></tr>
198
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KCalendarSystem.html">KCalendarSystem</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#calendar">calendar</a> (self)</td></tr>
199
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocale.html#CalendarSystem">KLocale.CalendarSystem</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#calendarSystem">calendarSystem</a> (self)</td></tr>
200
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#date">date</a> (self)</td></tr>
201
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#dateDifference">dateDifference</a> (self, <a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> toDate, int yearsDiff, int monthsDiff, int daysDiff, int direction)</td></tr>
202
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#dateDifference">dateDifference</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> toDate, int yearsDiff, int monthsDiff, int daysDiff, int direction)</td></tr>
203
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#day">day</a> (self)</td></tr>
204
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#dayOfWeek">dayOfWeek</a> (self)</td></tr>
205
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#dayOfYear">dayOfYear</a> (self)</td></tr>
206
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#daysDifference">daysDifference</a> (self, <a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> toDate)</td></tr>
207
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#daysDifference">daysDifference</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> toDate)</td></tr>
208
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#daysInMonth">daysInMonth</a> (self)</td></tr>
209
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#daysInWeek">daysInWeek</a> (self)</td></tr>
210
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#daysInYear">daysInYear</a> (self)</td></tr>
211
<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="#eraName">eraName</a> (self)</td></tr>
212
<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="#eraYear">eraYear</a> (self)</td></tr>
213
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#firstDayOfMonth">firstDayOfMonth</a> (self)</td></tr>
214
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#firstDayOfYear">firstDayOfYear</a> (self)</td></tr>
215
<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="#formatDate">formatDate</a> (self, <a href="../kdecore/KLocale.html#DateFormat">KLocale.DateFormat</a> dateFormat=KLocale.LongDate)</td></tr>
216
<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="#formatDate">formatDate</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> formatString, <a href="../kdecore/KLocale.html#DateTimeFormatStandard">KLocale.DateTimeFormatStandard</a> formatStandard=KLocale.KdeFormat)</td></tr>
217
<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="#formatDate">formatDate</a> (self, <a href="../kdecore/KLocale.html#DateTimeComponent">KLocale.DateTimeComponent</a> component, <a href="../kdecore/KLocale.html#DateTimeComponentFormat">KLocale.DateTimeComponentFormat</a> format=KLocale.DefaultComponentFormat, <a href="../kdecore/KLocale.html#WeekNumberSystem">KLocale.WeekNumberSystem</a> weekNumberSystem=KLocale.DefaultWeekNumber)</td></tr>
218
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#getDate">getDate</a> (self, int year, int month, int day)</td></tr>
219
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isLeapYear">isLeapYear</a> (self)</td></tr>
220
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isNull">isNull</a> (self)</td></tr>
221
<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>
222
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#lastDayOfMonth">lastDayOfMonth</a> (self)</td></tr>
223
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#lastDayOfYear">lastDayOfYear</a> (self)</td></tr>
224
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#month">month</a> (self)</td></tr>
225
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#monthsDifference">monthsDifference</a> (self, <a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> toDate)</td></tr>
226
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#monthsDifference">monthsDifference</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> toDate)</td></tr>
227
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#monthsInYear">monthsInYear</a> (self)</td></tr>
228
<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/KLocalizedDate.html">KLocalizedDate</a> other)</td></tr>
229
<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="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> other)</td></tr>
230
<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/KLocalizedDate.html">KLocalizedDate</a> other)</td></tr>
231
<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="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> other)</td></tr>
232
<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/KLocalizedDate.html">KLocalizedDate</a> other)</td></tr>
233
<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="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> other)</td></tr>
234
<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/KLocalizedDate.html">KLocalizedDate</a> other)</td></tr>
235
<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="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> other)</td></tr>
236
<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/KLocalizedDate.html">KLocalizedDate</a> other)</td></tr>
237
<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="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> other)</td></tr>
238
<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/KLocalizedDate.html">KLocalizedDate</a> other)</td></tr>
239
<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="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> other)</td></tr>
240
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#setCalendarSystem">setCalendarSystem</a> (self, <a href="../kdecore/KLocale.html#CalendarSystem">KLocale.CalendarSystem</a> calendarSystem)</td></tr>
241
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#setCurrentDate">setCurrentDate</a> (self)</td></tr>
242
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#setDate">setDate</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> date)</td></tr>
243
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#setDate">setDate</a> (self, int year, int month, int day)</td></tr>
244
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#setDate">setDate</a> (self, int year, int dayOfYear)</td></tr>
245
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#setDate">setDate</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> eraName, int yearInEra, int month, int day)</td></tr>
246
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#setDate">setDate</a> (self, <a href="../kdecore/KLocale.html#WeekNumberSystem">KLocale.WeekNumberSystem</a> weekNumberSystem, int year, int weekOfYear, int dayOfWeek)</td></tr>
247
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#toJulianDay">toJulianDay</a> (self)</td></tr>
248
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#week">week</a> (self, int yearNum=0)</td></tr>
249
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#week">week</a> (self, <a href="../kdecore/KLocale.html#WeekNumberSystem">KLocale.WeekNumberSystem</a> weekNumberSystem, int yearNum=0)</td></tr>
250
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#weeksInYear">weeksInYear</a> (self)</td></tr>
251
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#weeksInYear">weeksInYear</a> (self, <a href="../kdecore/KLocale.html#WeekNumberSystem">KLocale.WeekNumberSystem</a> weekNumberSystem)</td></tr>
252
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#year">year</a> (self)</td></tr>
253
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#yearInEra">yearInEra</a> (self)</td></tr>
254
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#yearsDifference">yearsDifference</a> (self, <a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> toDate)</td></tr>
255
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#yearsDifference">yearsDifference</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> toDate)</td></tr>
256
<tr><td colspan="2"><br><h2>Static Methods</h2></td></tr>
257
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#currentDate">currentDate</a> ()</td></tr>
258
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#fromDate">fromDate</a> (<a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> date)</td></tr>
259
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#fromJulianDay">fromJulianDay</a> (int jd)</td></tr>
260
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#readDate">readDate</a> (<a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> dateString, <a href="../kdecore/KLocale.html#DateTimeParseMode">KLocale.DateTimeParseMode</a> parseMode=KLocale.LiberalParsing, <a href="../kdecore/KCalendarSystem.html">KCalendarSystem</a> calendar=0)</td></tr>
261
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#readDate">readDate</a> (<a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> dateString, <a href="../kdecore/KLocale.html#ReadDateFlags">KLocale.ReadDateFlags</a> formatFlags, <a href="../kdecore/KLocale.html#DateTimeParseMode">KLocale.DateTimeParseMode</a> parseMode=KLocale.LiberalParsing, <a href="../kdecore/KCalendarSystem.html">KCalendarSystem</a> calendar=0)</td></tr>
262
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#readDate">readDate</a> (<a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> dateString, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> dateFormat, <a href="../kdecore/KLocale.html#DateTimeParseMode">KLocale.DateTimeParseMode</a> parseMode=KLocale.LiberalParsing, <a href="../kdecore/KLocale.html#DateTimeFormatStandard">KLocale.DateTimeFormatStandard</a> formatStandard=KLocale.KdeFormat, <a href="../kdecore/KCalendarSystem.html">KCalendarSystem</a> calendar=0)</td></tr>
264
<hr><h2>Method Documentation</h2><a class="anchor" name="KLocalizedDate"></a>
265
<div class="memitem">
266
<div class="memproto">
267
<table class="memname"><tr>
268
<td class="memname">__init__</td>
270
<td class="paramtype"> <em>self</em>, </td>
271
<td class="paramname"></td>
273
<td class="memname"></td>
275
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
276
<td class="paramname"><em>date=QDate()</em>, </td>
279
<td class="memname"></td>
281
<td class="paramtype"><a href="../kdecore/KCalendarSystem.html">KCalendarSystem</a> </td>
282
<td class="paramname"><em>calendar=0</em></td>
289
<td width="100%"> </td>
292
<div class="memdoc"><p>Constructs a localized date with the given date.
295
By default, uses the global Calendar System and Locale.
298
If you pass in a custom Calendar System then you retain ownership of it
299
and are responsible for deleting it. This allows you to reuse the same
300
custom Calendar System for many localized date instances.
303
See custom for more details on using custom Calendar Systems.
306
</p><dl compact><dt><b>Parameters:</b></dt><dd>
307
<table border="0" cellspacing="2" cellpadding="0">
308
<tr><td></td><td valign="top"><em>date</em> </td><td> the QDate to set the KLocalizedDate to, defaults to invalid date
310
<tr><td></td><td valign="top"><em>locale</em> </td><td> the locale to use for date formats, defaults to the global
314
</p></div></div><a class="anchor" name="KLocalizedDate"></a>
315
<div class="memitem">
316
<div class="memproto">
317
<table class="memname"><tr>
318
<td class="memname">__init__</td>
320
<td class="paramtype"> <em>self</em>, </td>
321
<td class="paramname"></td>
323
<td class="memname"></td>
325
<td class="paramtype">int </td>
326
<td class="paramname"><em>year</em>, </td>
329
<td class="memname"></td>
331
<td class="paramtype">int </td>
332
<td class="paramname"><em>month</em>, </td>
335
<td class="memname"></td>
337
<td class="paramtype">int </td>
338
<td class="paramname"><em>day</em>, </td>
341
<td class="memname"></td>
343
<td class="paramtype"><a href="../kdecore/KCalendarSystem.html">KCalendarSystem</a> </td>
344
<td class="paramname"><em>calendar=0</em></td>
351
<td width="100%"> </td>
354
<div class="memdoc"><p>Constructs a localized date with the given year, month and day.
357
By default, uses the global Calendar System and Locale.
360
If you pass in a custom Calendar System then you retain ownership of it
361
and are responsible for deleting it. This allows you to reuse the same
362
custom Calendar System for many localized date instances.
365
See custom for more details on using custom Calendar Systems.
368
</p><dl compact><dt><b>Parameters:</b></dt><dd>
369
<table border="0" cellspacing="2" cellpadding="0">
370
<tr><td></td><td valign="top"><em>year</em> </td><td> the year to set the KLocalizedDate to
372
<tr><td></td><td valign="top"><em>month</em> </td><td> the month to set the KLocalizedDate to
374
<tr><td></td><td valign="top"><em>day</em> </td><td> the day to set the KLocalizedDate to
378
</p></div></div><a class="anchor" name="KLocalizedDate"></a>
379
<div class="memitem">
380
<div class="memproto">
381
<table class="memname"><tr>
382
<td class="memname">__init__</td>
384
<td class="paramtype"> <em>self</em>, </td>
385
<td class="paramname"></td>
387
<td class="memname"></td>
389
<td class="paramtype"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td>
390
<td class="paramname"><em>rhs</em></td>
397
<td width="100%"> </td>
400
<div class="memdoc"><p>Copy constructor
403
</p><dl compact><dt><b>Parameters:</b></dt><dd>
404
<table border="0" cellspacing="2" cellpadding="0">
405
<tr><td></td><td valign="top"><em>rhs</em> </td><td> the date to copy
409
</p></div></div><a class="anchor" name="addDays"></a>
410
<div class="memitem">
411
<div class="memproto">
412
<table class="memname"><tr>
413
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> addDays</td>
415
<td class="paramtype"> <em>self</em>, </td>
416
<td class="paramname"></td>
418
<td class="memname"></td>
420
<td class="paramtype">int </td>
421
<td class="paramname"><em>days</em></td>
428
<td width="100%"> </td>
431
<div class="memdoc"><p>Returns a KLocalizedDate containing a date <b>days</b> days later.
434
<dl class="see" compact><dt><b>See also:</b></dt><dd> addDaysTo()
435
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> addYears() addMonths()
436
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dateDifference() yearsDifference()
437
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
438
<table border="0" cellspacing="2" cellpadding="0">
439
<tr><td></td><td valign="top"><em>days</em> </td><td> number of days to add
440
</td></tr> </table></dl>
441
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The new date, null date if any errors
443
</p></div></div><a class="anchor" name="addDaysTo"></a>
444
<div class="memitem">
445
<div class="memproto">
446
<table class="memname"><tr>
447
<td class="memname">bool addDaysTo</td>
449
<td class="paramtype"> <em>self</em>, </td>
450
<td class="paramname"></td>
452
<td class="memname"></td>
454
<td class="paramtype">int </td>
455
<td class="paramname"><em>days</em></td>
462
<td width="100%"> </td>
465
<div class="memdoc"><p>Add days onto this date instance.
468
If the result of the addition is invalid in the current Calendar System
469
then the date will become invalid.
472
<dl class="see" compact><dt><b>See also:</b></dt><dd> addDays()
473
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> addYearsTo(), addMonthsTo()
474
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dateDifference() yearsDifference()
475
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
476
<table border="0" cellspacing="2" cellpadding="0">
477
<tr><td></td><td valign="top"><em>days</em> </td><td> The number of days to add
478
</td></tr> </table></dl>
479
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> if the resulting date is valid
481
</p></div></div><a class="anchor" name="addMonths"></a>
482
<div class="memitem">
483
<div class="memproto">
484
<table class="memname"><tr>
485
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> addMonths</td>
487
<td class="paramtype"> <em>self</em>, </td>
488
<td class="paramname"></td>
490
<td class="memname"></td>
492
<td class="paramtype">int </td>
493
<td class="paramname"><em>months</em></td>
500
<td width="100%"> </td>
503
<div class="memdoc"><p>Returns a KLocalizedDate containing a date <b>months</b> months later.
506
<dl class="see" compact><dt><b>See also:</b></dt><dd> addMonthsTo()
507
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> addYears() addDays()
508
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dateDifference() yearsDifference()
509
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
510
<table border="0" cellspacing="2" cellpadding="0">
511
<tr><td></td><td valign="top"><em>months</em> </td><td> number of months to add
512
</td></tr> </table></dl>
513
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The new date, null date if any errors
515
</p></div></div><a class="anchor" name="addMonthsTo"></a>
516
<div class="memitem">
517
<div class="memproto">
518
<table class="memname"><tr>
519
<td class="memname">bool addMonthsTo</td>
521
<td class="paramtype"> <em>self</em>, </td>
522
<td class="paramname"></td>
524
<td class="memname"></td>
526
<td class="paramtype">int </td>
527
<td class="paramname"><em>months</em></td>
534
<td width="100%"> </td>
537
<div class="memdoc"><p>Add months onto this date instance.
540
If the result of the addition is invalid in the current Calendar System
541
then the date will become invalid.
544
<dl class="see" compact><dt><b>See also:</b></dt><dd> addMonths()
545
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> addYearsTo() addDaysTo()
546
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dateDifference() yearsDifference()
547
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
548
<table border="0" cellspacing="2" cellpadding="0">
549
<tr><td></td><td valign="top"><em>months</em> </td><td> The number of months to add
550
</td></tr> </table></dl>
551
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> if the resulting date is valid
553
</p></div></div><a class="anchor" name="addYears"></a>
554
<div class="memitem">
555
<div class="memproto">
556
<table class="memname"><tr>
557
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> addYears</td>
559
<td class="paramtype"> <em>self</em>, </td>
560
<td class="paramname"></td>
562
<td class="memname"></td>
564
<td class="paramtype">int </td>
565
<td class="paramname"><em>years</em></td>
572
<td width="100%"> </td>
575
<div class="memdoc"><p>Returns a KLocalizedDate containing a date <b>years</b> years later.
578
<dl class="see" compact><dt><b>See also:</b></dt><dd> addYearsTo()
579
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> addMonths() addDays()
580
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dateDifference() yearsDifference()
581
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
582
<table border="0" cellspacing="2" cellpadding="0">
583
<tr><td></td><td valign="top"><em>years</em> </td><td> The number of years to add
584
</td></tr> </table></dl>
585
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The new date, null date if any errors
587
</p></div></div><a class="anchor" name="addYearsTo"></a>
588
<div class="memitem">
589
<div class="memproto">
590
<table class="memname"><tr>
591
<td class="memname">bool addYearsTo</td>
593
<td class="paramtype"> <em>self</em>, </td>
594
<td class="paramname"></td>
596
<td class="memname"></td>
598
<td class="paramtype">int </td>
599
<td class="paramname"><em>years</em></td>
606
<td width="100%"> </td>
609
<div class="memdoc"><p>Add years onto this date instance.
612
If the result of the addition is invalid in the current Calendar System
613
then the date will become invalid.
616
<dl class="see" compact><dt><b>See also:</b></dt><dd> addYears()
617
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> addMonthsTo() addDaysTo()
618
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dateDifference() yearsDifference()
619
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
620
<table border="0" cellspacing="2" cellpadding="0">
621
<tr><td></td><td valign="top"><em>years</em> </td><td> The number of years to add
622
</td></tr> </table></dl>
623
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> if the resulting date is valid
625
</p></div></div><a class="anchor" name="calendar"></a>
626
<div class="memitem">
627
<div class="memproto">
628
<table class="memname"><tr>
629
<td class="memname"><a href="../kdecore/KCalendarSystem.html">KCalendarSystem</a> calendar</td>
631
<td class="paramtype"> </td>
632
<td class="paramname"><em>self</em> )</td>
633
<td width="100%"> </td>
637
<div class="memdoc"><p>Returns a pointer to the Calendar System object used by this date instance.
640
Usually this will be the Global Calendar System, but this may have been
644
Normally you will not need to access this object unless the KLocalizedDate
645
API does not provide the methods you require.
648
<dl class="see" compact><dt><b>See also:</b></dt><dd> KCalendarSystem
649
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> calendarSystem
650
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> setCalendarSystem
651
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the current calendar system instance
653
</p></div></div><a class="anchor" name="calendarSystem"></a>
654
<div class="memitem">
655
<div class="memproto">
656
<table class="memname"><tr>
657
<td class="memname"><a href="../kdecore/KLocale.html#CalendarSystem">KLocale.CalendarSystem</a> calendarSystem</td>
659
<td class="paramtype"> </td>
660
<td class="paramname"><em>self</em> )</td>
661
<td width="100%"> </td>
665
<div class="memdoc"><p>Returns the Calendar System used by this localized date instance
668
<dl class="see" compact><dt><b>See also:</b></dt><dd> KLocale.CalendarSystem
669
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> setCalendarSystem()
670
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the Calendar System currently used
672
</p></div></div><a class="anchor" name="date"></a>
673
<div class="memitem">
674
<div class="memproto">
675
<table class="memname"><tr>
676
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> date</td>
678
<td class="paramtype"> </td>
679
<td class="paramname"><em>self</em> )</td>
680
<td width="100%"> </td>
684
<div class="memdoc"><p>Returns the currently set date as a QDate
687
<dl class="return" compact><dt><b>Returns:</b></dt><dd> the currently set date as a QDate
689
</p></div></div><a class="anchor" name="dateDifference"></a>
690
<div class="memitem">
691
<div class="memproto">
692
<table class="memname"><tr>
693
<td class="memname"> dateDifference</td>
695
<td class="paramtype"> <em>self</em>, </td>
696
<td class="paramname"></td>
698
<td class="memname"></td>
700
<td class="paramtype"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td>
701
<td class="paramname"><em>toDate</em>, </td>
704
<td class="memname"></td>
706
<td class="paramtype">int </td>
707
<td class="paramname"><em>yearsDiff</em>, </td>
710
<td class="memname"></td>
712
<td class="paramtype">int </td>
713
<td class="paramname"><em>monthsDiff</em>, </td>
716
<td class="memname"></td>
718
<td class="paramtype">int </td>
719
<td class="paramname"><em>daysDiff</em>, </td>
722
<td class="memname"></td>
724
<td class="paramtype">int </td>
725
<td class="paramname"><em>direction</em></td>
732
<td width="100%"> </td>
735
<div class="memdoc"><p>Returns the difference between this and another date in years, months and days
736
in the current Calendar System.
739
The difference is always calculated from the earlier date to the later
740
date in year, month and day order, with the <b>direction</b> parameter
741
indicating which direction the difference is applied from this date.
742
In other words, this difference can be added onto the earlier date in
743
year, month, day order to reach the later date.
746
For example, the difference between 2010-06-10 and 2012-09-5 is 2 years,
747
2 months and 26 days. Note that the difference between two last days of
748
the month is always 1 month, e.g. 2010-01-31 to 2010-02-28 is 1 month
752
<dl class="see" compact><dt><b>See also:</b></dt><dd> addYears() addMonths() addDays()
753
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> yearsDifference() monthsDifference() daysDifference()
754
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
755
<table border="0" cellspacing="2" cellpadding="0">
756
<tr><td></td><td valign="top"><em>toDate</em> </td><td> The date to end at
758
<tr><td></td><td valign="top"><em>yearsDiff</em> </td><td> Returns number of years difference
760
<tr><td></td><td valign="top"><em>monthsDiff</em> </td><td> Returns number of months difference
762
<tr><td></td><td valign="top"><em>daysDiff</em> </td><td> Returns number of days difference
764
<tr><td></td><td valign="top"><em>direction</em> </td><td> Returns direction of difference, 1 if this Date <= toDate, -1 otherwise
768
</p></div></div><a class="anchor" name="dateDifference"></a>
769
<div class="memitem">
770
<div class="memproto">
771
<table class="memname"><tr>
772
<td class="memname"> dateDifference</td>
774
<td class="paramtype"> <em>self</em>, </td>
775
<td class="paramname"></td>
777
<td class="memname"></td>
779
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
780
<td class="paramname"><em>toDate</em>, </td>
783
<td class="memname"></td>
785
<td class="paramtype">int </td>
786
<td class="paramname"><em>yearsDiff</em>, </td>
789
<td class="memname"></td>
791
<td class="paramtype">int </td>
792
<td class="paramname"><em>monthsDiff</em>, </td>
795
<td class="memname"></td>
797
<td class="paramtype">int </td>
798
<td class="paramname"><em>daysDiff</em>, </td>
801
<td class="memname"></td>
803
<td class="paramtype">int </td>
804
<td class="paramname"><em>direction</em></td>
811
<td width="100%"> </td>
814
<div class="memdoc"><p>Returns the difference between this and another date in years, months and days
815
in the current Calendar System.
818
The difference is always calculated from the earlier date to the later
819
date in year, month and day order, with the <b>direction</b> parameter
820
indicating which direction the difference is applied from this date.
821
In other words, this difference can be added onto the earlier date in
822
year, month, day order to reach the later date.
825
For example, the difference between 2010-06-10 and 2012-09-5 is 2 years,
826
2 months and 26 days. Note that the difference between two last days of
827
the month is always 1 month, e.g. 2010-01-31 to 2010-02-28 is 1 month
831
<dl class="see" compact><dt><b>See also:</b></dt><dd> addYears() addMonths() addDays()
832
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> yearsDifference() monthsDifference() daysDifference()
833
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
834
<table border="0" cellspacing="2" cellpadding="0">
835
<tr><td></td><td valign="top"><em>toDate</em> </td><td> The date to end at
837
<tr><td></td><td valign="top"><em>yearsDiff</em> </td><td> Returns number of years difference
839
<tr><td></td><td valign="top"><em>monthsDiff</em> </td><td> Returns number of months difference
841
<tr><td></td><td valign="top"><em>daysDiff</em> </td><td> Returns number of days difference
843
<tr><td></td><td valign="top"><em>direction</em> </td><td> Returns direction of difference, 1 if this Date <= toDate, -1 otherwise
847
</p></div></div><a class="anchor" name="day"></a>
848
<div class="memitem">
849
<div class="memproto">
850
<table class="memname"><tr>
851
<td class="memname">int day</td>
853
<td class="paramtype"> </td>
854
<td class="paramname"><em>self</em> )</td>
855
<td width="100%"> </td>
859
<div class="memdoc"><p>Returns the day portion of the date in the current calendar system
862
See formatting for why you should never display this value.
865
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
866
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the localized day number, 0 if date is invalid
868
</p></div></div><a class="anchor" name="dayOfWeek"></a>
869
<div class="memitem">
870
<div class="memproto">
871
<table class="memname"><tr>
872
<td class="memname">int dayOfWeek</td>
874
<td class="paramtype"> </td>
875
<td class="paramname"><em>self</em> )</td>
876
<td width="100%"> </td>
880
<div class="memdoc"><p>Returns the weekday number for the date
883
The weekdays are numbered 1..7 for Monday..Sunday.
886
This value is <b>not</b> affected by the value of KLocale.weekStartDay()
889
See formatting for why you should never display this value.
892
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
893
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> day of week number, -1 if date not valid
895
</p></div></div><a class="anchor" name="dayOfYear"></a>
896
<div class="memitem">
897
<div class="memproto">
898
<table class="memname"><tr>
899
<td class="memname">int dayOfYear</td>
901
<td class="paramtype"> </td>
902
<td class="paramname"><em>self</em> )</td>
903
<td width="100%"> </td>
907
<div class="memdoc"><p>Returns the day number of year for the date
910
The days are numbered 1..daysInYear()
913
See formatting for why you should never display this value.
916
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
917
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> day of year number, -1 if date not valid
919
</p></div></div><a class="anchor" name="daysDifference"></a>
920
<div class="memitem">
921
<div class="memproto">
922
<table class="memname"><tr>
923
<td class="memname">int daysDifference</td>
925
<td class="paramtype"> <em>self</em>, </td>
926
<td class="paramname"></td>
928
<td class="memname"></td>
930
<td class="paramtype"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td>
931
<td class="paramname"><em>toDate</em></td>
938
<td width="100%"> </td>
941
<div class="memdoc"><p>Returns the difference between this and another date in days
942
The returned value will be negative if <b>toDate</b> < this date.
945
<dl class="see" compact><dt><b>See also:</b></dt><dd> addDays()
946
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dateDifference() yearsDifference() monthsDifference()
947
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
948
<table border="0" cellspacing="2" cellpadding="0">
949
<tr><td></td><td valign="top"><em>toDate</em> </td><td> The date to end at
950
</td></tr> </table></dl>
951
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The number of days difference
953
</p></div></div><a class="anchor" name="daysDifference"></a>
954
<div class="memitem">
955
<div class="memproto">
956
<table class="memname"><tr>
957
<td class="memname">int daysDifference</td>
959
<td class="paramtype"> <em>self</em>, </td>
960
<td class="paramname"></td>
962
<td class="memname"></td>
964
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
965
<td class="paramname"><em>toDate</em></td>
972
<td width="100%"> </td>
975
<div class="memdoc"><p>Returns the difference between this and another date in days
976
The returned value will be negative if <b>toDate</b> < this date.
979
<dl class="see" compact><dt><b>See also:</b></dt><dd> addDays()
980
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dateDifference() yearsDifference() monthsDifference()
981
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
982
<table border="0" cellspacing="2" cellpadding="0">
983
<tr><td></td><td valign="top"><em>toDate</em> </td><td> The date to end at
984
</td></tr> </table></dl>
985
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The number of days difference
987
</p></div></div><a class="anchor" name="daysInMonth"></a>
988
<div class="memitem">
989
<div class="memproto">
990
<table class="memname"><tr>
991
<td class="memname">int daysInMonth</td>
993
<td class="paramtype"> </td>
994
<td class="paramname"><em>self</em> )</td>
995
<td width="100%"> </td>
999
<div class="memdoc"><p>Returns the number of days in the month.
1002
See formatting for why you should never display this value.
1005
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
1006
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> number of days in month, -1 if date invalid
1008
</p></div></div><a class="anchor" name="daysInWeek"></a>
1009
<div class="memitem">
1010
<div class="memproto">
1011
<table class="memname"><tr>
1012
<td class="memname">int daysInWeek</td>
1014
<td class="paramtype"> </td>
1015
<td class="paramname"><em>self</em> )</td>
1016
<td width="100%"> </td>
1020
<div class="memdoc"><p>Returns the number of days in the week.
1023
See formatting for why you should never display this value.
1026
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
1027
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> number of days in week, -1 if date invalid
1029
</p></div></div><a class="anchor" name="daysInYear"></a>
1030
<div class="memitem">
1031
<div class="memproto">
1032
<table class="memname"><tr>
1033
<td class="memname">int daysInYear</td>
1035
<td class="paramtype"> </td>
1036
<td class="paramname"><em>self</em> )</td>
1037
<td width="100%"> </td>
1041
<div class="memdoc"><p>Returns the number of days in the year.
1044
For example, in the Gregorian calendar most years have 365 days but Leap
1045
Years have 366 years. Other Calendar Systems have different length years.
1048
See formatting for why you should never display this value.
1051
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
1052
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> number of days in year, -1 if date invalid
1054
</p></div></div><a class="anchor" name="eraName"></a>
1055
<div class="memitem">
1056
<div class="memproto">
1057
<table class="memname"><tr>
1058
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> eraName</td>
1060
<td class="paramtype"> </td>
1061
<td class="paramname"><em>self</em> )</td>
1062
<td width="100%"> </td>
1066
<div class="memdoc"><p>Returns the Era Name portion of the date in the current calendar system,
1067
for example "AD" or "Anno Domini" for the Gregorian calendar and Christian Era.
1070
See formatting for more details on Date Formatting.
1073
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
1074
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
1075
<table border="0" cellspacing="2" cellpadding="0">
1076
<tr><td></td><td valign="top"><em>format</em> </td><td> format to return, either short or long
1077
</td></tr> </table></dl>
1078
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the localized era name, empty string if date is invalid
1080
</p></div></div><a class="anchor" name="eraYear"></a>
1081
<div class="memitem">
1082
<div class="memproto">
1083
<table class="memname"><tr>
1084
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> eraYear</td>
1086
<td class="paramtype"> </td>
1087
<td class="paramname"><em>self</em> )</td>
1088
<td width="100%"> </td>
1092
<div class="memdoc"><p>Returns the Era Year portion of the date in the current
1093
calendar system, for example "2000 AD" or "Heisei 22".
1096
See formatting for more details on Date Formatting.
1099
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
1100
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
1101
<table border="0" cellspacing="2" cellpadding="0">
1102
<tr><td></td><td valign="top"><em>format</em> </td><td> format to return, either short or long
1103
</td></tr> </table></dl>
1104
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the localized era year string, empty string if date is invalid
1106
</p></div></div><a class="anchor" name="firstDayOfMonth"></a>
1107
<div class="memitem">
1108
<div class="memproto">
1109
<table class="memname"><tr>
1110
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> firstDayOfMonth</td>
1112
<td class="paramtype"> </td>
1113
<td class="paramname"><em>self</em> )</td>
1114
<td width="100%"> </td>
1118
<div class="memdoc"><p>Returns a KLocalizedDate containing the first day of the currently set month
1121
<dl class="see" compact><dt><b>See also:</b></dt><dd> lastDayOfMonth()
1122
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The first day of the month
1124
</p></div></div><a class="anchor" name="firstDayOfYear"></a>
1125
<div class="memitem">
1126
<div class="memproto">
1127
<table class="memname"><tr>
1128
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> firstDayOfYear</td>
1130
<td class="paramtype"> </td>
1131
<td class="paramname"><em>self</em> )</td>
1132
<td width="100%"> </td>
1136
<div class="memdoc"><p>Returns a KLocalizedDate containing the first day of the currently set year
1139
<dl class="see" compact><dt><b>See also:</b></dt><dd> lastDayOfYear()
1140
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The first day of the year
1142
</p></div></div><a class="anchor" name="formatDate"></a>
1143
<div class="memitem">
1144
<div class="memproto">
1145
<table class="memname"><tr>
1146
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> formatDate</td>
1148
<td class="paramtype"> <em>self</em>, </td>
1149
<td class="paramname"></td>
1151
<td class="memname"></td>
1153
<td class="paramtype"><a href="../kdecore/KLocale.html#DateFormat">KLocale.DateFormat</a> </td>
1154
<td class="paramname"><em>dateFormat=KLocale.LongDate</em></td>
1161
<td width="100%"> </td>
1164
<div class="memdoc"><p>Returns a Date Component as a localized string in the requested format.
1167
See formatting for more details on Date Formatting.
1170
Each format size may vary depending on Locale and Calendar System but will
1171
generally match the format description. Some formats may not be directly
1172
valid but a sensible value will always be returned.
1175
For example for 2010-01-01 the KLocale.Month with en_US Locale and Gregorian calendar may return:
1176
KLocale.ShortNumber = "1"
1177
KLocale.LongNumber = "01"
1178
KLocale.NarrowName = "J"
1179
KLocale.ShortName = "Jan"
1180
KLocale.LongName = "January"
1183
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
1184
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
1185
<table border="0" cellspacing="2" cellpadding="0">
1186
<tr><td></td><td valign="top"><em>component</em> </td><td> The date component to return
1188
<tr><td></td><td valign="top"><em>format</em> </td><td> The format to return the <b>component</b> in
1190
<tr><td></td><td valign="top"><em>weekNumberSystem</em> </td><td> To override the default Week Number System to use
1191
</td></tr> </table></dl>
1192
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The string form of the date component
1194
</p></div></div><a class="anchor" name="formatDate"></a>
1195
<div class="memitem">
1196
<div class="memproto">
1197
<table class="memname"><tr>
1198
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> formatDate</td>
1200
<td class="paramtype"> <em>self</em>, </td>
1201
<td class="paramname"></td>
1203
<td class="memname"></td>
1205
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
1206
<td class="paramname"><em>formatString</em>, </td>
1209
<td class="memname"></td>
1211
<td class="paramtype"><a href="../kdecore/KLocale.html#DateTimeFormatStandard">KLocale.DateTimeFormatStandard</a> </td>
1212
<td class="paramname"><em>formatStandard=KLocale.KdeFormat</em></td>
1219
<td width="100%"> </td>
1222
<div class="memdoc"><p>Returns a Date Component as a localized string in the requested format.
1225
See formatting for more details on Date Formatting.
1228
Each format size may vary depending on Locale and Calendar System but will
1229
generally match the format description. Some formats may not be directly
1230
valid but a sensible value will always be returned.
1233
For example for 2010-01-01 the KLocale.Month with en_US Locale and Gregorian calendar may return:
1234
KLocale.ShortNumber = "1"
1235
KLocale.LongNumber = "01"
1236
KLocale.NarrowName = "J"
1237
KLocale.ShortName = "Jan"
1238
KLocale.LongName = "January"
1241
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
1242
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
1243
<table border="0" cellspacing="2" cellpadding="0">
1244
<tr><td></td><td valign="top"><em>component</em> </td><td> The date component to return
1246
<tr><td></td><td valign="top"><em>format</em> </td><td> The format to return the <b>component</b> in
1248
<tr><td></td><td valign="top"><em>weekNumberSystem</em> </td><td> To override the default Week Number System to use
1249
</td></tr> </table></dl>
1250
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The string form of the date component
1252
</p></div></div><a class="anchor" name="formatDate"></a>
1253
<div class="memitem">
1254
<div class="memproto">
1255
<table class="memname"><tr>
1256
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> formatDate</td>
1258
<td class="paramtype"> <em>self</em>, </td>
1259
<td class="paramname"></td>
1261
<td class="memname"></td>
1263
<td class="paramtype"><a href="../kdecore/KLocale.html#DateTimeComponent">KLocale.DateTimeComponent</a> </td>
1264
<td class="paramname"><em>component</em>, </td>
1267
<td class="memname"></td>
1269
<td class="paramtype"><a href="../kdecore/KLocale.html#DateTimeComponentFormat">KLocale.DateTimeComponentFormat</a> </td>
1270
<td class="paramname"><em>format=KLocale.DefaultComponentFormat</em>, </td>
1273
<td class="memname"></td>
1275
<td class="paramtype"><a href="../kdecore/KLocale.html#WeekNumberSystem">KLocale.WeekNumberSystem</a> </td>
1276
<td class="paramname"><em>weekNumberSystem=KLocale.DefaultWeekNumber</em></td>
1283
<td width="100%"> </td>
1286
<div class="memdoc"><p>Returns a Date Component as a localized string in the requested format.
1289
See formatting for more details on Date Formatting.
1292
Each format size may vary depending on Locale and Calendar System but will
1293
generally match the format description. Some formats may not be directly
1294
valid but a sensible value will always be returned.
1297
For example for 2010-01-01 the KLocale.Month with en_US Locale and Gregorian calendar may return:
1298
KLocale.ShortNumber = "1"
1299
KLocale.LongNumber = "01"
1300
KLocale.NarrowName = "J"
1301
KLocale.ShortName = "Jan"
1302
KLocale.LongName = "January"
1305
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
1306
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
1307
<table border="0" cellspacing="2" cellpadding="0">
1308
<tr><td></td><td valign="top"><em>component</em> </td><td> The date component to return
1310
<tr><td></td><td valign="top"><em>format</em> </td><td> The format to return the <b>component</b> in
1312
<tr><td></td><td valign="top"><em>weekNumberSystem</em> </td><td> To override the default Week Number System to use
1313
</td></tr> </table></dl>
1314
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The string form of the date component
1316
</p></div></div><a class="anchor" name="getDate"></a>
1317
<div class="memitem">
1318
<div class="memproto">
1319
<table class="memname"><tr>
1320
<td class="memname"> getDate</td>
1322
<td class="paramtype"> <em>self</em>, </td>
1323
<td class="paramname"></td>
1325
<td class="memname"></td>
1327
<td class="paramtype">int </td>
1328
<td class="paramname"><em>year</em>, </td>
1331
<td class="memname"></td>
1333
<td class="paramtype">int </td>
1334
<td class="paramname"><em>month</em>, </td>
1337
<td class="memname"></td>
1339
<td class="paramtype">int </td>
1340
<td class="paramname"><em>day</em></td>
1347
<td width="100%"> </td>
1350
<div class="memdoc"><p>Returns the year, month and day portion of the date in the current
1354
See formatting for why you should never display this value.
1357
<dl class="see" compact><dt><b>See also:</b></dt><dd> setDate()
1358
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
1359
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
1360
<table border="0" cellspacing="2" cellpadding="0">
1361
<tr><td></td><td valign="top"><em>year</em> </td><td> year number returned in this variable
1363
<tr><td></td><td valign="top"><em>month</em> </td><td> month number returned in this variable
1365
<tr><td></td><td valign="top"><em>day</em> </td><td> day of month returned in this variable
1369
</p></div></div><a class="anchor" name="isLeapYear"></a>
1370
<div class="memitem">
1371
<div class="memproto">
1372
<table class="memname"><tr>
1373
<td class="memname">bool isLeapYear</td>
1375
<td class="paramtype"> </td>
1376
<td class="paramname"><em>self</em> )</td>
1377
<td width="100%"> </td>
1381
<div class="memdoc"><p>Returns whether the currently set date falls in a Leap Year in the
1382
current Calendar System.
1385
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the date falls in a leap year
1387
</p></div></div><a class="anchor" name="isNull"></a>
1388
<div class="memitem">
1389
<div class="memproto">
1390
<table class="memname"><tr>
1391
<td class="memname">bool isNull</td>
1393
<td class="paramtype"> </td>
1394
<td class="paramname"><em>self</em> )</td>
1395
<td width="100%"> </td>
1399
<div class="memdoc"><p>Returns whether the date is null, i.e. invalid in any Calendar System.
1402
<dl class="see" compact><dt><b>See also:</b></dt><dd> isValid
1403
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the date is null, false otherwise
1405
</p></div></div><a class="anchor" name="isValid"></a>
1406
<div class="memitem">
1407
<div class="memproto">
1408
<table class="memname"><tr>
1409
<td class="memname">bool isValid</td>
1411
<td class="paramtype"> </td>
1412
<td class="paramname"><em>self</em> )</td>
1413
<td width="100%"> </td>
1417
<div class="memdoc"><p>Returns whether the date is valid in the current Calendar System.
1420
<dl class="see" compact><dt><b>See also:</b></dt><dd> isNull
1421
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the date is valid, false otherwise
1423
</p></div></div><a class="anchor" name="lastDayOfMonth"></a>
1424
<div class="memitem">
1425
<div class="memproto">
1426
<table class="memname"><tr>
1427
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> lastDayOfMonth</td>
1429
<td class="paramtype"> </td>
1430
<td class="paramname"><em>self</em> )</td>
1431
<td width="100%"> </td>
1435
<div class="memdoc"><p>Returns a KLocalizedDate containing the last day of the currently set month
1438
<dl class="see" compact><dt><b>See also:</b></dt><dd> firstDayOfMonth()
1439
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The last day of the month
1441
</p></div></div><a class="anchor" name="lastDayOfYear"></a>
1442
<div class="memitem">
1443
<div class="memproto">
1444
<table class="memname"><tr>
1445
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> lastDayOfYear</td>
1447
<td class="paramtype"> </td>
1448
<td class="paramname"><em>self</em> )</td>
1449
<td width="100%"> </td>
1453
<div class="memdoc"><p>Returns a KLocalizedDate containing the last day of the currently set year
1456
<dl class="see" compact><dt><b>See also:</b></dt><dd> firstDayOfYear()
1457
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The last day of the year
1459
</p></div></div><a class="anchor" name="month"></a>
1460
<div class="memitem">
1461
<div class="memproto">
1462
<table class="memname"><tr>
1463
<td class="memname">int month</td>
1465
<td class="paramtype"> </td>
1466
<td class="paramname"><em>self</em> )</td>
1467
<td width="100%"> </td>
1471
<div class="memdoc"><p>Returns the month portion of the date in the current calendar system
1474
See formatting for why you should never display this value.
1477
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
1478
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the localized month number, 0 if date is invalid
1480
</p></div></div><a class="anchor" name="monthsDifference"></a>
1481
<div class="memitem">
1482
<div class="memproto">
1483
<table class="memname"><tr>
1484
<td class="memname">int monthsDifference</td>
1486
<td class="paramtype"> <em>self</em>, </td>
1487
<td class="paramname"></td>
1489
<td class="memname"></td>
1491
<td class="paramtype"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td>
1492
<td class="paramname"><em>toDate</em></td>
1499
<td width="100%"> </td>
1502
<div class="memdoc"><p>Returns the difference between this and another date in completed calendar months
1503
in the current Calendar System.
1506
The returned value will be negative if <b>toDate</b> < this date.
1509
For example, the difference between 2010-06-10 and 2012-09-5 is 26 months.
1510
Note that the difference between two last days of the month is always 1
1511
month, e.g. 2010-01-31 to 2010-02-28 is 1 month not 28 days.
1514
<dl class="see" compact><dt><b>See also:</b></dt><dd> addMonths()
1515
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dateDifference() yearsDifference() daysDifference()
1516
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
1517
<table border="0" cellspacing="2" cellpadding="0">
1518
<tr><td></td><td valign="top"><em>toDate</em> </td><td> The date to end at
1519
</td></tr> </table></dl>
1520
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The number of months difference
1522
</p></div></div><a class="anchor" name="monthsDifference"></a>
1523
<div class="memitem">
1524
<div class="memproto">
1525
<table class="memname"><tr>
1526
<td class="memname">int monthsDifference</td>
1528
<td class="paramtype"> <em>self</em>, </td>
1529
<td class="paramname"></td>
1531
<td class="memname"></td>
1533
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
1534
<td class="paramname"><em>toDate</em></td>
1541
<td width="100%"> </td>
1544
<div class="memdoc"><p>Returns the difference between this and another date in completed calendar months
1545
in the current Calendar System.
1548
The returned value will be negative if <b>toDate</b> < this date.
1551
For example, the difference between 2010-06-10 and 2012-09-5 is 26 months.
1552
Note that the difference between two last days of the month is always 1
1553
month, e.g. 2010-01-31 to 2010-02-28 is 1 month not 28 days.
1556
<dl class="see" compact><dt><b>See also:</b></dt><dd> addMonths()
1557
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dateDifference() yearsDifference() daysDifference()
1558
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
1559
<table border="0" cellspacing="2" cellpadding="0">
1560
<tr><td></td><td valign="top"><em>toDate</em> </td><td> The date to end at
1561
</td></tr> </table></dl>
1562
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The number of months difference
1564
</p></div></div><a class="anchor" name="monthsInYear"></a>
1565
<div class="memitem">
1566
<div class="memproto">
1567
<table class="memname"><tr>
1568
<td class="memname">int monthsInYear</td>
1570
<td class="paramtype"> </td>
1571
<td class="paramname"><em>self</em> )</td>
1572
<td width="100%"> </td>
1576
<div class="memdoc"><p>Returns number of months in the year
1579
See formatting for why you should never display this value.
1582
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
1583
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> number of months in the year, -1 if date invalid
1585
</p></div></div><a class="anchor" name="operator !="></a>
1586
<div class="memitem">
1587
<div class="memproto">
1588
<table class="memname"><tr>
1589
<td class="memname">bool operator !=</td>
1591
<td class="paramtype"> <em>self</em>, </td>
1592
<td class="paramname"></td>
1594
<td class="memname"></td>
1596
<td class="paramtype"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td>
1597
<td class="paramname"><em>other</em></td>
1604
<td width="100%"> </td>
1607
<div class="memdoc"><p>QDate inequality operator
1610
</p><dl compact><dt><b>Parameters:</b></dt><dd>
1611
<table border="0" cellspacing="2" cellpadding="0">
1612
<tr><td></td><td valign="top"><em>other</em> </td><td> the date to compare
1616
</p></div></div><a class="anchor" name="operator !="></a>
1617
<div class="memitem">
1618
<div class="memproto">
1619
<table class="memname"><tr>
1620
<td class="memname">bool operator !=</td>
1622
<td class="paramtype"> <em>self</em>, </td>
1623
<td class="paramname"></td>
1625
<td class="memname"></td>
1627
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
1628
<td class="paramname"><em>other</em></td>
1635
<td width="100%"> </td>
1638
<div class="memdoc"><p>QDate inequality operator
1641
</p><dl compact><dt><b>Parameters:</b></dt><dd>
1642
<table border="0" cellspacing="2" cellpadding="0">
1643
<tr><td></td><td valign="top"><em>other</em> </td><td> the date to compare
1647
</p></div></div><a class="anchor" name="operator <"></a>
1648
<div class="memitem">
1649
<div class="memproto">
1650
<table class="memname"><tr>
1651
<td class="memname">bool operator <</td>
1653
<td class="paramtype"> <em>self</em>, </td>
1654
<td class="paramname"></td>
1656
<td class="memname"></td>
1658
<td class="paramtype"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td>
1659
<td class="paramname"><em>other</em></td>
1666
<td width="100%"> </td>
1669
<div class="memdoc"><p>QDate less than operator
1672
</p><dl compact><dt><b>Parameters:</b></dt><dd>
1673
<table border="0" cellspacing="2" cellpadding="0">
1674
<tr><td></td><td valign="top"><em>other</em> </td><td> the date to compare
1678
</p></div></div><a class="anchor" name="operator <"></a>
1679
<div class="memitem">
1680
<div class="memproto">
1681
<table class="memname"><tr>
1682
<td class="memname">bool operator <</td>
1684
<td class="paramtype"> <em>self</em>, </td>
1685
<td class="paramname"></td>
1687
<td class="memname"></td>
1689
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
1690
<td class="paramname"><em>other</em></td>
1697
<td width="100%"> </td>
1700
<div class="memdoc"><p>QDate less than operator
1703
</p><dl compact><dt><b>Parameters:</b></dt><dd>
1704
<table border="0" cellspacing="2" cellpadding="0">
1705
<tr><td></td><td valign="top"><em>other</em> </td><td> the date to compare
1709
</p></div></div><a class="anchor" name="operator <="></a>
1710
<div class="memitem">
1711
<div class="memproto">
1712
<table class="memname"><tr>
1713
<td class="memname">bool operator <=</td>
1715
<td class="paramtype"> <em>self</em>, </td>
1716
<td class="paramname"></td>
1718
<td class="memname"></td>
1720
<td class="paramtype"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td>
1721
<td class="paramname"><em>other</em></td>
1728
<td width="100%"> </td>
1731
<div class="memdoc"><p>QDate less than or equal to operator
1734
</p><dl compact><dt><b>Parameters:</b></dt><dd>
1735
<table border="0" cellspacing="2" cellpadding="0">
1736
<tr><td></td><td valign="top"><em>other</em> </td><td> the date to compare
1740
</p></div></div><a class="anchor" name="operator <="></a>
1741
<div class="memitem">
1742
<div class="memproto">
1743
<table class="memname"><tr>
1744
<td class="memname">bool operator <=</td>
1746
<td class="paramtype"> <em>self</em>, </td>
1747
<td class="paramname"></td>
1749
<td class="memname"></td>
1751
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
1752
<td class="paramname"><em>other</em></td>
1759
<td width="100%"> </td>
1762
<div class="memdoc"><p>QDate less than or equal to operator
1765
</p><dl compact><dt><b>Parameters:</b></dt><dd>
1766
<table border="0" cellspacing="2" cellpadding="0">
1767
<tr><td></td><td valign="top"><em>other</em> </td><td> the date to compare
1771
</p></div></div><a class="anchor" name="operator =="></a>
1772
<div class="memitem">
1773
<div class="memproto">
1774
<table class="memname"><tr>
1775
<td class="memname">bool operator ==</td>
1777
<td class="paramtype"> <em>self</em>, </td>
1778
<td class="paramname"></td>
1780
<td class="memname"></td>
1782
<td class="paramtype"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td>
1783
<td class="paramname"><em>other</em></td>
1790
<td width="100%"> </td>
1793
<div class="memdoc"><p>QDate equality operator
1796
</p><dl compact><dt><b>Parameters:</b></dt><dd>
1797
<table border="0" cellspacing="2" cellpadding="0">
1798
<tr><td></td><td valign="top"><em>other</em> </td><td> the date to compare
1802
</p></div></div><a class="anchor" name="operator =="></a>
1803
<div class="memitem">
1804
<div class="memproto">
1805
<table class="memname"><tr>
1806
<td class="memname">bool operator ==</td>
1808
<td class="paramtype"> <em>self</em>, </td>
1809
<td class="paramname"></td>
1811
<td class="memname"></td>
1813
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
1814
<td class="paramname"><em>other</em></td>
1821
<td width="100%"> </td>
1824
<div class="memdoc"><p>QDate equality operator
1827
</p><dl compact><dt><b>Parameters:</b></dt><dd>
1828
<table border="0" cellspacing="2" cellpadding="0">
1829
<tr><td></td><td valign="top"><em>other</em> </td><td> the date to compare
1833
</p></div></div><a class="anchor" name="operator >"></a>
1834
<div class="memitem">
1835
<div class="memproto">
1836
<table class="memname"><tr>
1837
<td class="memname">bool operator ></td>
1839
<td class="paramtype"> <em>self</em>, </td>
1840
<td class="paramname"></td>
1842
<td class="memname"></td>
1844
<td class="paramtype"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td>
1845
<td class="paramname"><em>other</em></td>
1852
<td width="100%"> </td>
1855
<div class="memdoc"><p>QDate greater than operator
1858
</p><dl compact><dt><b>Parameters:</b></dt><dd>
1859
<table border="0" cellspacing="2" cellpadding="0">
1860
<tr><td></td><td valign="top"><em>other</em> </td><td> the date to compare
1864
</p></div></div><a class="anchor" name="operator >"></a>
1865
<div class="memitem">
1866
<div class="memproto">
1867
<table class="memname"><tr>
1868
<td class="memname">bool operator ></td>
1870
<td class="paramtype"> <em>self</em>, </td>
1871
<td class="paramname"></td>
1873
<td class="memname"></td>
1875
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
1876
<td class="paramname"><em>other</em></td>
1883
<td width="100%"> </td>
1886
<div class="memdoc"><p>QDate greater than operator
1889
</p><dl compact><dt><b>Parameters:</b></dt><dd>
1890
<table border="0" cellspacing="2" cellpadding="0">
1891
<tr><td></td><td valign="top"><em>other</em> </td><td> the date to compare
1895
</p></div></div><a class="anchor" name="operator >="></a>
1896
<div class="memitem">
1897
<div class="memproto">
1898
<table class="memname"><tr>
1899
<td class="memname">bool operator >=</td>
1901
<td class="paramtype"> <em>self</em>, </td>
1902
<td class="paramname"></td>
1904
<td class="memname"></td>
1906
<td class="paramtype"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td>
1907
<td class="paramname"><em>other</em></td>
1914
<td width="100%"> </td>
1917
<div class="memdoc"><p>QDate greater than or equal to operator
1920
</p><dl compact><dt><b>Parameters:</b></dt><dd>
1921
<table border="0" cellspacing="2" cellpadding="0">
1922
<tr><td></td><td valign="top"><em>other</em> </td><td> the date to compare
1926
</p></div></div><a class="anchor" name="operator >="></a>
1927
<div class="memitem">
1928
<div class="memproto">
1929
<table class="memname"><tr>
1930
<td class="memname">bool operator >=</td>
1932
<td class="paramtype"> <em>self</em>, </td>
1933
<td class="paramname"></td>
1935
<td class="memname"></td>
1937
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
1938
<td class="paramname"><em>other</em></td>
1945
<td width="100%"> </td>
1948
<div class="memdoc"><p>QDate greater than or equal to operator
1951
</p><dl compact><dt><b>Parameters:</b></dt><dd>
1952
<table border="0" cellspacing="2" cellpadding="0">
1953
<tr><td></td><td valign="top"><em>other</em> </td><td> the date to compare
1957
</p></div></div><a class="anchor" name="setCalendarSystem"></a>
1958
<div class="memitem">
1959
<div class="memproto">
1960
<table class="memname"><tr>
1961
<td class="memname"> setCalendarSystem</td>
1963
<td class="paramtype"> <em>self</em>, </td>
1964
<td class="paramname"></td>
1966
<td class="memname"></td>
1968
<td class="paramtype"><a href="../kdecore/KLocale.html#CalendarSystem">KLocale.CalendarSystem</a> </td>
1969
<td class="paramname"><em>calendarSystem</em></td>
1976
<td width="100%"> </td>
1979
<div class="memdoc"><p>Set the Calendar System used for this date instance only.
1982
This method is mostly useful for when you quickly want to see what the
1983
currently set date would look like in a different Calendar System but
1984
using the same Locale.
1987
When the Calendar System is changed, a copy will be taken of the Locale
1988
previously used and this copy will be applied to the new Calendar System.
1989
Any changes to the old Locale settings, either the Global or a Custom
1990
Locale, will not be applied to this date instance.
1993
See custom for more details on using custom Calendar Systems.
1996
<dl class="see" compact><dt><b>See also:</b></dt><dd> KLocale.CalendarSystem
1997
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> calendarSystem()
1998
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
1999
<table border="0" cellspacing="2" cellpadding="0">
2000
<tr><td></td><td valign="top"><em>calendarSystem</em> </td><td> the Calendar System to use
2004
</p></div></div><a class="anchor" name="setCurrentDate"></a>
2005
<div class="memitem">
2006
<div class="memproto">
2007
<table class="memname"><tr>
2008
<td class="memname">bool setCurrentDate</td>
2010
<td class="paramtype"> </td>
2011
<td class="paramname"><em>self</em> )</td>
2012
<td width="100%"> </td>
2016
<div class="memdoc"><p>Set the date to today's date
2019
<dl class="see" compact><dt><b>See also:</b></dt><dd> currentDate()
2020
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the date is valid, false otherwise
2022
</p></div></div><a class="anchor" name="setDate"></a>
2023
<div class="memitem">
2024
<div class="memproto">
2025
<table class="memname"><tr>
2026
<td class="memname">bool setDate</td>
2028
<td class="paramtype"> <em>self</em>, </td>
2029
<td class="paramname"></td>
2031
<td class="memname"></td>
2033
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
2034
<td class="paramname"><em>date</em></td>
2041
<td width="100%"> </td>
2044
<div class="memdoc"><p>Set the date using the year, week and day of week.
2047
Currently only the ISO Week Number System is supported.
2050
<dl class="see" compact><dt><b>See also:</b></dt><dd> week()
2051
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dayOfWeek()
2052
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
2053
<table border="0" cellspacing="2" cellpadding="0">
2054
<tr><td></td><td valign="top"><em>weekNumberSystem</em> </td><td> the week number system to use
2056
<tr><td></td><td valign="top"><em>year</em> </td><td> year
2058
<tr><td></td><td valign="top"><em>weekOfYear</em> </td><td> week of year
2060
<tr><td></td><td valign="top"><em>dayOfWeek</em> </td><td> day of week Mon..Sun (1..7)
2061
</td></tr> </table></dl>
2062
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the date is valid, false otherwise
2064
</p></div></div><a class="anchor" name="setDate"></a>
2065
<div class="memitem">
2066
<div class="memproto">
2067
<table class="memname"><tr>
2068
<td class="memname">bool setDate</td>
2070
<td class="paramtype"> <em>self</em>, </td>
2071
<td class="paramname"></td>
2073
<td class="memname"></td>
2075
<td class="paramtype">int </td>
2076
<td class="paramname"><em>year</em>, </td>
2079
<td class="memname"></td>
2081
<td class="paramtype">int </td>
2082
<td class="paramname"><em>month</em>, </td>
2085
<td class="memname"></td>
2087
<td class="paramtype">int </td>
2088
<td class="paramname"><em>day</em></td>
2095
<td width="100%"> </td>
2098
<div class="memdoc"><p>Set the date using the year, week and day of week.
2101
Currently only the ISO Week Number System is supported.
2104
<dl class="see" compact><dt><b>See also:</b></dt><dd> week()
2105
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dayOfWeek()
2106
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
2107
<table border="0" cellspacing="2" cellpadding="0">
2108
<tr><td></td><td valign="top"><em>weekNumberSystem</em> </td><td> the week number system to use
2110
<tr><td></td><td valign="top"><em>year</em> </td><td> year
2112
<tr><td></td><td valign="top"><em>weekOfYear</em> </td><td> week of year
2114
<tr><td></td><td valign="top"><em>dayOfWeek</em> </td><td> day of week Mon..Sun (1..7)
2115
</td></tr> </table></dl>
2116
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the date is valid, false otherwise
2118
</p></div></div><a class="anchor" name="setDate"></a>
2119
<div class="memitem">
2120
<div class="memproto">
2121
<table class="memname"><tr>
2122
<td class="memname">bool setDate</td>
2124
<td class="paramtype"> <em>self</em>, </td>
2125
<td class="paramname"></td>
2127
<td class="memname"></td>
2129
<td class="paramtype">int </td>
2130
<td class="paramname"><em>year</em>, </td>
2133
<td class="memname"></td>
2135
<td class="paramtype">int </td>
2136
<td class="paramname"><em>dayOfYear</em></td>
2143
<td width="100%"> </td>
2146
<div class="memdoc"><p>Set the date using the year, week and day of week.
2149
Currently only the ISO Week Number System is supported.
2152
<dl class="see" compact><dt><b>See also:</b></dt><dd> week()
2153
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dayOfWeek()
2154
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
2155
<table border="0" cellspacing="2" cellpadding="0">
2156
<tr><td></td><td valign="top"><em>weekNumberSystem</em> </td><td> the week number system to use
2158
<tr><td></td><td valign="top"><em>year</em> </td><td> year
2160
<tr><td></td><td valign="top"><em>weekOfYear</em> </td><td> week of year
2162
<tr><td></td><td valign="top"><em>dayOfWeek</em> </td><td> day of week Mon..Sun (1..7)
2163
</td></tr> </table></dl>
2164
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the date is valid, false otherwise
2166
</p></div></div><a class="anchor" name="setDate"></a>
2167
<div class="memitem">
2168
<div class="memproto">
2169
<table class="memname"><tr>
2170
<td class="memname">bool setDate</td>
2172
<td class="paramtype"> <em>self</em>, </td>
2173
<td class="paramname"></td>
2175
<td class="memname"></td>
2177
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
2178
<td class="paramname"><em>eraName</em>, </td>
2181
<td class="memname"></td>
2183
<td class="paramtype">int </td>
2184
<td class="paramname"><em>yearInEra</em>, </td>
2187
<td class="memname"></td>
2189
<td class="paramtype">int </td>
2190
<td class="paramname"><em>month</em>, </td>
2193
<td class="memname"></td>
2195
<td class="paramtype">int </td>
2196
<td class="paramname"><em>day</em></td>
2203
<td width="100%"> </td>
2206
<div class="memdoc"><p>Set the date using the year, week and day of week.
2209
Currently only the ISO Week Number System is supported.
2212
<dl class="see" compact><dt><b>See also:</b></dt><dd> week()
2213
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dayOfWeek()
2214
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
2215
<table border="0" cellspacing="2" cellpadding="0">
2216
<tr><td></td><td valign="top"><em>weekNumberSystem</em> </td><td> the week number system to use
2218
<tr><td></td><td valign="top"><em>year</em> </td><td> year
2220
<tr><td></td><td valign="top"><em>weekOfYear</em> </td><td> week of year
2222
<tr><td></td><td valign="top"><em>dayOfWeek</em> </td><td> day of week Mon..Sun (1..7)
2223
</td></tr> </table></dl>
2224
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the date is valid, false otherwise
2226
</p></div></div><a class="anchor" name="setDate"></a>
2227
<div class="memitem">
2228
<div class="memproto">
2229
<table class="memname"><tr>
2230
<td class="memname">bool setDate</td>
2232
<td class="paramtype"> <em>self</em>, </td>
2233
<td class="paramname"></td>
2235
<td class="memname"></td>
2237
<td class="paramtype"><a href="../kdecore/KLocale.html#WeekNumberSystem">KLocale.WeekNumberSystem</a> </td>
2238
<td class="paramname"><em>weekNumberSystem</em>, </td>
2241
<td class="memname"></td>
2243
<td class="paramtype">int </td>
2244
<td class="paramname"><em>year</em>, </td>
2247
<td class="memname"></td>
2249
<td class="paramtype">int </td>
2250
<td class="paramname"><em>weekOfYear</em>, </td>
2253
<td class="memname"></td>
2255
<td class="paramtype">int </td>
2256
<td class="paramname"><em>dayOfWeek</em></td>
2263
<td width="100%"> </td>
2266
<div class="memdoc"><p>Set the date using the year, week and day of week.
2269
Currently only the ISO Week Number System is supported.
2272
<dl class="see" compact><dt><b>See also:</b></dt><dd> week()
2273
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dayOfWeek()
2274
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
2275
<table border="0" cellspacing="2" cellpadding="0">
2276
<tr><td></td><td valign="top"><em>weekNumberSystem</em> </td><td> the week number system to use
2278
<tr><td></td><td valign="top"><em>year</em> </td><td> year
2280
<tr><td></td><td valign="top"><em>weekOfYear</em> </td><td> week of year
2282
<tr><td></td><td valign="top"><em>dayOfWeek</em> </td><td> day of week Mon..Sun (1..7)
2283
</td></tr> </table></dl>
2284
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if the date is valid, false otherwise
2286
</p></div></div><a class="anchor" name="toJulianDay"></a>
2287
<div class="memitem">
2288
<div class="memproto">
2289
<table class="memname"><tr>
2290
<td class="memname">int toJulianDay</td>
2292
<td class="paramtype"> </td>
2293
<td class="paramname"><em>self</em> )</td>
2294
<td width="100%"> </td>
2298
<div class="memdoc"><p>Returns the currently set date as a Julian Day number
2301
<dl class="see" compact><dt><b>See also:</b></dt><dd> fromJulianDay()
2302
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the currently set date as a Julian Day number
2304
</p></div></div><a class="anchor" name="week"></a>
2305
<div class="memitem">
2306
<div class="memproto">
2307
<table class="memname"><tr>
2308
<td class="memname">int week</td>
2310
<td class="paramtype"> <em>self</em>, </td>
2311
<td class="paramname"></td>
2313
<td class="memname"></td>
2315
<td class="paramtype">int </td>
2316
<td class="paramname"><em>yearNum=0</em></td>
2323
<td width="100%"> </td>
2326
<div class="memdoc"><p>Returns the Week Number for the date in the required Week Number System.
2329
See formatting for why you should never display this value.
2332
Unless you want a specific Week Number System (e.g. ISO Week), you should
2333
use the localized Week Number form of week().
2336
If the date falls in the last week of the previous year or the first
2337
week of the following year, then the yearNum returned will be set to the
2341
Technically, the ISO Week Number only applies to the ISO/Gregorian Calendar
2342
System, but the same rules will be applied to the current Calendar System.
2345
<dl class="see" compact><dt><b>See also:</b></dt><dd> weeksInYear()
2346
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
2347
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
2348
<table border="0" cellspacing="2" cellpadding="0">
2349
<tr><td></td><td valign="top"><em>weekNumberSystem</em> </td><td> the Week Number System to use
2351
<tr><td></td><td valign="top"><em>yearNum</em> </td><td> returns the year the date belongs to
2352
</td></tr> </table></dl>
2353
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> week number, -1 if input date invalid
2355
</p></div></div><a class="anchor" name="week"></a>
2356
<div class="memitem">
2357
<div class="memproto">
2358
<table class="memname"><tr>
2359
<td class="memname">int week</td>
2361
<td class="paramtype"> <em>self</em>, </td>
2362
<td class="paramname"></td>
2364
<td class="memname"></td>
2366
<td class="paramtype"><a href="../kdecore/KLocale.html#WeekNumberSystem">KLocale.WeekNumberSystem</a> </td>
2367
<td class="paramname"><em>weekNumberSystem</em>, </td>
2370
<td class="memname"></td>
2372
<td class="paramtype">int </td>
2373
<td class="paramname"><em>yearNum=0</em></td>
2380
<td width="100%"> </td>
2383
<div class="memdoc"><p>Returns the Week Number for the date in the required Week Number System.
2386
See formatting for why you should never display this value.
2389
Unless you want a specific Week Number System (e.g. ISO Week), you should
2390
use the localized Week Number form of week().
2393
If the date falls in the last week of the previous year or the first
2394
week of the following year, then the yearNum returned will be set to the
2398
Technically, the ISO Week Number only applies to the ISO/Gregorian Calendar
2399
System, but the same rules will be applied to the current Calendar System.
2402
<dl class="see" compact><dt><b>See also:</b></dt><dd> weeksInYear()
2403
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
2404
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
2405
<table border="0" cellspacing="2" cellpadding="0">
2406
<tr><td></td><td valign="top"><em>weekNumberSystem</em> </td><td> the Week Number System to use
2408
<tr><td></td><td valign="top"><em>yearNum</em> </td><td> returns the year the date belongs to
2409
</td></tr> </table></dl>
2410
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> week number, -1 if input date invalid
2412
</p></div></div><a class="anchor" name="weeksInYear"></a>
2413
<div class="memitem">
2414
<div class="memproto">
2415
<table class="memname"><tr>
2416
<td class="memname">int weeksInYear</td>
2418
<td class="paramtype"> </td>
2419
<td class="paramname"><em>self</em> )</td>
2420
<td width="100%"> </td>
2424
<div class="memdoc"><p>Returns the number of Weeks in the currently set year using the required
2428
See formatting for why you should never display this value.
2431
Unless you specifically want a particular Week Number System (e.g. ISO Weeks)
2432
you should use the localized number of weeks provided by weeksInYear().
2435
<dl class="see" compact><dt><b>See also:</b></dt><dd> week()
2436
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
2437
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
2438
<table border="0" cellspacing="2" cellpadding="0">
2439
<tr><td></td><td valign="top"><em>weekNumberSystem</em> </td><td> the week number system to use
2440
</td></tr> </table></dl>
2441
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> number of weeks in the year, -1 if date invalid
2443
</p></div></div><a class="anchor" name="weeksInYear"></a>
2444
<div class="memitem">
2445
<div class="memproto">
2446
<table class="memname"><tr>
2447
<td class="memname">int weeksInYear</td>
2449
<td class="paramtype"> <em>self</em>, </td>
2450
<td class="paramname"></td>
2452
<td class="memname"></td>
2454
<td class="paramtype"><a href="../kdecore/KLocale.html#WeekNumberSystem">KLocale.WeekNumberSystem</a> </td>
2455
<td class="paramname"><em>weekNumberSystem</em></td>
2462
<td width="100%"> </td>
2465
<div class="memdoc"><p>Returns the number of Weeks in the currently set year using the required
2469
See formatting for why you should never display this value.
2472
Unless you specifically want a particular Week Number System (e.g. ISO Weeks)
2473
you should use the localized number of weeks provided by weeksInYear().
2476
<dl class="see" compact><dt><b>See also:</b></dt><dd> week()
2477
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
2478
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
2479
<table border="0" cellspacing="2" cellpadding="0">
2480
<tr><td></td><td valign="top"><em>weekNumberSystem</em> </td><td> the week number system to use
2481
</td></tr> </table></dl>
2482
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> number of weeks in the year, -1 if date invalid
2484
</p></div></div><a class="anchor" name="year"></a>
2485
<div class="memitem">
2486
<div class="memproto">
2487
<table class="memname"><tr>
2488
<td class="memname">int year</td>
2490
<td class="paramtype"> </td>
2491
<td class="paramname"><em>self</em> )</td>
2492
<td width="100%"> </td>
2496
<div class="memdoc"><p>Returns the year portion of the date in the current calendar system
2499
See formatting for why you should never display this value.
2502
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
2503
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the localized year number
2505
</p></div></div><a class="anchor" name="yearInEra"></a>
2506
<div class="memitem">
2507
<div class="memproto">
2508
<table class="memname"><tr>
2509
<td class="memname">int yearInEra</td>
2511
<td class="paramtype"> </td>
2512
<td class="paramname"><em>self</em> )</td>
2513
<td width="100%"> </td>
2517
<div class="memdoc"><p>Returns the Year In Era portion of the date in the current calendar
2518
system, for example 1 for "1 BC".
2521
See formatting for why you should never display this value.
2524
<dl class="see" compact><dt><b>See also:</b></dt><dd> formatDate()
2525
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> formatYearInEra()
2526
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the localized Year In Era number, -1 if date is invalid
2528
</p></div></div><a class="anchor" name="yearsDifference"></a>
2529
<div class="memitem">
2530
<div class="memproto">
2531
<table class="memname"><tr>
2532
<td class="memname">int yearsDifference</td>
2534
<td class="paramtype"> <em>self</em>, </td>
2535
<td class="paramname"></td>
2537
<td class="memname"></td>
2539
<td class="paramtype"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> </td>
2540
<td class="paramname"><em>toDate</em></td>
2547
<td width="100%"> </td>
2550
<div class="memdoc"><p>Returns the difference between this and another date in completed calendar years
2551
in the current Calendar System.
2554
The returned value will be negative if <b>toDate</b> < this date.
2557
For example, the difference between 2010-06-10 and 2012-09-5 is 2 years.
2560
<dl class="see" compact><dt><b>See also:</b></dt><dd> addYears()
2561
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dateDifference() monthsDifference() daysDifference()
2562
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
2563
<table border="0" cellspacing="2" cellpadding="0">
2564
<tr><td></td><td valign="top"><em>toDate</em> </td><td> The date to end at
2565
</td></tr> </table></dl>
2566
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The number of years difference
2568
</p></div></div><a class="anchor" name="yearsDifference"></a>
2569
<div class="memitem">
2570
<div class="memproto">
2571
<table class="memname"><tr>
2572
<td class="memname">int yearsDifference</td>
2574
<td class="paramtype"> <em>self</em>, </td>
2575
<td class="paramname"></td>
2577
<td class="memname"></td>
2579
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
2580
<td class="paramname"><em>toDate</em></td>
2587
<td width="100%"> </td>
2590
<div class="memdoc"><p>Returns the difference between this and another date in completed calendar years
2591
in the current Calendar System.
2594
The returned value will be negative if <b>toDate</b> < this date.
2597
For example, the difference between 2010-06-10 and 2012-09-5 is 2 years.
2600
<dl class="see" compact><dt><b>See also:</b></dt><dd> addYears()
2601
</dd></dl> <dl class="see" compact><dt><b>See also:</b></dt><dd> dateDifference() monthsDifference() daysDifference()
2602
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
2603
<table border="0" cellspacing="2" cellpadding="0">
2604
<tr><td></td><td valign="top"><em>toDate</em> </td><td> The date to end at
2605
</td></tr> </table></dl>
2606
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> The number of years difference
2608
</p></div></div><hr><h2>Static Method Documentation</h2><a class="anchor" name="currentDate"></a>
2609
<div class="memitem">
2610
<div class="memproto">
2611
<table class="memname"><tr>
2612
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> currentDate</td>
2614
<td class="paramtype"> </td>
2615
<td class="paramname">)</td>
2616
<td width="100%"> </td>
2620
<div class="memdoc"><p>Returns a KLocalizedDate set to today's date in the Global Locale and
2624
<dl class="see" compact><dt><b>See also:</b></dt><dd> setCurrentDate()
2625
</dd></dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd> today's localized date
2627
</p></div></div><a class="anchor" name="fromDate"></a>
2628
<div class="memitem">
2629
<div class="memproto">
2630
<table class="memname"><tr>
2631
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> fromDate</td>
2633
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qdate.html">QDate</a> </td>
2634
<td class="paramname"><em>date</em></td>
2641
<td width="100%"> </td>
2644
<div class="memdoc"><p>Returns a KLocalizedDate set the required date in the Global Locale and
2648
</p><dl compact><dt><b>Parameters:</b></dt><dd>
2649
<table border="0" cellspacing="2" cellpadding="0">
2650
<tr><td></td><td valign="top"><em>date</em> </td><td> the date to set to
2651
</td></tr> </table></dl>
2652
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> a localized date
2654
</p></div></div><a class="anchor" name="fromJulianDay"></a>
2655
<div class="memitem">
2656
<div class="memproto">
2657
<table class="memname"><tr>
2658
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> fromJulianDay</td>
2660
<td class="paramtype">int </td>
2661
<td class="paramname"><em>jd</em></td>
2668
<td width="100%"> </td>
2671
<div class="memdoc"><p>Returns a KLocalizedDate set the required Julian Day number in the Global
2672
Locale and Calendar System.
2675
<dl class="see" compact><dt><b>See also:</b></dt><dd> toJulianDay()
2676
</dd></dl> </p><dl compact><dt><b>Parameters:</b></dt><dd>
2677
<table border="0" cellspacing="2" cellpadding="0">
2678
<tr><td></td><td valign="top"><em>jd</em> </td><td> the Julian Day number to set to
2679
</td></tr> </table></dl>
2680
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> a localized date
2682
</p></div></div><a class="anchor" name="readDate"></a>
2683
<div class="memitem">
2684
<div class="memproto">
2685
<table class="memname"><tr>
2686
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> readDate</td>
2688
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
2689
<td class="paramname"><em>dateString</em>, </td>
2692
<td class="memname"></td>
2694
<td class="paramtype"><a href="../kdecore/KLocale.html#DateTimeParseMode">KLocale.DateTimeParseMode</a> </td>
2695
<td class="paramname"><em>parseMode=KLocale.LiberalParsing</em>, </td>
2698
<td class="memname"></td>
2700
<td class="paramtype"><a href="../kdecore/KCalendarSystem.html">KCalendarSystem</a> </td>
2701
<td class="paramname"><em>calendar=0</em></td>
2708
<td width="100%"> </td>
2711
<div class="memdoc"><p>Converts a localized date string to a KLocalizedDate using either the
2712
Global Calendar System and Locale, or the provided Calendar System.
2715
See parsing for more details on Date Parsing from strings.
2718
This method allows you to define your own date format to parse the date
2722
If you require one of the standard any KLocale.ReadDateFlags formats
2723
then use one of the other readDate() methods.
2726
</p><dl compact><dt><b>Parameters:</b></dt><dd>
2727
<table border="0" cellspacing="2" cellpadding="0">
2728
<tr><td></td><td valign="top"><em>dateString</em> </td><td> the string to parse
2730
<tr><td></td><td valign="top"><em>dateFormat</em> </td><td> the date format to try parse the string with
2732
<tr><td></td><td valign="top"><em>parseMode</em> </td><td> how strictly to apply the <b>dateFormat</b> to the <b>dateString</b>
2734
<tr><td></td><td valign="top"><em>formatStandard</em> </td><td> the standard the <b>dateFormat</b> format uses
2736
<tr><td></td><td valign="top"><em>calendar</em> </td><td> the Calendar System to use when parsing the date
2737
</td></tr> </table></dl>
2738
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the localized date parsed from the string
2740
</p></div></div><a class="anchor" name="readDate"></a>
2741
<div class="memitem">
2742
<div class="memproto">
2743
<table class="memname"><tr>
2744
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> readDate</td>
2746
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
2747
<td class="paramname"><em>dateString</em>, </td>
2750
<td class="memname"></td>
2752
<td class="paramtype"><a href="../kdecore/KLocale.html#ReadDateFlags">KLocale.ReadDateFlags</a> </td>
2753
<td class="paramname"><em>formatFlags</em>, </td>
2756
<td class="memname"></td>
2758
<td class="paramtype"><a href="../kdecore/KLocale.html#DateTimeParseMode">KLocale.DateTimeParseMode</a> </td>
2759
<td class="paramname"><em>parseMode=KLocale.LiberalParsing</em>, </td>
2762
<td class="memname"></td>
2764
<td class="paramtype"><a href="../kdecore/KCalendarSystem.html">KCalendarSystem</a> </td>
2765
<td class="paramname"><em>calendar=0</em></td>
2772
<td width="100%"> </td>
2775
<div class="memdoc"><p>Converts a localized date string to a KLocalizedDate using either the
2776
Global Calendar System and Locale, or the provided Calendar System.
2779
See parsing for more details on Date Parsing from strings.
2782
This method allows you to define your own date format to parse the date
2786
If you require one of the standard any KLocale.ReadDateFlags formats
2787
then use one of the other readDate() methods.
2790
</p><dl compact><dt><b>Parameters:</b></dt><dd>
2791
<table border="0" cellspacing="2" cellpadding="0">
2792
<tr><td></td><td valign="top"><em>dateString</em> </td><td> the string to parse
2794
<tr><td></td><td valign="top"><em>dateFormat</em> </td><td> the date format to try parse the string with
2796
<tr><td></td><td valign="top"><em>parseMode</em> </td><td> how strictly to apply the <b>dateFormat</b> to the <b>dateString</b>
2798
<tr><td></td><td valign="top"><em>formatStandard</em> </td><td> the standard the <b>dateFormat</b> format uses
2800
<tr><td></td><td valign="top"><em>calendar</em> </td><td> the Calendar System to use when parsing the date
2801
</td></tr> </table></dl>
2802
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the localized date parsed from the string
2804
</p></div></div><a class="anchor" name="readDate"></a>
2805
<div class="memitem">
2806
<div class="memproto">
2807
<table class="memname"><tr>
2808
<td class="memname"><a href="../kdecore/KLocalizedDate.html">KLocalizedDate</a> readDate</td>
2810
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
2811
<td class="paramname"><em>dateString</em>, </td>
2814
<td class="memname"></td>
2816
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
2817
<td class="paramname"><em>dateFormat</em>, </td>
2820
<td class="memname"></td>
2822
<td class="paramtype"><a href="../kdecore/KLocale.html#DateTimeParseMode">KLocale.DateTimeParseMode</a> </td>
2823
<td class="paramname"><em>parseMode=KLocale.LiberalParsing</em>, </td>
2826
<td class="memname"></td>
2828
<td class="paramtype"><a href="../kdecore/KLocale.html#DateTimeFormatStandard">KLocale.DateTimeFormatStandard</a> </td>
2829
<td class="paramname"><em>formatStandard=KLocale.KdeFormat</em>, </td>
2832
<td class="memname"></td>
2834
<td class="paramtype"><a href="../kdecore/KCalendarSystem.html">KCalendarSystem</a> </td>
2835
<td class="paramname"><em>calendar=0</em></td>
2842
<td width="100%"> </td>
2845
<div class="memdoc"><p>Converts a localized date string to a KLocalizedDate using either the
2846
Global Calendar System and Locale, or the provided Calendar System.
2849
See parsing for more details on Date Parsing from strings.
2852
This method allows you to define your own date format to parse the date
2856
If you require one of the standard any KLocale.ReadDateFlags formats
2857
then use one of the other readDate() methods.
2860
</p><dl compact><dt><b>Parameters:</b></dt><dd>
2861
<table border="0" cellspacing="2" cellpadding="0">
2862
<tr><td></td><td valign="top"><em>dateString</em> </td><td> the string to parse
2864
<tr><td></td><td valign="top"><em>dateFormat</em> </td><td> the date format to try parse the string with
2866
<tr><td></td><td valign="top"><em>parseMode</em> </td><td> how strictly to apply the <b>dateFormat</b> to the <b>dateString</b>
2868
<tr><td></td><td valign="top"><em>formatStandard</em> </td><td> the standard the <b>dateFormat</b> format uses
2870
<tr><td></td><td valign="top"><em>calendar</em> </td><td> the Calendar System to use when parsing the date
2871
</td></tr> </table></dl>
2872
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the localized date parsed from the string
2881
<div class="menu_box">
2882
<div class="nav_list">
2884
<li><a href="../allclasses.html">Full Index</a></li>
2888
<a name="cp-menu" /><div class="menutitle"><div>
2889
<h2 id="cp-menu-project">Modules</h2>
2891
<div class="nav_list">
2892
<ul><li><a href="../akonadi/index.html">akonadi</a></li>
2893
<li><a href="../dnssd/index.html">dnssd</a></li>
2894
<li><a href="../kdecore/index.html">kdecore</a></li>
2895
<li><a href="../kdeui/index.html">kdeui</a></li>
2896
<li><a href="../khtml/index.html">khtml</a></li>
2897
<li><a href="../kio/index.html">kio</a></li>
2898
<li><a href="../knewstuff/index.html">knewstuff</a></li>
2899
<li><a href="../kparts/index.html">kparts</a></li>
2900
<li><a href="../kutils/index.html">kutils</a></li>
2901
<li><a href="../nepomuk/index.html">nepomuk</a></li>
2902
<li><a href="../phonon/index.html">phonon</a></li>
2903
<li><a href="../plasma/index.html">plasma</a></li>
2904
<li><a href="../polkitqt/index.html">polkitqt</a></li>
2905
<li><a href="../solid/index.html">solid</a></li>
2906
<li><a href="../soprano/index.html">soprano</a></li>
2912
<div class="clearer"/>
2915
<div id="end_body"></div>
2917
<div id="footer"><div id="footer_text">
2918
This documentation is maintained by <a href="mailto:simon@simonzone.com">Simon Edwards</a>.<br />
2919
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> |
2920
<a href="http://www.kde.org/contact/impressum.php">Legal</a>