← Back to branch summary

~ubuntu-branches/ubuntu/hardy/evolution-data-server/hardy-updates

« back to all changes in this revision

Viewing changes to docs/reference/libedataserver/html/libedataserver-e-time-utils.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-11-13 10:59:20 UTC
  • mfrom: (1.1.38 upstream)
  • Revision ID: james.westby@ubuntu.com-20071113105920-nb6w14udvgx0ghi3
Tags: 2.21.2-0ubuntu1
https://launchpad.net/bugs/23912
* New upstream version:
  Bug Fixes:
  - #318842: Task lists should be sorted (LP: #23912)
  - #345135: Disable SSLv2 compatible HELLO on SSL stream when 
    SSLv2 is disabled
  - #359267: Not all memos are showed in calendar view
  - #430420: Returned size <= 0 is an error
  - #460649: Meeting UI Needs To Show Color Of Selected Calendar Source
  - #487229: Use GKeyFile instead of gnome-config to access stored passwords
  - #488156: Minimize use of the WITH_GNOME_KEYRING macro
  - #492130: ESourceSelector uses pointers to ESource
  - #494304: Fix leak
  Updated Translations
  New in 2.21.1:
  - Support for Google Calendar
  Bug Fixes:
  - #203480: (Novell Bugzilla) Compiler warning fix 
    for usage ofunintialized variable
  - #231178: New symbol 'set-label' defined and added corresponding callback
  - #271777: Keep character's case as user types
  - #417999: Don't use deprecated GTK+ symbols
  - #420167: e-d-s now exits with gnome-session
  - #469657: Better use of GHashTable
  - #474000: Use GLib's Base64 API instead of Camel's
  - #475487: When creating the default contact, print errors to the console
  - #475493: Use G_DEFINE_TYPE
  - #475494: Use G_LOCK instead of a static mutex for clearer code
  - #478404: Reset the id to zero
  - #483301: Remove an unused variable
  - #487270: Fix typo in documentation
  - #488173: Remove __FUNCTION__, which is a gcc-ism
  - #488351: Fix an addressbook error on a fresh install
  Other Contributors:
  - Protect against a NULL subject string. 
