~ubuntu-branches/debian/squeeze/glib2.0/squeeze

« back to all changes in this revision

Viewing changes to docs/reference/glib/html/glib-Date-and-Time-Functions.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2009-06-27 09:56:08 UTC
  • mfrom: (1.4.6 upstream)
  • Revision ID: james.westby@ubuntu.com-20090627095608-pi9244lmozmr2cm6
Tags: 2.20.4-1
New upstream bugfix release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>Date and Time Functions</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
7
7
<link rel="home" href="index.html" title="GLib Reference Manual">
8
8
<link rel="up" href="glib-utilities.html" title="GLib Utilities">
9
9
<link rel="prev" href="glib-I18N.html" title="Internationalization">
44
44
                <a href="#glib-Date-and-Time-Functions.description" class="shortcut">Description</a>
45
45
</td></tr>
46
46
</table>
47
 
<div class="refentry" lang="en">
 
47
<div class="refentry" title="Date and Time Functions">
48
48
<a name="glib-Date-and-Time-Functions"></a><div class="titlepage"></div>
49
49
<div class="refnamediv"><table width="100%"><tr>
50
50
<td valign="top">
53
53
</td>
54
54
<td valign="top" align="right"></td>
55
55
</tr></table></div>
56
 
<div class="refsynopsisdiv">
 
56
<div class="refsynopsisdiv" title="Synopsis">
57
57
<a name="glib-Date-and-Time-Functions.synopsis"></a><h2>Synopsis</h2>
58
58
<pre class="synopsis">
59
59
 
169
169
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-weekday" title="g_date_valid_weekday ()">g_date_valid_weekday</a>                (<a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday">GDateWeekday</a> weekday);
170
170
</pre>
171
171
</div>
172
 
<div class="refsect1" lang="en">
 
172
<div class="refsect1" title="Description">
173
173
<a name="glib-Date-and-Time-Functions.description"></a><h2>Description</h2>
174
174
<p>
175
175
The <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> data structure represents a day between January 1, Year 1,
220
220
a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> with <a class="link" href="glib-Date-and-Time-Functions.html#g-get-current-time" title="g_get_current_time ()"><code class="function">g_get_current_time()</code></a>.
221
221
</p>
222
222
</div>
223
 
<div class="refsect1" lang="en">
 
223
<div class="refsect1" title="Details">
224
224
<a name="glib-Date-and-Time-Functions.details"></a><h2>Details</h2>
225
 
<div class="refsect2" lang="en">
 
225
<div class="refsect2" title="G_USEC_PER_SEC">
226
226
<a name="G-USEC-PER-SEC--CAPS"></a><h3>G_USEC_PER_SEC</h3>
227
227
<pre class="programlisting">#define G_USEC_PER_SEC 1000000
228
228
</pre>
232
232
</p>
233
233
</div>
234
234
<hr>
235
 
<div class="refsect2" lang="en">
 
235
<div class="refsect2" title="GTimeVal">
236
236
<a name="GTimeVal"></a><h3>GTimeVal</h3>
237
237
<pre class="programlisting">typedef struct {
238
238
  glong tv_sec;
261
261
</table></div>
262
262
</div>
263
263
<hr>
264
 
<div class="refsect2" lang="en">
 
264
<div class="refsect2" title="g_get_current_time ()">
265
265
<a name="g-get-current-time"></a><h3>g_get_current_time ()</h3>
266
266
<pre class="programlisting">void                g_get_current_time                  (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *result);</pre>
267
267
<p>
278
278
</table></div>
279
279
</div>
280
280
<hr>
281
 
<div class="refsect2" lang="en">
 
281
<div class="refsect2" title="g_usleep ()">
282
282
<a name="g-usleep"></a><h3>g_usleep ()</h3>
283
283
<pre class="programlisting">void                g_usleep                            (<a class="link" href="glib-Basic-Types.html#gulong" title="gulong">gulong</a> microseconds);</pre>
284
284
<p>
298
298
</table></div>
299
299
</div>
300
300
<hr>
301
 
<div class="refsect2" lang="en">
 
301
<div class="refsect2" title="g_time_val_add ()">
302
302
<a name="g-time-val-add"></a><h3>g_time_val_add ()</h3>
303
303
<pre class="programlisting">void                g_time_val_add                      (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *time_,
304
304
                                                         <a class="link" href="glib-Basic-Types.html#glong" title="glong">glong</a> microseconds);</pre>
324
324
</table></div>
325
325
</div>
326
326
<hr>
327
 
<div class="refsect2" lang="en">
 
327
<div class="refsect2" title="g_time_val_from_iso8601 ()">
328
328
<a name="g-time-val-from-iso8601"></a><h3>g_time_val_from_iso8601 ()</h3>
329
329
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_time_val_from_iso8601             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *iso_date,
330
330
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *time_);</pre>
357
357
<p class="since">Since 2.12</p>
358
358
</div>
359
359
<hr>
360
 
