← Back to branch summary

~ubuntu-branches/ubuntu/quantal/evolution-data-server/quantal

« back to all changes in this revision

Viewing changes to docs/reference/calendar/libecal/html/libecal-e-cal-time-util.html

  • Committer: Package Import Robot
  • Author(s): Mathieu Trudel-Lapierre
  • Date: 2012-07-03 22:41:23 UTC
  • mfrom: (1.1.100)
  • Revision ID: package-import@ubuntu.com-20120703224123-90dydkyfyvff8s0s
Tags: 3.5.3.1-0ubuntu1
* New upstream release 3.5.3.1.
* debian/control:
  - Drop libgconf2-dev from Build-Depends.
  - Bump versions for glib, goa, and libsoup in Build-Depends.
  - Add a Build-Depends on libgcr-3-dev (>= 3.4)
  - Rename packages following upstream SONAME changes.
  - Add Depends on libgnome-keyring-dev to libedataserver1.2-dev.
* debian/rules:
  - Update mkshlibs arguments for libcamel-1.2-38 instead of -33; as it was
    renamed in control due to the soname change.
  - Strip out -Bsymbolic-functions from LDFLAGS.
* Renamed install files in debian/:
  - libcamel-1.2-33.install => libcamel-1.2-38.install
  - libebackend-1.2-2.install => libebackend-1.2-4.install
  - libebook-1.2-13.install => libebook-1.2-17.install
  - libecal-1.2-11.install => libecal-1.2-15.install
  - libedata-book-1.2-13.install => libedata-book-1.2-15.install
  - libedata-cal-1.2-15.install => libedata-cal-1.2-18.install
  - libedataserver-1.2-16.install => libedataserver-1.2-17.install
  - libedataserverui-3.0-1.install => libedataserverui-3.0-4.install
* debian/patches/google_tests_fpic.patch: build tests with -fPIC; otherwise
  build fails.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/calendar/libecal/html/libecal-e-cal-time-util.html
37
37
</tr></table></div>
38
38
<div class="refsynopsisdiv">
39
39
<a name="libecal-e-cal-time-util.synopsis"></a><h2>Synopsis</h2>
40
 
<pre class="synopsis"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="libecal-e-cal-time-util.html#time-days-in-month" title="time_days_in_month ()">time_days_in_month</a>                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> year</code></em>,
41
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> month</code></em>);
42
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="libecal-e-cal-time-util.html#time-day-of-year" title="time_day_of_year ()">time_day_of_year</a>                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> day</code></em>,
43
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> month</code></em>,
44
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> year</code></em>);
45
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="libecal-e-cal-time-util.html#time-day-of-week" title="time_day_of_week ()">time_day_of_week</a>                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> day</code></em>,
46
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> month</code></em>,
47
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> year</code></em>);
48
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libecal-e-cal-time-util.html#time-is-leap-year" title="time_is_leap_year ()">time_is_leap_year</a>                   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> year</code></em>);
49
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="libecal-e-cal-time-util.html#time-leap-years-up-to" title="time_leap_years_up_to ()">time_leap_years_up_to</a>               (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> year</code></em>);
50
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="libecal-e-cal-time-util.html#isodate-from-time-t" title="isodate_from_time_t ()">isodate_from_time_t</a>                 (<em class="parameter"><code><span class="type">time_t</span> t</code></em>);
51
 
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-from-isodate" title="time_from_isodate ()">time_from_isodate</a>                   (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
 
40
<pre class="synopsis"><span class="returnvalue">gint</span>                <a class="link" href="libecal-e-cal-time-util.html#time-days-in-month" title="time_days_in_month ()">time_days_in_month</a>                  (<em class="parameter"><code><span class="type">gint</span> year</code></em>,
 
41
                                                         <em class="parameter"><code><span class="type">gint</span> month</code></em>);
 
42
<span class="returnvalue">gint</span>                <a class="link" href="libecal-e-cal-time-util.html#time-day-of-year" title="time_day_of_year ()">time_day_of_year</a>                    (<em class="parameter"><code><span class="type">gint</span> day</code></em>,
 
43
                                                         <em class="parameter"><code><span class="type">gint</span> month</code></em>,
 
44
                                                         <em class="parameter"><code><span class="type">gint</span> year</code></em>);
 