* debian/*.preinst:
  - On upgrades from Gutsy, remove the symlinks introduced in Gutsy. They
    break upgrades all over, and current cdbs just symlinks individual files.
* Sync with Debian
* debian/control:
  - evolution-data-server Breaks evolution (<< 2.9), 
    evolution-exchange (<= 2.8.1-0ubuntu1),
    evolution-jescs (<= 2.8.2-0ubuntu3), 
    evolution-scalix (<= 10.0.0.357-0ubuntu6)
  - updated maintainer to desktop team
* debian/rules:
  - don't specify the paths for nspr and nss since the package is built 
    with firefox
  - don't build documentation, it's distributed in the upstream tarball

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/libedataserver/html/libedataserver-e-time-utils.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>Time-Related Utility Functions</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.73.1">
7
7
<link rel="start" href="index.html" title="Evolution API Reference: libedataserver, utility library">
8
8
<link rel="up" href="ch01.html" title="Evolution API Reference: libedataserver, utility library">
9
9
<link rel="prev" href="ESourceList.html" title="ESourceList">
10
10
<link rel="next" href="libedataserver-e-trie.html" title="ETrie">
11
 
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="ch01.html" title="Evolution API Reference: libedataserver, utility library">
14
14
<link rel="index" href="ix01.html" title="Index">
22
22
<th width="100%" align="center">Evolution API Reference: libedataserver, utility library</th>
23
23
<td><a accesskey="n" href="libedataserver-e-trie.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
24
24
</tr>
25
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2600586" class="shortcut">Top</a>
 
25
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2601585" class="shortcut">Top</a>
26
26
                  &#160;|&#160;
27
 
                  <a href="#id2622300" class="shortcut">Description</a></nobr></td></tr>
 
27
                  <a href="#id2648799" class="shortcut">Description</a></nobr></td></tr>
28
28
</table>
29
29
<div class="refentry" lang="en">
30
30
<a name="libedataserver-e-time-utils"></a><div class="titlepage"></div>
31
31
<div class="refnamediv"><table width="100%"><tr>
32
32
<td valign="top">
33
33
<h2>
34
 
<a name="id2600586"></a><span class="refentrytitle">Time-Related Utility Functions</span>
 
34
<a name="id2601585"></a><span class="refentrytitle">Time-Related Utility Functions</span>
35
35
</h2>
36
36
<p>Time-Related Utility Functions &#8212; Utility functions for time structure manipulation.</p>
37
37
</td>
43
43
 
44
44
 
45
45
 
46
 
enum                <a href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>;
47
 
<a href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>    <a href="libedataserver-e-time-utils.html#e-time-parse-date-and-time">e_time_parse_date_and_time</a>          (const char *value,
48
 
                                                         struct tm *result);
49
 
<a href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>    <a href="libedataserver-e-time-utils.html#e-time-parse-date">e_time_parse_date</a>                   (const char *value,
50
 
                                                         struct tm *result);
51
 
<a href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>    <a href="libedataserver-e-time-utils.html#e-time-parse-time">e_time_parse_time</a>                   (const char *value,
52
 
                                                         struct tm *result);
53
 
void                <a href="libedataserver-e-time-utils.html#e-time-format-date-and-time">e_time_format_date_and_time</a>         (struct tm *date_tm,
54
 
                                                         <a
55
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
56
 
>gboolean</a> use_24_hour_format,
57
 
                                                         <a
58
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
59
 
>gboolean</a> show_midnight,
60
 
                                                         <a
61
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
62
 
>gboolean</a> show_zero_seconds,
63
 
                                                         char *buffer,
64
 
                                                         int buffer_size);
65
 
void                <a href="libedataserver-e-time-utils.html#e-time-format-time">e_time_format_time</a>                  (struct tm *date_tm,
66
 
                                                         <a
67
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
68
 
>gboolean</a> use_24_hour_format,
69
 
                                                         <a
70
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
71
 
>gboolean</a> show_zero_seconds,
72
 
                                                         char *buffer,
73
 
                                                         int buffer_size);
74
 
time_t              <a href="libedataserver-e-time-utils.html#e-mktime-utc">e_mktime_utc</a>                        (struct tm *tm);
75
 
void                <a href="libedataserver-e-time-utils.html#e-localtime-with-offset">e_localtime_with_offset</a>             (time_t tt,
 
46
enum                <a class="link" href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>;
 
47
<a class="link" href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>    <a class="link" href="libedataserver-e-time-utils.html#e-time-parse-date-and-time">e_time_parse_date_and_time</a>          (const char *value,
 
48
                                                         struct tm *result);
 
49
<a class="link" href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>    <a class="link" href="libedataserver-e-time-utils.html#e-time-parse-date">e_time_parse_date</a>                   (const char *value,
 
50
                                                         struct tm *result);
 
51
<a class="link" href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>    <a class="link" href="libedataserver-e-time-utils.html#e-time-parse-time">e_time_parse_time</a>                   (const char *value,
 
52
                                                         struct tm *result);
 
53
void                <a class="link" href="libedataserver-e-time-utils.html#e-time-format-date-and-time">e_time_format_date_and_time</a>         (struct tm *date_tm,
 
54
                                                         gboolean use_24_hour_format,
 
55
                                                         gboolean show_midnight,
 
56
                                                         gboolean show_zero_seconds,
 
57
                                                         char *buffer,
 
58
                                                         int buffer_size);
 
59
void                <a class="link" href="libedataserver-e-time-utils.html#e-time-format-time">e_time_format_time</a>                  (struct tm *date_tm,
 
60
                                                         gboolean use_24_hour_format,
 
61
                                                         gboolean show_zero_seconds,
 
62
                                                         char *buffer,
 
63
                                                         int buffer_size);
 
64
time_t              <a class="link" href="libedataserver-e-time-utils.html#e-mktime-utc">e_mktime_utc</a>                        (struct tm *tm);
 
65
void                <a class="link" href="libedataserver-e-time-utils.html#e-localtime-with-offset">e_localtime_with_offset</a>             (time_t tt,
76
66
                                                         struct tm *tm,
77
67
                                                         int *offset);
78
68
</pre>
79
69
</div>
80
70
<div class="refsect1" lang="en">
81
 
<a name="id2622300"></a><h2>Description</h2>
 
71
<a name="id2648799"></a><h2>Description</h2>
82
72
<p>
83
73
 
84
74
</p>
85
75
</div>
86
76
<div class="refsect1" lang="en">
87
 
<a name="id2622315"></a><h2>Details</h2>
 
77
<a name="id2648815"></a><h2>Details</h2>
88
78
<div class="refsect2" lang="en">
89
 
<a name="id2622326"></a><h3>
 
79
<a name="id2648826"></a><h3>
90
80
<a name="ETimeParseStatus"></a>enum ETimeParseStatus</h3>
91
 
<a class="indexterm" name="id2622339"></a><pre class="programlisting">typedef enum {
 
81
<a class="indexterm" name="id2648838"></a><pre class="programlisting">typedef enum {
92
82
        E_TIME_PARSE_OK,
93
83
        E_TIME_PARSE_NONE,
94
84
        E_TIME_PARSE_INVALID
103
93
<col align="left" valign="top">
104
94
<tbody>
105
95
<tr>
106
 
<td><span class="term"><a name="E-TIME-PARSE-OK:CAPS"></a><code class="literal">E_TIME_PARSE_OK</code></span></td>
 
96
<td><p><span class="term"><a name="E-TIME-PARSE-OK:CAPS"></a><code class="literal">E_TIME_PARSE_OK</code></span></p></td>
107
97
<td> The time string was parsed successfully.
108
98
</td>
109
99
</tr>
110
100
<tr>
111
 
<td><span class="term"><a name="E-TIME-PARSE-NONE:CAPS"></a><code class="literal">E_TIME_PARSE_NONE</code></span></td>
 
101
<td><p><span class="term"><a name="E-TIME-PARSE-NONE:CAPS"></a><code class="literal">E_TIME_PARSE_NONE</code></span></p></td>
112
102
<td> The time string was empty.
113
103
</td>
114
104
</tr>
115
105
<tr>
116
 
<td><span class="term"><a name="E-TIME-PARSE-INVALID:CAPS"></a><code class="literal">E_TIME_PARSE_INVALID</code></span></td>
 
106
<td><p><span class="term"><a name="E-TIME-PARSE-INVALID:CAPS"></a><code class="literal">E_TIME_PARSE_INVALID</code></span></p></td>
117
107
<td> The time string was not formatted correctly.
118
108
</td>
119
109
</tr>
122
112
</div>
123
113
<hr>
124
114
<div class="refsect2" lang="en">
125
 
<a name="id2622427"></a><h3>
 
115
<a name="id2645340"></a><h3>
126
116
<a name="e-time-parse-date-and-time"></a>e_time_parse_date_and_time ()</h3>
127
 
<a class="indexterm" name="id2622438"></a><pre class="programlisting"><a href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>    e_time_parse_date_and_time          (const char *value,
 
117
<a class="indexterm" name="id2645352"></a><pre class="programlisting"><a class="link" href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>    e_time_parse_date_and_time          (const char *value,
128
118
                                                         struct tm *result);</pre>
129
119
<p>
130
120
Parses a string <em class="parameter"><code>value</code></em> containing a date and a time and stores the
131
121
result in <em class="parameter"><code>result</code></em>. The date in <em class="parameter"><code>value</code></em> is expected to be in a format
132
 
like "Wed 3/13/00 14:20:00", though <a
133
 
href="/opt/gnome/share/gtk-doc/html/libbonobo/libbonobo-bonobo-i18n.html#gettext"
134
 
><code class="function">gettext()</code></a> is used to support the
 
122
like "Wed 3/13/00 14:20:00", though <code class="function">gettext()</code> is used to support the
135
123
appropriate local formats. There is also some leniency on the
136
124
format of the string, e.g. the weekday can be skipped or 12-hour
137
125
formats with am/pm can be used.</p>
142
130
<col align="left" valign="top">
143
131
<tbody>
144
132
<tr>
145
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
133
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
146
134
<td> The string to parse a date and time from.
147
135
</td>
148
136
</tr>
149
137
<tr>
150
 
<td><span class="term"><em class="parameter"><code>result</code></em>&#160;:</span></td>
151
 
<td> A <a href="libedataserver-e-util.html#tm"><span class="type">tm</span></a> to store the result in.
 
138
<td><p><span class="term"><em class="parameter"><code>result</code></em>&#160;:</span></p></td>
 
139
<td> A <a class="link" href="libedataserver-e-util.html#tm"><span class="type">tm</span></a> to store the result in.
152
140
</td>
153
141
</tr>
154
142
<tr>
155
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
143
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
156
144
<td> E_TIME_PARSE_OK if the string was successfully parsed,
157
145
         E_TIME_PARSE_NONE if the string was empty, or 
158
146
         E_TIME_PARSE_INVALID if the string could not be parsed.
163
151
</div>
164
152
<hr>
165
153
<div class="refsect2" lang="en">
166
 
<a name="id2618849"></a><h3>
 
154
<a name="id2645475"></a><h3>
167
155
<a name="e-time-parse-date"></a>e_time_parse_date ()</h3>
168
 
<a class="indexterm" name="id2618862"></a><pre class="programlisting"><a href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>    e_time_parse_date                   (const char *value,
 
156
<a class="indexterm" name="id2645487"></a><pre class="programlisting"><a class="link" href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>    e_time_parse_date                   (const char *value,
169
157
                                                         struct tm *result);</pre>
170
158
<p>
171
159
Takes in a date string entered by the user and tries to convert it to
172
 
a struct <a href="libedataserver-e-util.html#tm"><span class="type">tm</span></a>.</p>
 
160
a struct <a class="link" href="libedataserver-e-util.html#tm"><span class="type">tm</span></a>.</p>
173
161
<p>
174
162
 
175
163
</p>
177
165
<col align="left" valign="top">
178
166
<tbody>
179
167
<tr>
180
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
168
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
181
169
<td> A date string.
182
170
</td>
183
171
</tr>
184
172
<tr>
185
 
<td><span class="term"><em class="parameter"><code>result</code></em>&#160;:</span></td>
 
173
<td><p><span class="term"><em class="parameter"><code>result</code></em>&#160;:</span></p></td>
186
174
<td> Return value for the parsed date.
187
175
</td>
188
176
</tr>
189
177
<tr>
190
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
191
 
<td> An <a href="libedataserver-e-time-utils.html#ETimeParseStatus"><span class="type">ETimeParseStatus</span></a> result code indicating whether
 
178
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
179
<td> An <a class="link" href="libedataserver-e-time-utils.html#ETimeParseStatus"><span class="type">ETimeParseStatus</span></a> result code indicating whether
192
180
<em class="parameter"><code>value</code></em> was an empty string, a valid date, or an invalid date.
193
181
</td>
194
182
</tr>
197
185
</div>
198
186
<hr>
199
187
<div class="refsect2" lang="en">
200
 
<a name="id2618965"></a><h3>
 
188
<a name="id2634041"></a><h3>
201
189
<a name="e-time-parse-time"></a>e_time_parse_time ()</h3>
202
 
<a class="indexterm" name="id2618977"></a><pre class="programlisting"><a href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>    e_time_parse_time                   (const char *value,
 
190
<a class="indexterm" name="id2634054"></a><pre class="programlisting"><a class="link" href="libedataserver-e-time-utils.html#ETimeParseStatus">ETimeParseStatus</a>    e_time_parse_time                   (const char *value,
203
191
                                                         struct tm *result);</pre>
204
192
<p>
205
193
Parses <em class="parameter"><code>value</code></em>, a string containing a time. <em class="parameter"><code>value</code></em> is expected to be
206
 
in a format like "14:20:00". <a
207
 
href="/opt/gnome/share/gtk-doc/html/libbonobo/libbonobo-bonobo-i18n.html#gettext"
208
 
><code class="function">gettext()</code></a> is used to
 
194
in a format like "14:20:00". <code class="function">gettext()</code> is used to
209
195
support the appropriate local formats and slightly
210
196
different formats, such as 12-hour formats with am/pm,
211
197
are accepted as well.</p>
216
202
<col align="left" valign="top">
217
203
<tbody>
218
204
<tr>
219
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
205
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
220
206
<td> The string to parse a time from.
221
207
</td>
222
208
</tr>
223
209
<tr>
224
 
<td><span class="term"><em class="parameter"><code>result</code></em>&#160;:</span></td>
225
 
<td> A <a href="libedataserver-e-util.html#tm"><span class="type">tm</span></a> to store the result in.
 
210
<td><p><span class="term"><em class="parameter"><code>result</code></em>&#160;:</span></p></td>
 
211
<td> A <a class="link" href="libedataserver-e-util.html#tm"><span class="type">tm</span></a> to store the result in.
226
212
</td>
227
213
</tr>
228
214
<tr>
229
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
230
 
<td> An <a href="libedataserver-e-time-utils.html#ETimeParseStatus"><span class="type">ETimeParseStatus</span></a> result code indicating whether
 
215
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
216
<td> An <a class="link" href="libedataserver-e-time-utils.html#ETimeParseStatus"><span class="type">ETimeParseStatus</span></a> result code indicating whether
231
217
<em class="parameter"><code>value</code></em> was an empty string, a valid date, or an invalid date.
232
218
</td>
233
219
</tr>
236
222
</div>
237
223
<hr>
238
224
<div class="refsect2" lang="en">
239
 
<a name="id2619103"></a><h3>
 
225
<a name="id2634179"></a><h3>
240
226
<a name="e-time-format-date-and-time"></a>e_time_format_date_and_time ()</h3>
241
 
<a class="indexterm" name="id2619114"></a><pre class="programlisting">void                e_time_format_date_and_time         (struct tm *date_tm,
242
 
                                                         <a
243
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
244
 
>gboolean</a> use_24_hour_format,
245
 
                                                         <a
246
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
247
 
>gboolean</a> show_midnight,
248
 
                                                         <a
249
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
250
 
>gboolean</a> show_zero_seconds,
 
227
<a class="indexterm" name="id2634191"></a><pre class="programlisting">void                e_time_format_date_and_time         (struct tm *date_tm,
 
228
                                                         gboolean use_24_hour_format,
 
229
                                                         gboolean show_midnight,
 
230
                                                         gboolean show_zero_seconds,
251
231
                                                         char *buffer,
252
232
                                                         int buffer_size);</pre>
253
233
<p>
254
234
Creates a string representation of the time value <em class="parameter"><code>date_tm</code></em> and
255
235
stores it in <em class="parameter"><code>buffer</code></em>.  <em class="parameter"><code>buffer_size</code></em> should be at least 64 to be
256
 
safe. If <em class="parameter"><code>show_midnight</code></em> is <a
257
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
258
 
><span class="type">FALSE</span></a>, and the time is midnight, then
 
236
safe. If <em class="parameter"><code>show_midnight</code></em> is <span class="type">FALSE</span>, and the time is midnight, then
259
237
only the date is stored in <em class="parameter"><code>buffer</code></em>. If <em class="parameter"><code>show_zero_seconds</code></em> is
260
 
<a
261
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
262
 
><span class="type">FALSE</span></a>, then if the time has zero seconds only the hour and minute
 
238
<span class="type">FALSE</span>, then if the time has zero seconds only the hour and minute
263
239
of the time are stored in <em class="parameter"><code>buffer</code></em>.</p>
264
240
<p>
265
241
 
268
244
<col align="left" valign="top">
269
245
<tbody>
270
246
<tr>
271
 
<td><span class="term"><em class="parameter"><code>date_tm</code></em>&#160;:</span></td>
272
 
<td> The <a href="libedataserver-e-util.html#tm"><span class="type">tm</span></a> to convert to a string.
273
 
</td>
274
 
</tr>
275
 
<tr>
276
 
<td><span class="term"><em class="parameter"><code>use_24_hour_format</code></em>&#160;:</span></td>
277
 
<td> A <a
278
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
279
 
><span class="type">gboolean</span></a>.
280
 
</td>
281
 
</tr>
282
 
<tr>
283
 
<td><span class="term"><em class="parameter"><code>show_midnight</code></em>&#160;:</span></td>
284
 
<td> A <a
285
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
286
 
><span class="type">gboolean</span></a>.
287
 
</td>
288
 
</tr>
289
 
<tr>
290
 
<td><span class="term"><em class="parameter"><code>show_zero_seconds</code></em>&#160;:</span></td>
291
 
<td> A <a
292
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
293
 
><span class="type">gboolean</span></a>.
294
 
</td>
295
 
</tr>
296
 
<tr>
297
 
<td><span class="term"><em class="parameter"><code>buffer</code></em>&#160;:</span></td>
 
247
<td><p><span class="term"><em class="parameter"><code>date_tm</code></em>&#160;:</span></p></td>
 
248
<td> The <a class="link" href="libedataserver-e-util.html#tm"><span class="type">tm</span></a> to convert to a string.
 
249
</td>
 
250
</tr>
 
251
<tr>
 
252
<td><p><span class="term"><em class="parameter"><code>use_24_hour_format</code></em>&#160;:</span></p></td>
 
253
<td> A <span class="type">gboolean</span>.
 
254
</td>
 
255
</tr>
 
256
<tr>
 
257
<td><p><span class="term"><em class="parameter"><code>show_midnight</code></em>&#160;:</span></p></td>
 
258
<td> A <span class="type">gboolean</span>.
 
259
</td>
 
260
</tr>
 
261
<tr>
 
262
<td><p><span class="term"><em class="parameter"><code>show_zero_seconds</code></em>&#160;:</span></p></td>
 
263
<td> A <span class="type">gboolean</span>.
 
264
</td>
 
265
</tr>
 
266
<tr>
 
267
<td><p><span class="term"><em class="parameter"><code>buffer</code></em>&#160;:</span></p></td>
298
268
<td> A <span class="type">char</span> buffer to store the time string in.
299
269
</td>
300
270
</tr>
301
271
<tr>
302
 
<td><span class="term"><em class="parameter"><code>buffer_size</code></em>&#160;:</span></td>
 
272
<td><p><span class="term"><em class="parameter"><code>buffer_size</code></em>&#160;:</span></p></td>
303
273
<td> The length of <em class="parameter"><code>buffer</code></em>.
304
274
</td>
305
275
</tr>
308
278
</div>
309
279
<hr>
310
280
<div class="refsect2" lang="en">
311
 
<a name="id2621562"></a><h3>
 
281
<a name="id2647896"></a><h3>
312
282
<a name="e-time-format-time"></a>e_time_format_time ()</h3>
313
 
<a class="indexterm" name="id2621575"></a><pre class="programlisting">void                e_time_format_time                  (struct tm *date_tm,
314
 
                                                         <a
315
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
316
 
>gboolean</a> use_24_hour_format,
317
 
                                                         <a
318
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
319
 
>gboolean</a> show_zero_seconds,
 
283
<a class="indexterm" name="id2647909"></a><pre class="programlisting">void                e_time_format_time                  (struct tm *date_tm,
 
284
                                                         gboolean use_24_hour_format,
 
285
                                                         gboolean show_zero_seconds,
320
286
                                                         char *buffer,
321
287
                                                         int buffer_size);</pre>
322
288
<p>
329
295
<col align="left" valign="top">
330
296
<tbody>
331
297
<tr>
332
 
<td><span class="term"><em class="parameter"><code>date_tm</code></em>&#160;:</span></td>
333
 
<td> The <a href="libedataserver-e-util.html#tm"><span class="type">tm</span></a> to convert to a string.
334
 
</td>
335
 
</tr>
336
 
<tr>
337
 
<td><span class="term"><em class="parameter"><code>use_24_hour_format</code></em>&#160;:</span></td>
338
 
<td> A <a
339
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
340
 
><span class="type">gboolean</span></a>.
341
 
</td>
342
 
</tr>
343
 
<tr>
344
 
<td><span class="term"><em class="parameter"><code>show_zero_seconds</code></em>&#160;:</span></td>
345
 
<td> A <a
346
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
347
 
><span class="type">gboolean</span></a>.
348
 
</td>
349
 
</tr>
350
 
<tr>
351
 
<td><span class="term"><em class="parameter"><code>buffer</code></em>&#160;:</span></td>
 
298
<td><p><span class="term"><em class="parameter"><code>date_tm</code></em>&#160;:</span></p></td>
 
299
<td> The <a class="link" href="libedataserver-e-util.html#tm"><span class="type">tm</span></a> to convert to a string.
 
300
</td>
 
301
</tr>
 
302
<tr>
 
303
<td><p><span class="term"><em class="parameter"><code>use_24_hour_format</code></em>&#160;:</span></p></td>
 
304
<td> A <span class="type">gboolean</span>.
 
305
</td>
 
306
</tr>
 
307
<tr>
 
308
<td><p><span class="term"><em class="parameter"><code>show_zero_seconds</code></em>&#160;:</span></p></td>
 
309
<td> A <span class="type">gboolean</span>.
 
310
</td>
 
311
</tr>
 
312
<tr>
 
313
<td><p><span class="term"><em class="parameter"><code>buffer</code></em>&#160;:</span></p></td>
352
314
<td> The <span class="type">char</span> buffer to store the result in.
353
315
</td>
354
316
</tr>
355
317
<tr>
356
 
<td><span class="term"><em class="parameter"><code>buffer_size</code></em>&#160;:</span></td>
 
318
<td><p><span class="term"><em class="parameter"><code>buffer_size</code></em>&#160;:</span></p></td>
357
319
<td> The length of <em class="parameter"><code>buffer</code></em>.
358
320
</td>
359
321
</tr>
362
324
</div>
363
325
<hr>
364
326
<div class="refsect2" lang="en">
365
 
<a name="id2621763"></a><h3>
 
327
<a name="id2648097"></a><h3>
366
328
<a name="e-mktime-utc"></a>e_mktime_utc ()</h3>
367
 
<a class="indexterm" name="id2621775"></a><pre class="programlisting">time_t              e_mktime_utc                        (struct tm *tm);</pre>
 
329
<a class="indexterm" name="id2648109"></a><pre class="programlisting">time_t              e_mktime_utc                        (struct tm *tm);</pre>
368
330
<p>
369
331
Like mktime(3), but assumes UTC instead of local timezone.</p>
370
332
<p>
374
336
<col align="left" valign="top">
375
337
<tbody>
376
338
<tr>
377
 
<td><span class="term"><em class="parameter"><code>tm</code></em>&#160;:</span></td>
378
 
<td> The <a href="libedataserver-e-util.html#tm"><span class="type">tm</span></a> to convert to a calendar time representation.
 
339
<td><p><span class="term"><em class="parameter"><code>tm</code></em>&#160;:</span></p></td>
 
340
<td> The <a class="link" href="libedataserver-e-util.html#tm"><span class="type">tm</span></a> to convert to a calendar time representation.
379
341
</td>
380
342
</tr>
381
343
<tr>
382
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
344
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
383
345
<td> The calendar time representation of <em class="parameter"><code>tm</code></em>.
384
346
</td>
385
347
</tr>
388
350
</div>
389
351
<hr>
390
352
<div class="refsect2" lang="en">
391
 
<a name="id2621850"></a><h3>
 
353
<a name="id2648184"></a><h3>
392
354
<a name="e-localtime-with-offset"></a>e_localtime_with_offset ()</h3>
393
 
<a class="indexterm" name="id2621861"></a><pre class="programlisting">void                e_localtime_with_offset             (time_t tt,
 
355
<a class="indexterm" name="id2648195"></a><pre class="programlisting">void                e_localtime_with_offset             (time_t tt,
394
356
                                                         struct tm *tm,
395
357
                                                         int *offset);</pre>
396
358
<p>
404
366
<col align="left" valign="top">
405
367
<tbody>
406
368
<tr>
407
 
<td><span class="term"><em class="parameter"><code>tt</code></em>&#160;:</span></td>
 
369
<td><p><span class="term"><em class="parameter"><code>tt</code></em>&#160;:</span></p></td>
408
370
<td> The <span class="type">time_t</span> to convert.
409
371
</td>
410
372
</tr>
411
373
<tr>
412
 
<td><span class="term"><em class="parameter"><code>tm</code></em>&#160;:</span></td>
413
 
<td> The <a href="libedataserver-e-util.html#tm"><span class="type">tm</span></a> to store the result in.
 
374
<td><p><span class="term"><em class="parameter"><code>tm</code></em>&#160;:</span></p></td>
 
375
<td> The <a class="link" href="libedataserver-e-util.html#tm"><span class="type">tm</span></a> to store the result in.
414
376
</td>
415
377
</tr>
416
378
<tr>
417
 
<td><span class="term"><em class="parameter"><code>offset</code></em>&#160;:</span></td>
 
379
<td><p><span class="term"><em class="parameter"><code>offset</code></em>&#160;:</span></p></td>
418
380
<td> The <span class="type">int</span> to store the offset in.
419
381
</td>
420
382
</tr>
423
385
</div>
424
386
</div>
425
387
<div class="refsect1" lang="en">
426
 
<a name="id2623371"></a><div class="refsect2" lang="en"><a name="id2623372"></a></div>
 
388
<a name="id2649705"></a><div class="refsect2" lang="en"><a name="id2649706"></a></div>
427
389
<hr>
428
 
<div class="refsect2" lang="en"><a name="id2623373"></a></div>
 
390
<div class="refsect2" lang="en"><a name="id2649708"></a></div>
429
391
</div>
430
392
</div>
431
393
</body>