← Back to branch summary

~ubuntu-branches/ubuntu/trusty/libzeitgeist/trusty-proposed

« back to all changes in this revision

Viewing changes to doc/reference/html/zeitgeist-1.0-Timestamp-handling.html

  • Committer: Bazaar Package Importer
  • Author(s): Didier Roche
  • Date: 2011-03-23 17:05:43 UTC
  • mfrom: (1.1.8 upstream)
  • Revision ID: james.westby@ubuntu.com-20110323170543-qks4dcl41i222izh
Tags: 0.3.8-0ubuntu1
https://launchpad.net/bugs/734080
https://launchpad.net/bugs/739653
* New upstream release
  - ZeitgeistLog missing implementation of get_property for "connected"
    (LP: #734080)
  - libzeitgeist vapi needs an update (LP: #739653)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/reference/html/zeitgeist-1.0-Timestamp-handling.html
46
46
#define             <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#ZEITGEIST-TIMESTAMP-DAY:CAPS" title="ZEITGEIST_TIMESTAMP_DAY">ZEITGEIST_TIMESTAMP_DAY</a>
47
47
#define             <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#ZEITGEIST-TIMESTAMP-WEEK:CAPS" title="ZEITGEIST_TIMESTAMP_WEEK">ZEITGEIST_TIMESTAMP_WEEK</a>
48
48
#define             <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#ZEITGEIST-TIMESTAMP-YEAR:CAPS" title="ZEITGEIST_TIMESTAMP_YEAR">ZEITGEIST_TIMESTAMP_YEAR</a>
49
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-for-now" title="zeitgeist_timestamp_for_now ()">zeitgeist_timestamp_for_now</a>         (<em class="parameter"><code><span class="type">void</span></code></em>);
50
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-from-timeval" title="zeitgeist_timestamp_from_timeval ()">zeitgeist_timestamp_from_timeval</a>    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *tv</code></em>);
51
 
<span class="returnvalue">void</span>                <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-to-timeval" title="zeitgeist_timestamp_to_timeval ()">zeitgeist_timestamp_to_timeval</a>      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>,
52
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *tv</code></em>);
53
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-from-iso8601" title="zeitgeist_timestamp_from_iso8601 ()">zeitgeist_timestamp_from_iso8601</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> *datetime</code></em>);
54
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-to-iso8601" title="zeitgeist_timestamp_to_iso8601 ()">zeitgeist_timestamp_to_iso8601</a>      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);
55
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-from-date" title="zeitgeist_timestamp_from_date ()">zeitgeist_timestamp_from_date</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>);
56
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-from-dmy" title="zeitgeist_timestamp_from_dmy ()">zeitgeist_timestamp_from_dmy</a>        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDateDay"><span class="type">GDateDay</span></a> day</code></em>,
57
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>,
58
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDateYear"><span class="type">GDateYear</span></a> year</code></em>);
59
 
<span class="returnvalue">void</span>                <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-to-date" title="zeitgeist_timestamp_to_date ()">zeitgeist_timestamp_to_date</a>         (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>,
60
 
                                                         <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>);
61
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-next-midnight" title="zeitgeist_timestamp_next_midnight ()">zeitgeist_timestamp_next_midnight</a>   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);
62
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-prev-midnight" title="zeitgeist_timestamp_prev_midnight ()">zeitgeist_timestamp_prev_midnight</a>   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);
 
49
<a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-for-now" title="zeitgeist_timestamp_for_now ()">zeitgeist_timestamp_for_now</a>         (<em class="parameter"><code><span class="type">void</span></code></em>);
 
50
<a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-from-timeval" title="zeitgeist_timestamp_from_timeval ()">zeitgeist_timestamp_from_timeval</a>    (<em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *tv</code></em>);
 
51
<span class="returnvalue">void</span>                <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-to-timeval" title="zeitgeist_timestamp_to_timeval ()">zeitgeist_timestamp_to_timeval</a>      (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>,
 
52
                                                         <em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *tv</code></em>);
 
53
<a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-from-iso8601" title="zeitgeist_timestamp_from_iso8601 ()">zeitgeist_timestamp_from_iso8601</a>    (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *datetime</code></em>);
 
54
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-to-iso8601" title="zeitgeist_timestamp_to_iso8601 ()">zeitgeist_timestamp_to_iso8601</a>      (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);
 
55
<a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-from-date" title="zeitgeist_timestamp_from_date ()">zeitgeist_timestamp_from_date</a>       (<em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *date</code></em>);
 
56
<a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-from-dmy" title="zeitgeist_timestamp_from_dmy ()">zeitgeist_timestamp_from_dmy</a>        (<em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GDateDay"><span class="type">GDateDay</span></a> day</code></em>,
 
57
                                                         <em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>,
 
58
                                                         <em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GDateYear"><span class="type">GDateYear</span></a> year</code></em>);
 
59
<span class="returnvalue">void</span>                <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-to-date" title="zeitgeist_timestamp_to_date ()">zeitgeist_timestamp_to_date</a>         (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>,
 