<div class="refsect2" lang="en">
 
360
<div class="refsect2" title="g_time_val_to_iso8601 ()">
361
361
<a name="g-time-val-to-iso8601"></a><h3>g_time_val_to_iso8601 ()</h3>
362
362
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a>*              g_time_val_to_iso8601               (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *time_);</pre>
363
363
<p>
384
384
<p class="since">Since 2.12</p>
385
385
</div>
386
386
<hr>
387
 
<div class="refsect2" lang="en">
 
387
<div class="refsect2" title="GDate">
388
388
<a name="GDate"></a><h3>GDate</h3>
389
389
<pre class="programlisting">typedef struct {
390
390
  guint julian_days : 32; /* julian days representation - we use a
452
452
</table></div>
453
453
</div>
454
454
<hr>
455
 
<div class="refsect2" lang="en">
 
455
<div class="refsect2" title="GTime">
456
456
<a name="GTime"></a><h3>GTime</h3>
457
457
<pre class="programlisting">typedef gint32  GTime;
458
458
</pre>
479
479
</p>
480
480
</div>
481
481
<hr>
482
 
<div class="refsect2" lang="en">
 
482
<div class="refsect2" title="enum GDateDMY">
483
483
<a name="GDateDMY"></a><h3>enum GDateDMY</h3>
484
484
<pre class="programlisting">typedef enum
485
485
{
514
514
</table></div>
515
515
</div>
516
516
<hr>
517
 
<div class="refsect2" lang="en">
 
517
<div class="refsect2" title="GDateDay">
518
518
<a name="GDateDay"></a><h3>GDateDay</h3>
519
519
<pre class="programlisting">typedef guint8  GDateDay;   /* day of the month */
520
520
</pre>
524
524
</p>
525
525
</div>
526
526
<hr>
527
 
<div class="refsect2" lang="en">
 
527
<div class="refsect2" title="enum GDateMonth">
528
528
<a name="GDateMonth"></a><h3>enum GDateMonth</h3>
529
529
<pre class="programlisting">typedef enum
530
530
{
619
619
</table></div>
620
620
</div>
621
621
<hr>
622
 
<div class="refsect2" lang="en">
 
622
<div class="refsect2" title="GDateYear">
623
623
<a name="GDateYear"></a><h3>GDateYear</h3>
624
624
<pre class="programlisting">typedef guint16 GDateYear;
625
625
</pre>
630
630
</p>
631
631
</div>
632
632
<hr>
633
 
<div class="refsect2" lang="en">
 
633
<div class="refsect2" title="enum GDateWeekday">
634
634
<a name="GDateWeekday"></a><h3>enum GDateWeekday</h3>
635
635
<pre class="programlisting">typedef enum
636
636
{
695
695
</table></div>
696
696
</div>
697
697
<hr>
698
 
<div class="refsect2" lang="en">
 
698
<div class="refsect2" title="G_DATE_BAD_DAY">
699
699
<a name="G-DATE-BAD-DAY--CAPS"></a><h3>G_DATE_BAD_DAY</h3>
700
700
<pre class="programlisting">#define G_DATE_BAD_DAY    0U
701
701
</pre>
704
704
</p>
705
705
</div>
706
706
<hr>
707
 
<div class="refsect2" lang="en">
 
707
<div class="refsect2" title="G_DATE_BAD_JULIAN">
708
708
<a name="G-DATE-BAD-JULIAN--CAPS"></a><h3>G_DATE_BAD_JULIAN</h3>
709
709
<pre class="programlisting">#define G_DATE_BAD_JULIAN 0U
710
710
</pre>
713
713
</p>
714
714
</div>
715
715
<hr>
716
 
<div class="refsect2" lang="en">
 
716
<div class="refsect2" title="G_DATE_BAD_YEAR">
717
717
<a name="G-DATE-BAD-YEAR--CAPS"></a><h3>G_DATE_BAD_YEAR</h3>
718
718
<pre class="programlisting">#define G_DATE_BAD_YEAR   0U
719
719
</pre>
722
722
</p>
723
723
</div>
724
724
<hr>
725
 
<div class="refsect2" lang="en">
 
725
<div class="refsect2" title="g_date_new ()">
726
726
<a name="g-date-new"></a><h3>g_date_new ()</h3>
727
727
<pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a>*              g_date_new                          (void);</pre>
728
728
<p>
740
740
</table></div>
741
741
</div>
742
742
<hr>
743
 
<div class="refsect2" lang="en">
 
743
<div class="refsect2" title="g_date_new_dmy ()">
744
744
<a name="g-date-new-dmy"></a><h3>g_date_new_dmy ()</h3>
745
745
<pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a>*              g_date_new_dmy                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a> day,
746
746
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month,
777
777
</table></div>
778
778
</div>
779
779
<hr>
780
 
<div class="refsect2" lang="en">
 
780
<div class="refsect2" title="g_date_new_julian ()">
781
781
<a name="g-date-new-julian"></a><h3>g_date_new_julian ()</h3>
782
782
<pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a>*              g_date_new_julian                   (<a class="link" href="glib-Basic-Types.html#guint32" title="guint32">guint32</a> julian_day);</pre>
783
783
<p>
802
802
</table></div>
803
803
</div>
804
804
<hr>
805
 
<div class="refsect2" lang="en">
 
805
<div class="refsect2" title="g_date_clear ()">
806
806
<a name="g-date-clear"></a><h3>g_date_clear ()</h3>
807
807
<pre class="programlisting">void                g_date_clear                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
808
808
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_dates);</pre>
829
829
</table></div>
830
830
</div>
831
831
<hr>
832
 
<div class="refsect2" lang="en">
 
832
<div class="refsect2" title="g_date_free ()">
833
833
<a name="g-date-free"></a><h3>g_date_free ()</h3>
834
834
<pre class="programlisting">void                g_date_free                         (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
835
835
<p>
845
845
</table></div>
846
846
</div>
847
847
<hr>
848
 
<div class="refsect2" lang="en">
 
848
<div class="refsect2" title="g_date_set_day ()">
849
849
<a name="g-date-set-day"></a><h3>g_date_set_day ()</h3>
850
850
<pre class="programlisting">void                g_date_set_day                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
851
851
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a> day);</pre>
870
870
</table></div>
871
871
</div>
872
872
<hr>
873
 
<div class="refsect2" lang="en">
 
873
<div class="refsect2" title="g_date_set_month ()">
874
874
<a name="g-date-set-month"></a><h3>g_date_set_month ()</h3>
875
875
<pre class="programlisting">void                g_date_set_month                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
876
876
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month);</pre>
895
895
</table></div>
896
896
</div>
897
897
<hr>
898
 
<div class="refsect2" lang="en">
 
898
<div class="refsect2" title="g_date_set_year ()">
899
899
<a name="g-date-set-year"></a><h3>g_date_set_year ()</h3>
900
900
<pre class="programlisting">void                g_date_set_year                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
901
901
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);</pre>
920
920
</table></div>
921
921
</div>
922
922
<hr>
923
 