45
<span class="returnvalue">gint</span>                <a class="link" href="libecal-e-cal-time-util.html#time-day-of-week" title="time_day_of_week ()">time_day_of_week</a>                    (<em class="parameter"><code><span class="type">gint</span> day</code></em>,
 
46
                                                         <em class="parameter"><code><span class="type">gint</span> month</code></em>,
 
47
                                                         <em class="parameter"><code><span class="type">gint</span> year</code></em>);
 
48
<span class="returnvalue">gboolean</span>            <a class="link" href="libecal-e-cal-time-util.html#time-is-leap-year" title="time_is_leap_year ()">time_is_leap_year</a>                   (<em class="parameter"><code><span class="type">gint</span> year</code></em>);
 
49
<span class="returnvalue">gint</span>                <a class="link" href="libecal-e-cal-time-util.html#time-leap-years-up-to" title="time_leap_years_up_to ()">time_leap_years_up_to</a>               (<em class="parameter"><code><span class="type">gint</span> year</code></em>);
 
50
<span class="returnvalue">gchar</span> *             <a class="link" href="libecal-e-cal-time-util.html#isodate-from-time-t" title="isodate_from_time_t ()">isodate_from_time_t</a>                 (<em class="parameter"><code><span class="type">time_t</span> t</code></em>);
 
51
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-from-isodate" title="time_from_isodate ()">time_from_isodate</a>                   (<em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);
52
52
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-add-day" title="time_add_day ()">time_add_day</a>                        (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
53
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> days</code></em>);
 
53
                                                         <em class="parameter"><code><span class="type">gint</span> days</code></em>);
54
54
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-add-week" title="time_add_week ()">time_add_week</a>                       (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
55
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> weeks</code></em>);
 
55
                                                         <em class="parameter"><code><span class="type">gint</span> weeks</code></em>);
56
56
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-day-begin" title="time_day_begin ()">time_day_begin</a>                      (<em class="parameter"><code><span class="type">time_t</span> t</code></em>);
57
57
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-day-end" title="time_day_end ()">time_day_end</a>                        (<em class="parameter"><code><span class="type">time_t</span> t</code></em>);
58
58
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-add-day-with-zone" title="time_add_day_with_zone ()">time_add_day_with_zone</a>              (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
59
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> days</code></em>,
 
59
                                                         <em class="parameter"><code><span class="type">gint</span> days</code></em>,
60
60
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);
61
61
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-add-week-with-zone" title="time_add_week_with_zone ()">time_add_week_with_zone</a>             (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
62
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> weeks</code></em>,
 
62
                                                         <em class="parameter"><code><span class="type">gint</span> weeks</code></em>,
63
63
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);
64
64
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-add-month-with-zone" title="time_add_month_with_zone ()">time_add_month_with_zone</a>            (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
65
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> months</code></em>,
 
65
                                                         <em class="parameter"><code><span class="type">gint</span> months</code></em>,
66
66
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);
67
67
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-year-begin-with-zone" title="time_year_begin_with_zone ()">time_year_begin_with_zone</a>           (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
68
68
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);
69
69
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-month-begin-with-zone" title="time_month_begin_with_zone ()">time_month_begin_with_zone</a>          (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
70
70
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);
71
71
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-week-begin-with-zone" title="time_week_begin_with_zone ()">time_week_begin_with_zone</a>           (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
72
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> week_start_day</code></em>,
 
72
                                                         <em class="parameter"><code><span class="type">gint</span> week_start_day</code></em>,
73
73
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);
74
74
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-day-begin-with-zone" title="time_day_begin_with_zone ()">time_day_begin_with_zone</a>            (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
75
75
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);
76
76
<span class="returnvalue">time_t</span>              <a class="link" href="libecal-e-cal-time-util.html#time-day-end-with-zone" title="time_day_end_with_zone ()">time_day_end_with_zone</a>              (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
77
77
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);
78
 