60
                                                         <em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *date</code></em>);
 
61
<a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-next-midnight" title="zeitgeist_timestamp_next_midnight ()">zeitgeist_timestamp_next_midnight</a>   (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);
 
62
<a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              <a class="link" href="zeitgeist-1.0-Timestamp-handling.html#zeitgeist-timestamp-prev-midnight" title="zeitgeist_timestamp_prev_midnight ()">zeitgeist_timestamp_prev_midnight</a>   (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);
63
63
</pre>
64
64
</div>
65
65
<div class="refsect1">
68
68
A suite of convenience functions for dealing with timestamps and dates.
69
69
</p>
70
70
<p>
71
 
Zeitgeist timestamps are represented as <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a>s with the number
 
71
Zeitgeist timestamps are represented as <a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a>s with the number
72
72
of milliseconds since the Unix Epoch.
73
73
</p>
74
74
</div>
132
132
<hr>
133
133
<div class="refsect2">
134
134
<a name="zeitgeist-timestamp-for-now"></a><h3>zeitgeist_timestamp_for_now ()</h3>
135
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_for_now         (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
135
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_for_now         (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
136
136
<p>
137
137
Get the timestamp for the current system time
138
138
</p>
148
148
<hr>
149
149
<div class="refsect2">
150
150
<a name="zeitgeist-timestamp-from-timeval"></a><h3>zeitgeist_timestamp_from_timeval ()</h3>
151
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_from_timeval    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *tv</code></em>);</pre>
 
151
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_from_timeval    (<em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *tv</code></em>);</pre>
152
152
<div class="variablelist"><table border="0">
153
153
<col align="left" valign="top">
154
154
<tbody>
155
155
<tr>
156
156
<td><p><span class="term"><em class="parameter"><code>tv</code></em> :</span></p></td>
157
 
<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> instance</td>
 
157
<td>A <a href="../glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> instance</td>
158
158
</tr>
159
159
<tr>
160
160
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
161
 
<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> with the total number of milliseconds since the Unix Epoch</td>
 
161
<td>A <a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> with the total number of milliseconds since the Unix Epoch</td>
162
162
</tr>
163
163
</tbody>
164
164
</table></div>
166
166
<hr>
167
167
<div class="refsect2">
168
168
<a name="zeitgeist-timestamp-to-timeval"></a><h3>zeitgeist_timestamp_to_timeval ()</h3>
169
 
<pre class="programlisting"><span class="returnvalue">void</span>                zeitgeist_timestamp_to_timeval      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>,
170
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *tv</code></em>);</pre>
 
169
<pre class="programlisting"><span class="returnvalue">void</span>                zeitgeist_timestamp_to_timeval      (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>,
 
170
                                                         <em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *tv</code></em>);</pre>
171
171
<p>
172
 
Write a Zeitgeist timestamp to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> instance. Note that Zeitgeist
173
 
uses only a millisecond resolution for where <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> uses a microsecond
 
172
Write a Zeitgeist timestamp to a <a href="../glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> instance. Note that Zeitgeist
 
173
uses only a millisecond resolution for where <a href="../glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> uses a microsecond
174
174
resolution, meaning that the lower three digits of <em class="parameter"><code>tv.tv_usec</code></em> will
175
175
be 0.
176
176
</p>
179
179
<tbody>
180
180
<tr>
181
181
<td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td>
182
 
<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> with a number of milliseconds since the Unix Epoch</td>
 
182
<td>A <a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> with a number of milliseconds since the Unix Epoch</td>
183
183
</tr>
184
184
<tr>
185
185
<td><p><span class="term"><em class="parameter"><code>tv</code></em> :</span></p></td>
186
 
<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> instance to store the result in</td>
 
186
<td>A <a href="../glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> instance to store the result in</td>
187
187
</tr>
188
188
</tbody>
189
189
</table></div>
191
191
<hr>
192
192
<div class="refsect2">
193
193
<a name="zeitgeist-timestamp-from-iso8601"></a><h3>zeitgeist_timestamp_from_iso8601 ()</h3>
194
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_from_iso8601    (<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> *datetime</code></em>);</pre>
 
194
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_from_iso8601    (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *datetime</code></em>);</pre>
195
195
<p>
196
196
Parse a timestamp from a ISO8601 encoded string.
197
197
</p>
214
214
<hr>
215
215
<div class="refsect2">
216
216
<a name="zeitgeist-timestamp-to-iso8601"></a><h3>zeitgeist_timestamp_to_iso8601 ()</h3>
217
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             zeitgeist_timestamp_to_iso8601      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);</pre>
 
217
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             zeitgeist_timestamp_to_iso8601      (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);</pre>
218
218
<p>
219
219
Convert a timestamp to a human readable ISO8601 format
220
220
</p>
228
228
<tr>
229
229
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
230
230
<td>A newly allocated string containing the ISO8601 format of
231
 
<em class="parameter"><code>timestamp</code></em>. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
 