<div class="refsect2" lang="en">
 
923
<div class="refsect2" title="g_date_set_dmy ()">
924
924
<a name="g-date-set-dmy"></a><h3>g_date_set_dmy ()</h3>
925
925
<pre class="programlisting">void                g_date_set_dmy                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
926
926
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a> day,
958
958
</table></div>
959
959
</div>
960
960
<hr>
961
 
<div class="refsect2" lang="en">
 
961
<div class="refsect2" title="g_date_set_julian ()">
962
962
<a name="g-date-set-julian"></a><h3>g_date_set_julian ()</h3>
963
963
<pre class="programlisting">void                g_date_set_julian                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
964
964
                                                         <a class="link" href="glib-Basic-Types.html#guint32" title="guint32">guint32</a> julian_date);</pre>
982
982
</table></div>
983
983
</div>
984
984
<hr>
985
 
<div class="refsect2" lang="en">
 
985
<div class="refsect2" title="g_date_set_time ()">
986
986
<a name="g-date-set-time"></a><h3>g_date_set_time ()</h3>
987
987
<pre class="programlisting">void                g_date_set_time                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
988
988
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime">GTime</a> time_);</pre>
989
 
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
989
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
990
990
<h3 class="title">Warning</h3>
991
991
<p><code class="literal">g_date_set_time</code> is deprecated and should not be used in newly-written code.</p>
992
992
</div>
1015
1015
</table></div>
1016
1016
</div>
1017
1017
<hr>
1018
 