<span class="returnvalue">void</span>                <a class="link" href="libecal-e-cal-time-util.html#time-to-gdate-with-zone" title="time_to_gdate_with_zone ()">time_to_gdate_with_zone</a>             (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *date</code></em>,
 
78
<span class="returnvalue">void</span>                <a class="link" href="libecal-e-cal-time-util.html#time-to-gdate-with-zone" title="time_to_gdate_with_zone ()">time_to_gdate_with_zone</a>             (<em class="parameter"><code><span class="type">GDate</span> *date</code></em>,
79
79
                                                         <em class="parameter"><code><span class="type">time_t</span> time</code></em>,
80
80
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);
81
 
struct <a href="/usr/share/gtk-doc/html/libedataserver/libedataserver-e-util.html#tm"><span class="returnvalue">tm</span></a>           <a class="link" href="libecal-e-cal-time-util.html#icaltimetype-to-tm" title="icaltimetype_to_tm ()">icaltimetype_to_tm</a>                  (<em class="parameter"><code><span class="type">struct icaltimetype</span> *itt</code></em>);
82
 
struct <a href="/usr/share/gtk-doc/html/libedataserver/libedataserver-e-util.html#tm"><span class="returnvalue">tm</span></a>           <a class="link" href="libecal-e-cal-time-util.html#icaltimetype-to-tm-with-zone" title="icaltimetype_to_tm_with_zone ()">icaltimetype_to_tm_with_zone</a>        (<em class="parameter"><code><span class="type">struct icaltimetype</span> *itt</code></em>,
 
81
struct <span class="returnvalue">tm</span>           <a class="link" href="libecal-e-cal-time-util.html#icaltimetype-to-tm" title="icaltimetype_to_tm ()">icaltimetype_to_tm</a>                  (<em class="parameter"><code><span class="type">struct icaltimetype</span> *itt</code></em>);
 
82
struct <span class="returnvalue">tm</span>           <a class="link" href="libecal-e-cal-time-util.html#icaltimetype-to-tm-with-zone" title="icaltimetype_to_tm_with_zone ()">icaltimetype_to_tm_with_zone</a>        (<em class="parameter"><code><span class="type">struct icaltimetype</span> *itt</code></em>,
83
83
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *from_zone</code></em>,
84
84
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *to_zone</code></em>);
85
85
struct <span class="returnvalue">icaltimetype</span> <a class="link" href="libecal-e-cal-time-util.html#tm-to-icaltimetype" title="tm_to_icaltimetype ()">tm_to_icaltimetype</a>                  (<em class="parameter"><code><span class="type">struct tm</span> *tm</code></em>,
86
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_date</code></em>);
 
86
                                                         <em class="parameter"><code><span class="type">gboolean</span> is_date</code></em>);
87
87
</pre>
88
88
</div>
89
89
<div class="refsect1">
93
93
<a name="libecal-e-cal-time-util.details"></a><h2>Details</h2>
94
94
<div class="refsect2">
95
95
<a name="time-days-in-month"></a><h3>time_days_in_month ()</h3>
96
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                time_days_in_month                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> year</code></em>,
97
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> month</code></em>);</pre>
 
96
<pre class="programlisting"><span class="returnvalue">gint</span>                time_days_in_month                  (<em class="parameter"><code><span class="type">gint</span> year</code></em>,
 
97
                                                         <em class="parameter"><code><span class="type">gint</span> month</code></em>);</pre>
98
98
<p>
99
99
Returns the number of days in the month. Year is the normal year, e.g. 2001.
100
100
Month is 0 (Jan) to 11 (Dec).
120
120
<hr>
121
121
<div class="refsect2">
122
122
<a name="time-day-of-year"></a><h3>time_day_of_year ()</h3>
123
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                time_day_of_year                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> day</code></em>,
124
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> month</code></em>,
125
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> year</code></em>);</pre>
 
123
<pre class="programlisting"><span class="returnvalue">gint</span>                time_day_of_year                    (<em class="parameter"><code><span class="type">gint</span> day</code></em>,
 
124
                                                         <em class="parameter"><code><span class="type">gint</span> month</code></em>,
 
125
                                                         <em class="parameter"><code><span class="type">gint</span> year</code></em>);</pre>
126
126
<p>
127
127
Returns the 1-based day number within the year of the specified date.
128
128
Year is the normal year, e.g. 2001. Month is 0 to 11.
152
152
<hr>
153
153
<div class="refsect2">
154
154
<a name="time-day-of-week"></a><h3>time_day_of_week ()</h3>
155
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                time_day_of_week                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> day</code></em>,
156
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> month</code></em>,
157
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> year</code></em>);</pre>
 
155
<pre class="programlisting"><span class="returnvalue">gint</span>                time_day_of_week                    (<em class="parameter"><code><span class="type">gint</span> day</code></em>,
 
156
                                                         <em class="parameter"><code><span class="type">gint</span> month</code></em>,
 
157
                                                         <em class="parameter"><code><span class="type">gint</span> year</code></em>);</pre>
158
158
<p>
159
159
Returns the day of the week for the specified date, 0 (Sun) to 6 (Sat).
160
160
For the days that were removed on the Gregorian reformation, it returns
185
185
<hr>
186
186
<div class="refsect2">
187
187
<a name="time-is-leap-year"></a><h3>time_is_leap_year ()</h3>
188
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            time_is_leap_year                   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> year</code></em>);</pre>
 