231
<em class="parameter"><code>timestamp</code></em>. Free with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
232
232
</tr>
233
233
</tbody>
234
234
</table></div>
236
236
<hr>
237
237
<div class="refsect2">
238
238
<a name="zeitgeist-timestamp-from-date"></a><h3>zeitgeist_timestamp_from_date ()</h3>
239
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_from_date       (<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>);</pre>
 
239
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_from_date       (<em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
240
240
<p>
241
 
Convert a <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to a Zeitgeist timestamp.
 
241
Convert a <a href="../glib/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to a Zeitgeist timestamp.
242
242
</p>
243
243
<div class="variablelist"><table border="0">
244
244
<col align="left" valign="top">
245
245
<tbody>
246
246
<tr>
247
247
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
248
 
<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to convert</td>
 
248
<td>A <a href="../glib/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to convert</td>
249
249
</tr>
250
250
<tr>
251
251
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
259
259
<hr>
260
260
<div class="refsect2">
261
261
<a name="zeitgeist-timestamp-from-dmy"></a><h3>zeitgeist_timestamp_from_dmy ()</h3>
262
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_from_dmy        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDateDay"><span class="type">GDateDay</span></a> day</code></em>,
263
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>,
264
 
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDateYear"><span class="type">GDateYear</span></a> year</code></em>);</pre>
 
262
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_from_dmy        (<em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GDateDay"><span class="type">GDateDay</span></a> day</code></em>,
 
263
                                                         <em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>,
 
264
                                                         <em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GDateYear"><span class="type">GDateYear</span></a> year</code></em>);</pre>
265
265
<p>
266
266
Convert a day, month, year tuple into a Zeitgeist timestamp
267
267
</p>
270
270
<tbody>
271
271
<tr>
272
272
<td><p><span class="term"><em class="parameter"><code>day</code></em> :</span></p></td>
273
 
<td>The day of the month represented as a <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDateDay"><span class="type">GDateDay</span></a>
 
273
<td>The day of the month represented as a <a href="../glib/glib-Date-and-Time-Functions.html#GDateDay"><span class="type">GDateDay</span></a>
274
274
</td>
275
275
</tr>
276
276
<tr>
277
277
<td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
278
 
<td>The month of the year represented as a <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDateMonth"><span class="type">GDateMonth</span></a>
 
278
<td>The month of the year represented as a <a href="../glib/glib-Date-and-Time-Functions.html#GDateMonth"><span class="type">GDateMonth</span></a>
279
279
</td>
280
280
</tr>
281
281
<tr>
282
282
<td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
283
 
<td>The year represented as a <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDateYear"><span class="type">GDateYear</span></a>
 
283
<td>The year represented as a <a href="../glib/glib-Date-and-Time-Functions.html#GDateYear"><span class="type">GDateYear</span></a>
284
284
</td>
285
285
</tr>
286
286
<tr>
296
296
<hr>
297
297
<div class="refsect2">
298
298
<a name="zeitgeist-timestamp-to-date"></a><h3>zeitgeist_timestamp_to_date ()</h3>
299
 
<pre class="programlisting"><span class="returnvalue">void</span>                zeitgeist_timestamp_to_date         (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>,
300
 
                                                         <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>);</pre>
 
299
<pre class="programlisting"><span class="returnvalue">void</span>                zeitgeist_timestamp_to_date         (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>,
 
300
                                                         <em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
301
301
<p>
302
 
Write a timestamp 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
 
302
Write a timestamp to a <a href="../glib/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> structure
303
303
</p>
304
304
<div class="variablelist"><table border="0">
305
305
<col align="left" valign="top">
306
306
<tbody>
307
307
<tr>
308
308
<td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td>
309
 
<td>The Zeitgeist timestamp to convert to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
 
309
<td>The Zeitgeist timestamp to convert to a <a href="../glib/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
310
310
</td>
311
311
</tr>
312
312
<tr>
313
313
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
314
 
<td>The place to store the result in. Must be non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
314
<td>The place to store the result in. Must be non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
315
315
</td>
316
316
</tr>
317
317
</tbody>
320
320
<hr>
321
321
<div class="refsect2">
322
322
<a name="zeitgeist-timestamp-next-midnight"></a><h3>zeitgeist_timestamp_next_midnight ()</h3>
323
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_next_midnight   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);</pre>
 
323
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_next_midnight   (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);</pre>
324
324
<p>
325
325
Calculate the timestamp for the next midnight after <em class="parameter"><code>timestamp</code></em>
326
326
</p>
345
345
<hr>
346
346
<div class="refsect2">
347
347
<a name="zeitgeist-timestamp-prev-midnight"></a><h3>zeitgeist_timestamp_prev_midnight ()</h3>
348
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_prev_midnight   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);</pre>
 
348
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>              zeitgeist_timestamp_prev_midnight   (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> timestamp</code></em>);</pre>
349
349
<p>
350
350
Calculate the timestamp for the midnight just before <em class="parameter"><code>timestamp</code></em>
351
351
</p>