<div class="refsect2" lang="en">
 
1018
<div class="refsect2" title="g_date_set_time_t ()">
1019
1019
<a name="g-date-set-time-t"></a><h3>g_date_set_time_t ()</h3>
1020
1020
<pre class="programlisting">void                g_date_set_time_t                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
1021
1021
                                                         time_t timet);</pre>
1050
1050
<p class="since">Since 2.10</p>
1051
1051
</div>
1052
1052
<hr>
1053
 
<div class="refsect2" lang="en">
 
1053
<div class="refsect2" title="g_date_set_time_val ()">
1054
1054
<a name="g-date-set-time-val"></a><h3>g_date_set_time_val ()</h3>
1055
1055
<pre class="programlisting">void                g_date_set_time_val                 (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
1056
1056
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *timeval);</pre>
1078
1078
<p class="since">Since 2.10</p>
1079
1079
</div>
1080
1080
<hr>
1081
 
<div class="refsect2" lang="en">
 
1081
<div class="refsect2" title="g_date_set_parse ()">
1082
1082
<a name="g-date-set-parse"></a><h3>g_date_set_parse ()</h3>
1083
1083
<pre class="programlisting">void                g_date_set_parse                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
1084
1084
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *str);</pre>
1113
1113
</table></div>
1114
1114
</div>
1115
1115
<hr>
1116
 
<div class="refsect2" lang="en">
 
1116
<div class="refsect2" title="g_date_add_days ()">
1117
1117
<a name="g-date-add-days"></a><h3>g_date_add_days ()</h3>
1118
1118
<pre class="programlisting">void                g_date_add_days                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
1119
1119
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_days);</pre>
1138
1138
</table></div>
1139
1139
</div>
1140
1140
<hr>
1141
 
<div class="refsect2" lang="en">
 
1141
<div class="refsect2" title="g_date_subtract_days ()">
1142
1142
<a name="g-date-subtract-days"></a><h3>g_date_subtract_days ()</h3>
1143
1143
<pre class="programlisting">void                g_date_subtract_days                (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
1144
1144
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_days);</pre>
1163
1163
</table></div>
1164
1164
</div>
1165
1165
<hr>
1166
 
<div class="refsect2" lang="en">
 
1166
<div class="refsect2" title="g_date_add_months ()">
1167
1167
<a name="g-date-add-months"></a><h3>g_date_add_months ()</h3>
1168
1168
<pre class="programlisting">void                g_date_add_months                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
1169
1169
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_months);</pre>
1190
1190
</table></div>
1191
1191
</div>
1192
1192
<hr>
1193
 
<div class="refsect2" lang="en">
 
1193
<div class="refsect2" title="g_date_subtract_months ()">
1194
1194
<a name="g-date-subtract-months"></a><h3>g_date_subtract_months ()</h3>
1195
1195
<pre class="programlisting">void                g_date_subtract_months              (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
1196
1196
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_months);</pre>
1216
1216
</table></div>
1217
1217
</div>
1218
1218
<hr>
1219
 
<div class="refsect2" lang="en">
 
1219
<div class="refsect2" title="g_date_add_years ()">
1220
1220
<a name="g-date-add-years"></a><h3>g_date_add_years ()</h3>
1221
1221
<pre class="programlisting">void                g_date_add_years                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
1222
1222
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_years);</pre>
1242
1242
</table></div>
1243
1243
</div>
1244
1244
<hr>
1245
 
<div class="refsect2" lang="en">
 
1245
<div class="refsect2" title="g_date_subtract_years ()">
1246
1246
<a name="g-date-subtract-years"></a><h3>g_date_subtract_years ()</h3>
1247
1247
<pre class="programlisting">void                g_date_subtract_years               (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
1248
1248
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_years);</pre>
1269
1269
</table></div>
1270
1270
</div>
1271
1271
<hr>
1272
 