188
<pre class="programlisting"><span class="returnvalue">gboolean</span>            time_is_leap_year                   (<em class="parameter"><code><span class="type">gint</span> year</code></em>);</pre>
189
189
<p>
190
190
Returns whether the specified year is a leap year. Year is the normal year,
191
191
e.g. 2001.
207
207
<hr>
208
208
<div class="refsect2">
209
209
<a name="time-leap-years-up-to"></a><h3>time_leap_years_up_to ()</h3>
210
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                time_leap_years_up_to               (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> year</code></em>);</pre>
 
210
<pre class="programlisting"><span class="returnvalue">gint</span>                time_leap_years_up_to               (<em class="parameter"><code><span class="type">gint</span> year</code></em>);</pre>
211
211
<p>
212
212
Returns the number of leap years since year 1 up to (but not including) the
213
213
specified year. Year is the normal year, e.g. 2001.
229
229
<hr>
230
230
<div class="refsect2">
231
231
<a name="isodate-from-time-t"></a><h3>isodate_from_time_t ()</h3>
232
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             isodate_from_time_t                 (<em class="parameter"><code><span class="type">time_t</span> t</code></em>);</pre>
 
232
<pre class="programlisting"><span class="returnvalue">gchar</span> *             isodate_from_time_t                 (<em class="parameter"><code><span class="type">time_t</span> t</code></em>);</pre>
233
233
<p>
234
234
Creates an ISO 8601 UTC representation from a time value.
235
235
</p>
250
250
<hr>
251
251
<div class="refsect2">
252
252
<a name="time-from-isodate"></a><h3>time_from_isodate ()</h3>
253
 
<pre class="programlisting"><span class="returnvalue">time_t</span>              time_from_isodate                   (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
 
253
<pre class="programlisting"><span class="returnvalue">time_t</span>              time_from_isodate                   (<em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);</pre>
254
254
<p>
255
255
Converts an ISO 8601 UTC time string into a time_t value.
256
256
</p>
273
273
<div class="refsect2">
274
274
<a name="time-add-day"></a><h3>time_add_day ()</h3>
275
275
<pre class="programlisting"><span class="returnvalue">time_t</span>              time_add_day                        (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
276
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> days</code></em>);</pre>
 
276
                                                         <em class="parameter"><code><span class="type">gint</span> days</code></em>);</pre>
277
277
<p>
278
278
Adds a day onto the time, using local time.
279
279
Note that if clocks go forward due to daylight savings time, there are
305
305
<div class="refsect2">
306
306
<a name="time-add-week"></a><h3>time_add_week ()</h3>
307
307
<pre class="programlisting"><span class="returnvalue">time_t</span>              time_add_week                       (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
308
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> weeks</code></em>);</pre>
 
308
                                                         <em class="parameter"><code><span class="type">gint</span> weeks</code></em>);</pre>
309
309
<p>
310
310
Adds the given number of weeks to a time value.
311
311
</p>
373
373
<div class="refsect2">
374
374
<a name="time-add-day-with-zone"></a><h3>time_add_day_with_zone ()</h3>
375
375
<pre class="programlisting"><span class="returnvalue">time_t</span>              time_add_day_with_zone              (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
376
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> days</code></em>,
 
376
                                                         <em class="parameter"><code><span class="type">gint</span> days</code></em>,
377
377
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);</pre>
378
378
<p>
379
379
Adds or subtracts a number of days to/from the given time_t value, using
408
408
<div class="refsect2">
409
409
<a name="time-add-week-with-zone"></a><h3>time_add_week_with_zone ()</h3>
410
410
<pre class="programlisting"><span class="returnvalue">time_t</span>              time_add_week_with_zone             (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
411
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> weeks</code></em>,
 
411
                                                         <em class="parameter"><code><span class="type">gint</span> weeks</code></em>,
412
412
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);</pre>
413
413
<p>
414
414
Adds or subtracts a number of weeks to/from the given time_t value, using
443
443
<div class="refsect2">
444
444
<a name="time-add-month-with-zone"></a><h3>time_add_month_with_zone ()</h3>
445
445
<pre class="programlisting"><span class="returnvalue">time_t</span>              time_add_month_with_zone            (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
446
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> months</code></em>,
 
446
                                                         <em class="parameter"><code><span class="type">gint</span> months</code></em>,
447
447
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);</pre>
448
448
<p>
449
449
Adds or subtracts a number of months to/from the given time_t value, using
545
545
<div class="refsect2">
546
546
<a name="time-week-begin-with-zone"></a><h3>time_week_begin_with_zone ()</h3>
547
547
<pre class="programlisting"><span class="returnvalue">time_t</span>              time_week_begin_with_zone           (<em class="parameter"><code><span class="type">time_t</span> time</code></em>,
548
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> week_start_day</code></em>,
 
548
                                                         <em class="parameter"><code><span class="type">gint</span> week_start_day</code></em>,
549
549
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);</pre>
550
550
<p>
551
551
Returns the start of the week containing the given time_t, using the given
640
640
<hr>
641
641
<div class="refsect2">
642
642
<a name="time-to-gdate-with-zone"></a><h3>time_to_gdate_with_zone ()</h3>
643
 