<div class="refsect2" lang="en">
 
1272
<div class="refsect2" title="g_date_days_between ()">
1273
1273
<a name="g-date-days-between"></a><h3>g_date_days_between ()</h3>
1274
1274
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                g_date_days_between                 (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date1,
1275
1275
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date2);</pre>
1300
1300
</table></div>
1301
1301
</div>
1302
1302
<hr>
1303
 
<div class="refsect2" lang="en">
 
1303
<div class="refsect2" title="g_date_compare ()">
1304
1304
<a name="g-date-compare"></a><h3>g_date_compare ()</h3>
1305
1305
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                g_date_compare                      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *lhs,
1306
1306
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *rhs);</pre>
1331
1331
</table></div>
1332
1332
</div>
1333
1333
<hr>
1334
 
<div class="refsect2" lang="en">
 
1334
<div class="refsect2" title="g_date_clamp ()">
1335
1335
<a name="g-date-clamp"></a><h3>g_date_clamp ()</h3>
1336
1336
<pre class="programlisting">void                g_date_clamp                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
1337
1337
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *min_date,
1365
1365
</table></div>
1366
1366
</div>
1367
1367
<hr>
1368
 
<div class="refsect2" lang="en">
 
1368
<div class="refsect2" title="g_date_order ()">
1369
1369
<a name="g-date-order"></a><h3>g_date_order ()</h3>
1370
1370
<pre class="programlisting">void                g_date_order                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date1,
1371
1371
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date2);</pre>
1390
1390
</table></div>
1391
1391
</div>
1392
1392
<hr>
1393
 
<div class="refsect2" lang="en">
 
1393
<div class="refsect2" title="g_date_get_day ()">
1394
1394
<a name="g-date-get-day"></a><h3>g_date_get_day ()</h3>
1395
1395
<pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a>            g_date_get_day                      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1396
1396
<p>
1413
1413
</table></div>
1414
1414
</div>
1415
1415
<hr>
1416
 
<div class="refsect2" lang="en">
 