<pre class="programlisting"><span class="returnvalue">void</span>                time_to_gdate_with_zone             (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *date</code></em>,
 
643
<pre class="programlisting"><span class="returnvalue">void</span>                time_to_gdate_with_zone             (<em class="parameter"><code><span class="type">GDate</span> *date</code></em>,
644
644
                                                         <em class="parameter"><code><span class="type">time_t</span> time</code></em>,
645
645
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *zone</code></em>);</pre>
646
646
<p>
647
 
Converts a time_t value to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> structure using the specified timezone.
648
 
This is analogous to <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#g-date-set-time"><code class="function">g_date_set_time()</code></a> but takes the timezone into account.
 
647
Converts a time_t value to a <span class="type">GDate</span> structure using the specified timezone.
 
648
This is analogous to <code class="function">g_date_set_time()</code> but takes the timezone into account.
649
649
</p>
650
650
<div class="variablelist"><table border="0">
651
651
<col align="left" valign="top">
652
652
<tbody>
653
653
<tr>
654
654
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
655
 
<td>Destination <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> value.</td>
 
655
<td>Destination <span class="type">GDate</span> value.</td>
656
656
</tr>
657
657
<tr>
658
658
<td><p><span class="term"><em class="parameter"><code>time</code></em> :</span></p></td>
669
669
<hr>
670
670
<div class="refsect2">
671
671
<a name="icaltimetype-to-tm"></a><h3>icaltimetype_to_tm ()</h3>
672
 
<pre class="programlisting">struct <a href="/usr/share/gtk-doc/html/libedataserver/libedataserver-e-util.html#tm"><span class="returnvalue">tm</span></a>           icaltimetype_to_tm                  (<em class="parameter"><code><span class="type">struct icaltimetype</span> *itt</code></em>);</pre>
 
672
<pre class="programlisting">struct <span class="returnvalue">tm</span>           icaltimetype_to_tm                  (<em class="parameter"><code><span class="type">struct icaltimetype</span> *itt</code></em>);</pre>
673
673
<p>
674
674
Convers an icaltimetype structure into a GLibc's struct tm.
675
675
</p>
692
692
<hr>
693
693
<div class="refsect2">
694
694
<a name="icaltimetype-to-tm-with-zone"></a><h3>icaltimetype_to_tm_with_zone ()</h3>
695
 
<pre class="programlisting">struct <a href="/usr/share/gtk-doc/html/libedataserver/libedataserver-e-util.html#tm"><span class="returnvalue">tm</span></a>           icaltimetype_to_tm_with_zone        (<em class="parameter"><code><span class="type">struct icaltimetype</span> *itt</code></em>,
 
695
<pre class="programlisting">struct <span class="returnvalue">tm</span>           icaltimetype_to_tm_with_zone        (<em class="parameter"><code><span class="type">struct icaltimetype</span> *itt</code></em>,
696
696
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *from_zone</code></em>,
697
697
                                                         <em class="parameter"><code><span class="type">icaltimezone</span> *to_zone</code></em>);</pre>
698
698
<p>
727
727
<div class="refsect2">
728
728
<a name="tm-to-icaltimetype"></a><h3>tm_to_icaltimetype ()</h3>
729
729
<pre class="programlisting">struct <span class="returnvalue">icaltimetype</span> tm_to_icaltimetype                  (<em class="parameter"><code><span class="type">struct tm</span> *tm</code></em>,
730
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> is_date</code></em>);</pre>
 
730
                                                         <em class="parameter"><code><span class="type">gboolean</span> is_date</code></em>);</pre>
731
731
<p>
732
732
Converts a struct tm into an icaltimetype.
733
733
</p>