1416
<div class="refsect2" title="g_date_get_month ()">
1417
1417
<a name="g-date-get-month"></a><h3>g_date_get_month ()</h3>
1418
1418
<pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a>          g_date_get_month                    (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1419
1419
<p>
1436
1436
</table></div>
1437
1437
</div>
1438
1438
<hr>
1439
 
<div class="refsect2" lang="en">
 
1439
<div class="refsect2" title="g_date_get_year ()">
1440
1440
<a name="g-date-get-year"></a><h3>g_date_get_year ()</h3>
1441
1441
<pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a>           g_date_get_year                     (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1442
1442
<p>
1459
1459
</table></div>
1460
1460
</div>
1461
1461
<hr>
1462
 
<div class="refsect2" lang="en">
 
1462
<div class="refsect2" title="g_date_get_julian ()">
1463
1463
<a name="g-date-get-julian"></a><h3>g_date_get_julian ()</h3>
1464
1464
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint32" title="guint32">guint32</a>             g_date_get_julian                   (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1465
1465
<p>
1485
1485
</table></div>
1486
1486
</div>
1487
1487
<hr>
1488
 
<div class="refsect2" lang="en">
 
1488
<div class="refsect2" title="g_date_get_weekday ()">
1489
1489
<a name="g-date-get-weekday"></a><h3>g_date_get_weekday ()</h3>
1490
1490
<pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday">GDateWeekday</a>        g_date_get_weekday                  (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1491
1491
<p>
1508
1508
</table></div>
1509
1509
</div>
1510
1510
<hr>
1511
 
<div class="refsect2" lang="en">
 
1511
<div class="refsect2" title="g_date_get_day_of_year ()">
1512
1512
<a name="g-date-get-day-of-year"></a><h3>g_date_get_day_of_year ()</h3>
1513
1513
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a>               g_date_get_day_of_year              (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1514
1514
<p>
1532
1532
</table></div>
1533
1533
</div>
1534
1534
<hr>
1535
 
<div class="refsect2" lang="en">
 
1535
<div class="refsect2" title="g_date_get_days_in_month ()">
1536
1536
<a name="g-date-get-days-in-month"></a><h3>g_date_get_days_in_month ()</h3>
1537
1537
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint8" title="guint8">guint8</a>              g_date_get_days_in_month            (<a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month,
1538
1538
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);</pre>
1561
1561
</table></div>
1562
1562
</div>
1563
1563
<hr>
1564
 
<div class="refsect2" lang="en">
 
1564
<div class="refsect2" title="g_date_is_first_of_month ()">
1565
1565
<a name="g-date-is-first-of-month"></a><h3>g_date_is_first_of_month ()</h3>
1566
1566
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_date_is_first_of_month            (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1567
1567
<p>
1584
1584
</table></div>
1585
1585
</div>
1586
1586
<hr>
1587
 
<div class="refsect2" lang="en">
 
1587
<div class="refsect2" title="g_date_is_last_of_month ()">
1588
1588
<a name="g-date-is-last-of-month"></a><h3>g_date_is_last_of_month ()</h3>
1589
1589
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_date_is_last_of_month             (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1590
1590
<p>
1607
1607
</table></div>
1608
1608
</div>
1609
1609
<hr>
1610
 
<div class="refsect2" lang="en">
 
1610
<div class="refsect2" title="g_date_is_leap_year ()">
1611
1611
<a name="g-date-is-leap-year"></a><h3>g_date_is_leap_year ()</h3>
1612
1612
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_date_is_leap_year                 (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);</pre>
1613
1613
<p>
1614
 
Returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the year is a leap year.<sup>[<a name="id673493" href="#ftn.id673493" class="footnote">4</a>]</sup>
 
1614
Returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the year is a leap year.<sup>[<a name="id734694" href="#ftn.id734694" class="footnote">4</a>]</sup>
1615
1615
</p>
1616
1616
<div class="variablelist"><table border="0">
1617
1617
<col align="left" valign="top">
1630
1630
</table></div>
1631
1631
</div>
1632
1632
<hr>
1633
 
<div class="refsect2" lang="en">
 
1633
<div class="refsect2" title="g_date_get_monday_week_of_year ()">
1634
1634
<a name="g-date-get-monday-week-of-year"></a><h3>g_date_get_monday_week_of_year ()</h3>
1635
1635
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a>               g_date_get_monday_week_of_year      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1636
1636
<p>
1655
1655
</table></div>
1656
1656
</div>
1657
1657
<hr>
1658
 
<div class="refsect2" lang="en">
 
1658
<div class="refsect2" title="g_date_get_monday_weeks_in_year ()">
1659
1659
<a name="g-date-get-monday-weeks-in-year"></a><h3>g_date_get_monday_weeks_in_year ()</h3>
1660
1660
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint8" title="guint8">guint8</a>              g_date_get_monday_weeks_in_year     (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);</pre>
1661
1661
<p>
1683
1683
</table></div>
1684
1684
</div>
1685
1685
<hr>
1686
 
<div class="refsect2" lang="en">
 
1686
<div class="refsect2" title="g_date_get_sunday_week_of_year ()">
1687
1687
<a name="g-date-get-sunday-week-of-year"></a><h3>g_date_get_sunday_week_of_year ()</h3>
1688
1688
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a>               g_date_get_sunday_week_of_year      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1689
1689
<p>
1708
1708
</table></div>
1709
1709
</div>
1710
1710
<hr>
1711
 
<div class="refsect2" lang="en">
 
1711
<div class="refsect2" title="g_date_get_sunday_weeks_in_year ()">
1712
1712
<a name="g-date-get-sunday-weeks-in-year"></a><h3>g_date_get_sunday_weeks_in_year ()</h3>
1713
1713
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint8" title="guint8">guint8</a>              g_date_get_sunday_weeks_in_year     (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);</pre>
1714
1714
<p>
1736
1736
</table></div>
1737
1737
</div>
1738
1738
<hr>
1739
 
<div class="refsect2" lang="en">
 
1739
<div class="refsect2" title="g_date_get_iso8601_week_of_year ()">
1740
1740
<a name="g-date-get-iso8601-week-of-year"></a><h3>g_date_get_iso8601_week_of_year ()</h3>
1741
1741
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a>               g_date_get_iso8601_week_of_year     (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1742
1742
<p>
1763
1763
<p class="since">Since 2.6</p>
1764
1764
</div>
1765
1765
<hr>
1766
 
<div class="refsect2" lang="en">
 
1766
<div class="refsect2" title="g_date_strftime ()">
1767
1767
<a name="g-date-strftime"></a><h3>g_date_strftime ()</h3>
1768
1768
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize" title="gsize">gsize</a>               g_date_strftime                     (<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *s,
1769
1769
                                                         <a class="link" href="glib-Basic-Types.html#gsize" title="gsize">gsize</a> slen,
1815
1815
</table></div>
1816
1816
</div>
1817
1817
<hr>
1818
 
<div class="refsect2" lang="en">
 
1818
<div class="refsect2" title="g_date_to_struct_tm ()">
1819
1819
<a name="g-date-to-struct-tm"></a><h3>g_date_to_struct_tm ()</h3>
1820
1820
<pre class="programlisting">void                g_date_to_struct_tm                 (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
1821
1821
                                                         struct tm *tm);</pre>
1842
1842
</table></div>
1843
1843
</div>
1844
1844
<hr>
1845
 
<div class="refsect2" lang="en">
 
1845
<div class="refsect2" title="g_date_valid ()">
1846
1846
<a name="g-date-valid"></a><h3>g_date_valid ()</h3>
1847
1847
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_date_valid                        (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1848
1848
<p>
1867
1867
</table></div>
1868
1868
</div>
1869
1869
<hr>
1870
 
<div class="refsect2" lang="en">
 
1870
<div class="refsect2" title="g_date_valid_day ()">
1871
1871
<a name="g-date-valid-day"></a><h3>g_date_valid_day ()</h3>
1872
1872
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_date_valid_day                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a> day);</pre>
1873
1873
<p>
1891
1891
</table></div>
1892
1892
</div>
1893
1893
<hr>
1894
 
<div class="refsect2" lang="en">
 
1894
<div class="refsect2" title="g_date_valid_month ()">
1895
1895
<a name="g-date-valid-month"></a><h3>g_date_valid_month ()</h3>
1896
1896
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_date_valid_month                  (<a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month);</pre>
1897
1897
<p>
1915
1915
</table></div>
1916
1916
</div>
1917
1917
<hr>
1918
 
<div class="refsect2" lang="en">
 
1918
<div class="refsect2" title="g_date_valid_year ()">
1919
1919
<a name="g-date-valid-year"></a><h3>g_date_valid_year ()</h3>
1920
1920
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_date_valid_year                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);</pre>
1921
1921
<p>
1939
1939
</table></div>
1940
1940
</div>
1941
1941
<hr>
1942
 
<div class="refsect2" lang="en">
 
1942
<div class="refsect2" title="g_date_valid_dmy ()">
1943
1943
<a name="g-date-valid-dmy"></a><h3>g_date_valid_dmy ()</h3>
1944
1944
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_date_valid_dmy                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a> day,
1945
1945
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month,
1976
1976
</table></div>
1977
1977
</div>
1978
1978
<hr>
1979
 
<div class="refsect2" lang="en">
 
1979
<div class="refsect2" title="g_date_valid_julian ()">
1980
1980
<a name="g-date-valid-julian"></a><h3>g_date_valid_julian ()</h3>
1981
1981
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_date_valid_julian                 (<a class="link" href="glib-Basic-Types.html#guint32" title="guint32">guint32</a> julian_date);</pre>
1982
1982
<p>
2000
2000
</table></div>
2001
2001
</div>
2002
2002
<hr>
2003
 
<div class="refsect2" lang="en">
 
2003
<div class="refsect2" title="g_date_valid_weekday ()">
2004
2004
<a name="g-date-valid-weekday"></a><h3>g_date_valid_weekday ()</h3>
2005
2005
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            g_date_valid_weekday                (<a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday">GDateWeekday</a> weekday);</pre>
2006
2006
<p>
2026
2026
</div>
2027
2027
<div class="footnotes">
2028
2028
<br><hr width="100" align="left">
2029
 
<div class="footnote"><p><sup>[<a name="ftn.id673493" href="#id673493" class="para">4</a>] </sup>
 
2029
<div class="footnote"><p><sup>[<a name="ftn.id734694" href="#id734694" class="para">4</a>] </sup>
2030
2030
For the purposes of this function, leap year is every year divisible by
2031
2031
4 unless that year is divisible by 100. If it is divisible by 100 it would
2032
2032
be a leap year only if that year is also divisible by 400.</p></div>