← Back to branch summary

~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): Gustavo Noronha Silva
  • Date: 2009-02-15 13:00:43 UTC
  • mfrom: (1.3.1 upstream) (69.1.10 intrepid)
  • Revision ID: james.westby@ubuntu.com-20090215130043-q47fbt3owmt42m2f
Tags: 2.18.4-2
* Release to unstable
* debian/rules:
- bump SHVER, since we are already forcing a 2.18.0 dependecy on the
  symbols introduced in the development versions
* debian/control.in:
- added Homepage and Vcs-* control fields

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/glib/html/glib-Date-and-Time-Functions.html
1
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
2
<html>
3
3
<head>
4
 
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 
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.73.2">
7
 
<link rel="start" href="index.html" title="GLib Reference Manual">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
 
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">
10
10
<link rel="next" href="glib-Random-Numbers.html" title="Random Numbers">
11
 
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="glib.html" title="GLib Overview">
14
14
<link rel="chapter" href="glib-fundamentals.html" title="GLib Fundamentals">
26
26
<link rel="index" href="ix08.html" title="Index of new symbols in 2.12">
27
27
<link rel="index" href="ix09.html" title="Index of new symbols in 2.14">
28
28
<link rel="index" href="ix10.html" title="Index of new symbols in 2.16">
 
29
<link rel="index" href="ix11.html" title="Index of new symbols in 2.18">
29
30
</head>
30
31
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
31
32
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
36
37
<th width="100%" align="center">GLib Reference Manual</th>
37
38
<td><a accesskey="n" href="glib-Random-Numbers.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
38
39
</tr>
39
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3090178" class="shortcut">Top</a>
40
 
                  &#160;|&#160;
41
 
                  <a href="#id3091764" class="shortcut">Description</a></nobr></td></tr>
 
40
<tr><td colspan="5" class="shortcuts">
 
41
<a href="#glib-Date-and-Time-Functions.synopsis" class="shortcut">Top</a>
 
42
                 | 
 
43
                <a href="#glib-Date-and-Time-Functions.description" class="shortcut">Description</a>
 
44
</td></tr>
42
45
</table>
43
46
<div class="refentry" lang="en">
44
47
<a name="glib-Date-and-Time-Functions"></a><div class="titlepage"></div>
45
48
<div class="refnamediv"><table width="100%"><tr>
46
49
<td valign="top">
47
 
<h2>
48
 
<a name="id3090178"></a><span class="refentrytitle">Date and Time Functions</span>
49
 
</h2>
50
 
<p>Date and Time Functions &#8212; calendrical calculations and miscellaneous time stuff</p>
 
50
<h2><span class="refentrytitle"><a name="glib-Date-and-Time-Functions.top_of_page"></a>Date and Time Functions</span></h2>
 
51
<p>Date and Time Functions — calendrical calculations and miscellaneous time stuff</p>
51
52
</td>
52
53
<td valign="top" align="right"></td>
53
54
</tr></table></div>
54
55
<div class="refsynopsisdiv">
55
 
<h2>Synopsis</h2>
 
56
<a name="glib-Date-and-Time-Functions.synopsis"></a><h2>Synopsis</h2>
56
57
<pre class="synopsis">
57
58
 
58
59
#include &lt;glib.h&gt;
59
60
 
60
 
 
61
 
#define             <a class="link" href="glib-Date-and-Time-Functions.html#G-USEC-PER-SEC:CAPS">G_USEC_PER_SEC</a>
62
 
                    <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal">GTimeVal</a>;
63
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-get-current-time">g_get_current_time</a>                  (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal">GTimeVal</a> *result);
64
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-usleep">g_usleep</a>                            (<a class="link" href="glib-Basic-Types.html#gulong">gulong</a> microseconds);
65
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-time-val-add">g_time_val_add</a>                      (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal">GTimeVal</a> *time_,
66
 
                                                         <a class="link" href="glib-Basic-Types.html#glong">glong</a> microseconds);
67
 
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-time-val-from-iso8601">g_time_val_from_iso8601</a>             (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *iso_date,
68
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal">GTimeVal</a> *time_);
69
 
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              <a class="link" href="glib-Date-and-Time-Functions.html#g-time-val-to-iso8601">g_time_val_to_iso8601</a>               (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal">GTimeVal</a> *time_);
70
 
 
71
 
                    <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a>;
72
 
typedef             <a class="link" href="glib-Date-and-Time-Functions.html#GTime">GTime</a>;
73
 
enum                <a class="link" href="glib-Date-and-Time-Functions.html#GDateDMY">GDateDMY</a>;
74
 
typedef             <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a>;
75
 
enum                <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a>;
76
 
typedef             <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a>;
77
 
enum                <a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday">GDateWeekday</a>;
78
 
 
79
 
#define             <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-DAY:CAPS">G_DATE_BAD_DAY</a>
80
 
#define             <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-JULIAN:CAPS">G_DATE_BAD_JULIAN</a>
81
 
#define             <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-YEAR:CAPS">G_DATE_BAD_YEAR</a>
82
 
 
83
 
<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a>*              <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new">g_date_new</a>                          (void);
84
 
<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a>*              <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new-dmy">g_date_new_dmy</a>                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a> day,
85
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a> month,
86
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);
87
 
<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a>*              <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new-julian">g_date_new_julian</a>                   (<a class="link" href="glib-Basic-Types.html#guint32">guint32</a> julian_day);
88
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear">g_date_clear</a>                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
89
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_dates);
90
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-free">g_date_free</a>                         (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
91
 
 
92
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-day">g_date_set_day</a>                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
93
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a> day);
94
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-month">g_date_set_month</a>                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
95
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a> month);
96
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-year">g_date_set_year</a>                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
97
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);
98
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-dmy">g_date_set_dmy</a>                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
99
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a> day,
100
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a> month,
101
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> y);
102
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-julian">g_date_set_julian</a>                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
103
 
                                                         <a class="link" href="glib-Basic-Types.html#guint32">guint32</a> julian_date);
104
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-time">g_date_set_time</a>                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
105
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTime">GTime</a> time_);
106
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-time-t">g_date_set_time_t</a>                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
 
61
#define             <a class="link" href="glib-Date-and-Time-Functions.html#G-USEC-PER-SEC--CAPS" title="G_USEC_PER_SEC">G_USEC_PER_SEC</a>
 
62
                    <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a>;
 
63
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-get-current-time" title="g_get_current_time ()">g_get_current_time</a>                  (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *result);
 
64
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-usleep" title="g_usleep ()">g_usleep</a>                            (<a class="link" href="glib-Basic-Types.html#gulong" title="gulong">gulong</a> microseconds);
 
65
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-time-val-add" title="g_time_val_add ()">g_time_val_add</a>                      (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *time_,
 
66
                                                         <a class="link" href="glib-Basic-Types.html#glong" title="glong">glong</a> microseconds);
 
67
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-time-val-from-iso8601" title="g_time_val_from_iso8601 ()">g_time_val_from_iso8601</a>             (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *iso_date,
 
68
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *time_);
 
69
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a>*              <a class="link" href="glib-Date-and-Time-Functions.html#g-time-val-to-iso8601" title="g_time_val_to_iso8601 ()">g_time_val_to_iso8601</a>               (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *time_);
 
70
 
 
71
                    <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a>;
 
72
typedef             <a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime">GTime</a>;
 
73
enum                <a class="link" href="glib-Date-and-Time-Functions.html#GDateDMY" title="enum GDateDMY">GDateDMY</a>;
 
74
typedef             <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a>;
 
75
enum                <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a>;
 
76
typedef             <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a>;
 
77
enum                <a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday">GDateWeekday</a>;
 
78
 
 
79
#define             <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-DAY--CAPS" title="G_DATE_BAD_DAY">G_DATE_BAD_DAY</a>
 
80
#define             <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-JULIAN--CAPS" title="G_DATE_BAD_JULIAN">G_DATE_BAD_JULIAN</a>
 
81
#define             <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-YEAR--CAPS" title="G_DATE_BAD_YEAR">G_DATE_BAD_YEAR</a>
 
82
 
 
83
<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a>*              <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()">g_date_new</a>                          (void);
 
84
<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a>*              <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new-dmy" title="g_date_new_dmy ()">g_date_new_dmy</a>                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a> day,
 
85
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month,
 
86
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);
 
87
<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a>*              <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new-julian" title="g_date_new_julian ()">g_date_new_julian</a>                   (<a class="link" href="glib-Basic-Types.html#guint32" title="guint32">guint32</a> julian_day);
 
88
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()">g_date_clear</a>                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
89
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_dates);
 
90
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-free" title="g_date_free ()">g_date_free</a>                         (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
91
 
 
92
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-day" title="g_date_set_day ()">g_date_set_day</a>                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
93
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a> day);
 
94
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-month" title="g_date_set_month ()">g_date_set_month</a>                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
95
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month);
 
96
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-year" title="g_date_set_year ()">g_date_set_year</a>                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
97
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);
 
98
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-dmy" title="g_date_set_dmy ()">g_date_set_dmy</a>                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
99
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a> day,
 
100
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month,
 
101
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> y);
 
102
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-julian" title="g_date_set_julian ()">g_date_set_julian</a>                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
103
                                                         <a class="link" href="glib-Basic-Types.html#guint32" title="guint32">guint32</a> julian_date);
 
104
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-time" title="g_date_set_time ()">g_date_set_time</a>                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
105
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime">GTime</a> time_);
 
106
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-time-t" title="g_date_set_time_t ()">g_date_set_time_t</a>                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
107
107
                                                         time_t timet);
108
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-time-val">g_date_set_time_val</a>                 (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
109
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal">GTimeVal</a> *timeval);
110
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-parse">g_date_set_parse</a>                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
111
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str);
112
 
 
113
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-add-days">g_date_add_days</a>                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
114
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_days);
115
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-subtract-days">g_date_subtract_days</a>                (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
116
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_days);
117
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-add-months">g_date_add_months</a>                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
118
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_months);
119
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-subtract-months">g_date_subtract_months</a>              (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
120
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_months);
121
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-add-years">g_date_add_years</a>                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
122
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_years);
123
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-subtract-years">g_date_subtract_years</a>               (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
124
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_years);
125
 
<a class="link" href="glib-Basic-Types.html#gint">gint</a>                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-days-between">g_date_days_between</a>                 (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date1,
126
 
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date2);
127
 
<a class="link" href="glib-Basic-Types.html#gint">gint</a>                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-compare">g_date_compare</a>                      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *lhs,
128
 
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *rhs);
129
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clamp">g_date_clamp</a>                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
130
 
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *min_date,
131
 
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *max_date);
132
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-order">g_date_order</a>                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date1,
133
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date2);
134
 
 
135
 
<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-day">g_date_get_day</a>                      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
136
 
<a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a>          <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-month">g_date_get_month</a>                    (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
137
 
<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a>           <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-year">g_date_get_year</a>                     (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
138
 
<a class="link" href="glib-Basic-Types.html#guint32">guint32</a>             <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-julian">g_date_get_julian</a>                   (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
139
 
<a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday">GDateWeekday</a>        <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-weekday">g_date_get_weekday</a>                  (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
140
 
<a class="link" href="glib-Basic-Types.html#guint">guint</a>               <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-day-of-year">g_date_get_day_of_year</a>              (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
141
 
 
142
 
<a class="link" href="glib-Basic-Types.html#guint8">guint8</a>              <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-days-in-month">g_date_get_days_in_month</a>            (<a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a> month,
143
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);
144
 
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-is-first-of-month">g_date_is_first_of_month</a>            (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
145
 
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-is-last-of-month">g_date_is_last_of_month</a>             (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
146
 
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-is-leap-year">g_date_is_leap_year</a>                 (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);
147
 
<a class="link" href="glib-Basic-Types.html#guint">guint</a>               <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-monday-week-of-year">g_date_get_monday_week_of_year</a>      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
148
 
<a class="link" href="glib-Basic-Types.html#guint8">guint8</a>              <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-monday-weeks-in-year">g_date_get_monday_weeks_in_year</a>     (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);
149
 
<a class="link" href="glib-Basic-Types.html#guint">guint</a>               <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-sunday-week-of-year">g_date_get_sunday_week_of_year</a>      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
150
 
<a class="link" href="glib-Basic-Types.html#guint8">guint8</a>              <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-sunday-weeks-in-year">g_date_get_sunday_weeks_in_year</a>     (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);
151
 
<a class="link" href="glib-Basic-Types.html#guint">guint</a>               <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-iso8601-week-of-year">g_date_get_iso8601_week_of_year</a>     (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
152
 
 
153
 
<a class="link" href="glib-Basic-Types.html#gsize">gsize</a>               <a class="link" href="glib-Date-and-Time-Functions.html#g-date-strftime">g_date_strftime</a>                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s,
154
 
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> slen,
155
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
156
 
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
157
 
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-to-struct-tm">g_date_to_struct_tm</a>                 (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
 
108
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-time-val" title="g_date_set_time_val ()">g_date_set_time_val</a>                 (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
109
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *timeval);
 
110
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-parse" title="g_date_set_parse ()">g_date_set_parse</a>                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
111
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *str);
 
112
 
 
113
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-add-days" title="g_date_add_days ()">g_date_add_days</a>                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
114
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_days);
 
115
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-subtract-days" title="g_date_subtract_days ()">g_date_subtract_days</a>                (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
116
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_days);
 
117
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-add-months" title="g_date_add_months ()">g_date_add_months</a>                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
118
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_months);
 
119
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-subtract-months" title="g_date_subtract_months ()">g_date_subtract_months</a>              (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
120
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_months);
 
121
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-add-years" title="g_date_add_years ()">g_date_add_years</a>                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
122
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_years);
 
123
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-subtract-years" title="g_date_subtract_years ()">g_date_subtract_years</a>               (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
124
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_years);
 
125
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-days-between" title="g_date_days_between ()">g_date_days_between</a>                 (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date1,
 
126
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date2);
 
127
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-compare" title="g_date_compare ()">g_date_compare</a>                      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *lhs,
 
128
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *rhs);
 
129
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clamp" title="g_date_clamp ()">g_date_clamp</a>                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
130
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *min_date,
 
131
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *max_date);
 
132
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-order" title="g_date_order ()">g_date_order</a>                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date1,
 
133
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date2);
 
134
 
 
135
<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-day" title="g_date_get_day ()">g_date_get_day</a>                      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
136
<a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a>          <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-month" title="g_date_get_month ()">g_date_get_month</a>                    (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
137
<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a>           <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-year" title="g_date_get_year ()">g_date_get_year</a>                     (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
138
<a class="link" href="glib-Basic-Types.html#guint32" title="guint32">guint32</a>             <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-julian" title="g_date_get_julian ()">g_date_get_julian</a>                   (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
139
<a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday">GDateWeekday</a>        <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-weekday" title="g_date_get_weekday ()">g_date_get_weekday</a>                  (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
140
<a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a>               <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-day-of-year" title="g_date_get_day_of_year ()">g_date_get_day_of_year</a>              (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
141
 
 
142
<a class="link" href="glib-Basic-Types.html#guint8" title="guint8">guint8</a>              <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-days-in-month" title="g_date_get_days_in_month ()">g_date_get_days_in_month</a>            (<a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month,
 
143
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);
 
144
<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-is-first-of-month" title="g_date_is_first_of_month ()">g_date_is_first_of_month</a>            (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
145
<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-is-last-of-month" title="g_date_is_last_of_month ()">g_date_is_last_of_month</a>             (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
146
<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-is-leap-year" title="g_date_is_leap_year ()">g_date_is_leap_year</a>                 (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);
 
147
<a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a>               <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-monday-week-of-year" title="g_date_get_monday_week_of_year ()">g_date_get_monday_week_of_year</a>      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
148
<a class="link" href="glib-Basic-Types.html#guint8" title="guint8">guint8</a>              <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-monday-weeks-in-year" title="g_date_get_monday_weeks_in_year ()">g_date_get_monday_weeks_in_year</a>     (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);
 
149
<a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a>               <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-sunday-week-of-year" title="g_date_get_sunday_week_of_year ()">g_date_get_sunday_week_of_year</a>      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
150
<a class="link" href="glib-Basic-Types.html#guint8" title="guint8">guint8</a>              <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-sunday-weeks-in-year" title="g_date_get_sunday_weeks_in_year ()">g_date_get_sunday_weeks_in_year</a>     (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);
 
151
<a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a>               <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-iso8601-week-of-year" title="g_date_get_iso8601_week_of_year ()">g_date_get_iso8601_week_of_year</a>     (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
152
 
 
153
<a class="link" href="glib-Basic-Types.html#gsize" title="gsize">gsize</a>               <a class="link" href="glib-Date-and-Time-Functions.html#g-date-strftime" title="g_date_strftime ()">g_date_strftime</a>                     (<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *s,
 
154
                                                         <a class="link" href="glib-Basic-Types.html#gsize" title="gsize">gsize</a> slen,
 
155
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *format,
 
156
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
157
void                <a class="link" href="glib-Date-and-Time-Functions.html#g-date-to-struct-tm" title="g_date_to_struct_tm ()">g_date_to_struct_tm</a>                 (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
158
158
                                                         struct tm *tm);
159
159
 
160
 
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid">g_date_valid</a>                        (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);
161
 
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-day">g_date_valid_day</a>                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a> day);
162
 
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-month">g_date_valid_month</a>                  (<a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a> month);
163
 
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-year">g_date_valid_year</a>                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);
164
 
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-dmy">g_date_valid_dmy</a>                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a> day,
165
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a> month,
166
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);
167
 
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-julian">g_date_valid_julian</a>                 (<a class="link" href="glib-Basic-Types.html#guint32">guint32</a> julian_date);
168
 
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-weekday">g_date_valid_weekday</a>                (<a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday">GDateWeekday</a> weekday);
169
 
 
 
160
<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" title="g_date_valid ()">g_date_valid</a>                        (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);
 
161
<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-day" title="g_date_valid_day ()">g_date_valid_day</a>                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a> day);
 
162
<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-month" title="g_date_valid_month ()">g_date_valid_month</a>                  (<a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month);
 
163
<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-year" title="g_date_valid_year ()">g_date_valid_year</a>                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);
 
164
<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-dmy" title="g_date_valid_dmy ()">g_date_valid_dmy</a>                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a> day,
 
165
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month,
 
166
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);
 
167
<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-julian" title="g_date_valid_julian ()">g_date_valid_julian</a>                 (<a class="link" href="glib-Basic-Types.html#guint32" title="guint32">guint32</a> julian_date);
 
168
<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
169
</pre>
171
170
</div>
172
171
<div class="refsect1" lang="en">
173
 
<a name="id3091764"></a><h2>Description</h2>
 
172
<a name="glib-Date-and-Time-Functions.description"></a><h2>Description</h2>
174
173
<p>
175
 
The <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> data structure represents a day between January 1, Year 1,
 
174
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,
176
175
and sometime a few thousand years in the future (right now it will go
177
 
to the year 65535 or so, but <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-parse"><code class="function">g_date_set_parse()</code></a> only parses up to the
178
 
year 8000 or so - just count on "a few thousand"). <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> is meant to
 
176
to the year 65535 or so, but <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-parse" title="g_date_set_parse ()"><code class="function">g_date_set_parse()</code></a> only parses up to the
 
177
year 8000 or so - just count on "a few thousand"). <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> is meant to
179
178
represent everyday dates, not astronomical dates or historical dates
180
179
or ISO timestamps or the like. It extrapolates the current Gregorian
181
180
calendar forward and backward in time; there is no attempt to change
182
 
the calendar to match time periods or locations. <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> does not store
 
181
the calendar to match time periods or locations. <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> does not store
183
182
time information; it represents a <span class="emphasis"><em>day</em></span>.
184
183
</p>
185
184
<p>
186
 
The <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> implementation has several nice features; it is only a
 
185
The <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> implementation has several nice features; it is only a
187
186
64-bit struct, so storing large numbers of dates is very efficient. It
188
187
can keep both a Julian and day-month-year representation of the date,
189
188
since some calculations are much easier with one representation or the
190
189
other. A Julian representation is simply a count of days since some
191
 
fixed day in the past; for <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> the fixed day is January 1, 1 AD.
192
 
("Julian" dates in the <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> API aren't really Julian dates in the
 
190
fixed day in the past; for <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> the fixed day is January 1, 1 AD.
 
191
("Julian" dates in the <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> API aren't really Julian dates in the
193
192
technical sense; technically, Julian dates count from the start of the
194
193
Julian period, Jan 1, 4713 BC).
195
194
</p>
196
195
<p>
197
 
<a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> is simple to use. First you need a "blank" date; you can get a
198
 
dynamically allocated date from <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new"><code class="function">g_date_new()</code></a>, or you can declare an
 
196
<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> is simple to use. First you need a "blank" date; you can get a
 
197
dynamically allocated date from <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()"><code class="function">g_date_new()</code></a>, or you can declare an
199
198
automatic variable or array and initialize it to a sane state by
200
 
calling <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear"><code class="function">g_date_clear()</code></a>. A cleared date is sane; it's safe to call
201
 
<a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-dmy"><code class="function">g_date_set_dmy()</code></a> and the other mutator functions to initialize the
 
199
calling <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()"><code class="function">g_date_clear()</code></a>. A cleared date is sane; it's safe to call
 
200
<a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-dmy" title="g_date_set_dmy ()"><code class="function">g_date_set_dmy()</code></a> and the other mutator functions to initialize the
202
201
value of a cleared date. However, a cleared date is initially
203
202
<span class="emphasis"><em>invalid</em></span>, meaning that it doesn't represent a day
204
203
that exists. It is undefined to call any of the date calculation
205
204
routines on an invalid date. If you obtain a date from a user or other
206
205
unpredictable source, you should check its validity with the
207
 
<a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid"><code class="function">g_date_valid()</code></a> predicate. <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid"><code class="function">g_date_valid()</code></a> is also used to check for
208
 
errors with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-parse"><code class="function">g_date_set_parse()</code></a> and other functions that can
209
 
fail. Dates can be invalidated by calling <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear"><code class="function">g_date_clear()</code></a> again.
 
206
<a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid" title="g_date_valid ()"><code class="function">g_date_valid()</code></a> predicate. <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid" title="g_date_valid ()"><code class="function">g_date_valid()</code></a> is also used to check for
 
207
errors with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-parse" title="g_date_set_parse ()"><code class="function">g_date_set_parse()</code></a> and other functions that can
 
208
fail. Dates can be invalidated by calling <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()"><code class="function">g_date_clear()</code></a> again.
210
209
</p>
211
210
<p>
212
 
<span class="emphasis"><em>It is very important to use the API to access the <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
 
211
<span class="emphasis"><em>It is very important to use the API to access the <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
213
212
struct.</em></span> Often only the day-month-year or only the Julian
214
213
representation is valid. Sometimes neither is valid. Use the API.
215
214
</p>
216
215
<p>
217
216
GLib doesn't contain any time-manipulation functions; however, there
218
 
is a <a class="link" href="glib-Date-and-Time-Functions.html#GTime"><span class="type">GTime</span></a> typedef and a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> struct which represents a more 
219
 
precise time (with microseconds). You can request the current time as 
220
 
a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> with <a class="link" href="glib-Date-and-Time-Functions.html#g-get-current-time"><code class="function">g_get_current_time()</code></a>.
 
217
is a <a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime"><span class="type">GTime</span></a> typedef and a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> struct which represents a more
 
218
precise time (with microseconds). You can request the current time as
 
219
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
220
</p>
222
221
</div>
223
222
<div class="refsect1" lang="en">
224
 
<a name="id3092021"></a><h2>Details</h2>
 
223
<a name="glib-Date-and-Time-Functions.details"></a><h2>Details</h2>
225
224
<div class="refsect2" lang="en">
226
 
<a name="id3092030"></a><h3>
227
 
<a name="G-USEC-PER-SEC:CAPS"></a>G_USEC_PER_SEC</h3>
228
 
<a class="indexterm" name="id3092043"></a><pre class="programlisting">#define G_USEC_PER_SEC 1000000
 
225
<a name="G-USEC-PER-SEC--CAPS"></a><h3>G_USEC_PER_SEC</h3>
 
226
<pre class="programlisting">#define G_USEC_PER_SEC 1000000
229
227
</pre>
230
228
<p>
231
229
Number of microseconds in one second (1 million). This macro is provided for
234
232
</div>
235
233
<hr>
236
234
<div class="refsect2" lang="en">
237
 
<a name="id3092060"></a><h3>
238
 
<a name="GTimeVal"></a>GTimeVal</h3>
239
 
<a class="indexterm" name="id3092072"></a><pre class="programlisting">typedef struct {
 
235
<a name="GTimeVal"></a><h3>GTimeVal</h3>
 
236
<pre class="programlisting">typedef struct {
240
237
  glong tv_sec;
241
238
  glong tv_usec;
242
239
} GTimeVal;
243
240
</pre>
244
241
<p>
245
 
Represents a precise time, with seconds and microseconds. 
246
 
Similar to the <span class="structname">struct timeval</span> returned by 
 
242
Represents a precise time, with seconds and microseconds.
 
243
Similar to the <span class="structname">struct timeval</span> returned by
247
244
the <code class="function"><code class="function">gettimeofday()</code></code> UNIX call.
248
245
</p>
249
246
<div class="variablelist"><table border="0">
250
247
<col align="left" valign="top">
251
248
<tbody>
252
249
<tr>
253
 
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#glong">glong</a>&#160;<em class="structfield"><code>tv_sec</code></em>;</span></p></td>
 
250
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#glong" title="glong">glong</a> <em class="structfield"><code>tv_sec</code></em>;</span></p></td>
254
251
<td>seconds
255
252
</td>
256
253
</tr>
257
254
<tr>
258
 
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#glong">glong</a>&#160;<em class="structfield"><code>tv_usec</code></em>;</span></p></td>
 
255
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#glong" title="glong">glong</a> <em class="structfield"><code>tv_usec</code></em>;</span></p></td>
259
256
<td>microseconds
260
 
 
261
257
</td>
262
258
</tr>
263
259
</tbody>
265
261
</div>
266
262
<hr>
267
263
<div class="refsect2" lang="en">
268
 
<a name="id3092154"></a><h3>
269
 
<a name="g-get-current-time"></a>g_get_current_time ()</h3>
270
 
<a class="indexterm" name="id3092167"></a><pre class="programlisting">void                g_get_current_time                  (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal">GTimeVal</a> *result);</pre>
 
264
<a name="g-get-current-time"></a><h3>g_get_current_time ()</h3>
 
265
<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>
271
266
<p>
272
267
Equivalent to the UNIX <code class="function">gettimeofday()</code> function, but portable.</p>
273
268
<p>
275
270
<div class="variablelist"><table border="0">
276
271
<col align="left" valign="top">
277
272
<tbody><tr>
278
 
<td><p><span class="term"><em class="parameter"><code>result</code></em>&#160;:</span></p></td>
279
 
<td> <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> structure in which to store current time.
 
273
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
 
274
<td> <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> structure in which to store current time.
280
275
</td>
281
276
</tr></tbody>
282
277
</table></div>
283
278
</div>
284
279
<hr>
285
280
<div class="refsect2" lang="en">
286
 
<a name="id3092236"></a><h3>
287
 
<a name="g-usleep"></a>g_usleep ()</h3>
288
 
<a class="indexterm" name="id3092248"></a><pre class="programlisting">void                g_usleep                            (<a class="link" href="glib-Basic-Types.html#gulong">gulong</a> microseconds);</pre>
 
281
<a name="g-usleep"></a><h3>g_usleep ()</h3>
 
282
<pre class="programlisting">void                g_usleep                            (<a class="link" href="glib-Basic-Types.html#gulong" title="gulong">gulong</a> microseconds);</pre>
289
283
<p>
290
284
Pauses the current thread for the given number of microseconds. There
291
285
are 1 million microseconds per second (represented by the
292
 
<a class="link" href="glib-Date-and-Time-Functions.html#G-USEC-PER-SEC:CAPS"><span class="type">G_USEC_PER_SEC</span></a> macro). <a class="link" href="glib-Date-and-Time-Functions.html#g-usleep"><code class="function">g_usleep()</code></a> may have limited precision,
 
286
<a class="link" href="glib-Date-and-Time-Functions.html#G-USEC-PER-SEC--CAPS" title="G_USEC_PER_SEC"><span class="type">G_USEC_PER_SEC</span></a> macro). <a class="link" href="glib-Date-and-Time-Functions.html#g-usleep" title="g_usleep ()"><code class="function">g_usleep()</code></a> may have limited precision,
293
287
depending on hardware and operating system; don't rely on the exact
294
288
length of the sleep.
295
289
</p>
296
290
<div class="variablelist"><table border="0">
297
291
<col align="left" valign="top">
298
292
<tbody><tr>
299
 
<td><p><span class="term"><em class="parameter"><code>microseconds</code></em>&#160;:</span></p></td>
 
293
<td><p><span class="term"><em class="parameter"><code>microseconds</code></em> :</span></p></td>
300
294
<td>number of microseconds to pause
301
 
 
302
 
 
303
295
</td>
304
296
</tr></tbody>
305
297
</table></div>
306
298
</div>
307
299
<hr>
308
300
<div class="refsect2" lang="en">
309
 
<a name="id3092317"></a><h3>
310
 
<a name="g-time-val-add"></a>g_time_val_add ()</h3>
311
 
<a class="indexterm" name="id3092330"></a><pre class="programlisting">void                g_time_val_add                      (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal">GTimeVal</a> *time_,
312
 
                                                         <a class="link" href="glib-Basic-Types.html#glong">glong</a> microseconds);</pre>
 
301
<a name="g-time-val-add"></a><h3>g_time_val_add ()</h3>
 
302
<pre class="programlisting">void                g_time_val_add                      (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *time_,
 
303
                                                         <a class="link" href="glib-Basic-Types.html#glong" title="glong">glong</a> microseconds);</pre>
313
304
<p>
314
305
Adds the given number of microseconds to <em class="parameter"><code>time_</code></em>. <em class="parameter"><code>microseconds</code></em> can
315
306
also be negative to decrease the value of <em class="parameter"><code>time_</code></em>.</p>
316
307
<p>
317
 
 
318
308
</p>
319
309
<div class="variablelist"><table border="0">
320
310
<col align="left" valign="top">
321
311
<tbody>
322
312
<tr>
323
 
<td><p><span class="term"><em class="parameter"><code>time_</code></em>&#160;:</span></p></td>
324
 
<td> a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a>
 
313
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
 
314
<td> a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a>
325
315
</td>
326
316
</tr>
327
317
<tr>
328
 
<td><p><span class="term"><em class="parameter"><code>microseconds</code></em>&#160;:</span></p></td>
 
318
<td><p><span class="term"><em class="parameter"><code>microseconds</code></em> :</span></p></td>
329
319
<td> number of microseconds to add to <em class="parameter"><code>time</code></em>
330
320
</td>
331
321
</tr>
334
324
</div>
335
325
<hr>
336
326
<div class="refsect2" lang="en">
337
 
<a name="id3092434"></a><h3>
338
 
<a name="g-time-val-from-iso8601"></a>g_time_val_from_iso8601 ()</h3>
339
 
<a class="indexterm" name="id3092449"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_time_val_from_iso8601             (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *iso_date,
340
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal">GTimeVal</a> *time_);</pre>
 
327
<a name="g-time-val-from-iso8601"></a><h3>g_time_val_from_iso8601 ()</h3>
 
328
<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,
 
329
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *time_);</pre>
341
330
<p>
342
331
Converts a string containing an ISO 8601 encoded date and time
343
 
to a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> and puts it into <em class="parameter"><code>time_</code></em>.</p>
 
332
to a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> and puts it into <em class="parameter"><code>time_</code></em>.</p>
344
333
<p>
345
 
 
346
334
</p>
347
335
<div class="variablelist"><table border="0">
348
336
<col align="left" valign="top">
349
337
<tbody>
350
338
<tr>
351
 
<td><p><span class="term"><em class="parameter"><code>iso_date</code></em>&#160;:</span></p></td>
352
 
<td> a ISO 8601 encoded date string
353
 
</td>
354
 
</tr>
355
 
<tr>
356
 
<td><p><span class="term"><em class="parameter"><code>time_</code></em>&#160;:</span></p></td>
357
 
<td> a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a>
358
 
</td>
359
 
</tr>
360
 
<tr>
361
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
362
 
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the conversion was successful.
 
339
<td><p><span class="term"><em class="parameter"><code>iso_date</code></em> :</span></p></td>
 
340
<td> an ISO 8601 encoded date string
 
341
</td>
 
342
</tr>
 
343
<tr>
 
344
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
 
345
<td> a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a>
 
346
</td>
 
347
</tr>
 
348
<tr>
 
349
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
350
<td> <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the conversion was successful.
363
351
 
364
352
</td>
365
353
</tr>
366
354
</tbody>
367
355
</table></div>
368
 
<p class="since">Since  2.12
369
 
</p>
 
356
<p class="since">Since 2.12</p>
370
357
</div>
371
358
<hr>
372
359
<div class="refsect2" lang="en">
373
 
<a name="id3092572"></a><h3>
374
 
<a name="g-time-val-to-iso8601"></a>g_time_val_to_iso8601 ()</h3>
375
 
<a class="indexterm" name="id3092587"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_time_val_to_iso8601               (<a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal">GTimeVal</a> *time_);</pre>
 
360
<a name="g-time-val-to-iso8601"></a><h3>g_time_val_to_iso8601 ()</h3>
 
361
<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>
376
362
<p>
377
 
Converts <em class="parameter"><code>time_</code></em> into a ISO 8601 encoded string, relative to the
 
363
Converts <em class="parameter"><code>time_</code></em> into an ISO 8601 encoded string, relative to the
378
364
Coordinated Universal Time (UTC).</p>
379
365
<p>
380
 
 
381
366
</p>
382
367
<div class="variablelist"><table border="0">
383
368
<col align="left" valign="top">
384
369
<tbody>
385
370
<tr>
386
 
<td><p><span class="term"><em class="parameter"><code>time_</code></em>&#160;:</span></p></td>
387
 
<td> a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a>
 
371
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
 
372
<td> a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a>
388
373
</td>
389
374
</tr>
390
375
<tr>
391
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
392
 
<td> a newly allocated string containing a ISO 8601 date
 
376
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
377
<td> a newly allocated string containing an ISO 8601 date
393
378
 
394
379
</td>
395
380
</tr>
396
381
</tbody>
397
382
</table></div>
398
 
<p class="since">Since  2.12
399
 
</p>
 
383
<p class="since">Since 2.12</p>
400
384
</div>
401
385
<hr>
402
386
<div class="refsect2" lang="en">
403
 
<a name="id3092670"></a><h3>
404
 
<a name="GDate"></a>GDate</h3>
405
 
<a class="indexterm" name="id3092682"></a><pre class="programlisting">typedef struct {
 
387
<a name="GDate"></a><h3>GDate</h3>
 
388
<pre class="programlisting">typedef struct {
406
389
  guint julian_days : 32; /* julian days representation - we use a
407
390
                           *  bitfield hoping that 64 bit platforms
408
391
                           *  will pack this whole struct in one big
421
404
<p>
422
405
Represents a day between January 1, Year 1 and a few thousand years in
423
406
the future. None of its members should be accessed directly. If the
424
 
<span class="structname">GDate</span> is obtained from <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new"><code class="function">g_date_new()</code></a>, it will
 
407
<span class="structname">GDate</span> is obtained from <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()"><code class="function">g_date_new()</code></a>, it will
425
408
be safe to mutate but invalid and thus not safe for calendrical computations.
426
409
If it's declared on the stack, it will contain garbage so must be
427
 
initialized with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear"><code class="function">g_date_clear()</code></a>. <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear"><code class="function">g_date_clear()</code></a> makes the date invalid
 
410
initialized with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()"><code class="function">g_date_clear()</code></a>. <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()"><code class="function">g_date_clear()</code></a> makes the date invalid
428
411
but sane. An invalid date doesn't represent a day, it's "empty." A
429
412
date becomes valid after you set it to a Julian day or you set a day,
430
413
month, and year.
433
416
<col align="left" valign="top">
434
417
<tbody>
435
418
<tr>
436
 
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint">guint</a>&#160;<em class="structfield"><code>julian_days</code></em>&#160;:&#160;32;</span></p></td>
 
419
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> <em class="structfield"><code>julian_days</code></em> : 32;</span></p></td>
437
420
<td>the Julian representation of the date
438
421
</td>
439
422
</tr>
440
423
<tr>
441
 
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint">guint</a>&#160;<em class="structfield"><code>julian</code></em>&#160;:&#160;1;</span></p></td>
 
424
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> <em class="structfield"><code>julian</code></em> : 1;</span></p></td>
442
425
<td>this bit is set if <em class="parameter"><code>julian_days</code></em> is valid
443
426
</td>
444
427
</tr>
445
428
<tr>
446
 
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint">guint</a>&#160;<em class="structfield"><code>dmy</code></em>&#160;:&#160;1;</span></p></td>
 
429
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> <em class="structfield"><code>dmy</code></em> : 1;</span></p></td>
447
430
<td>this is set if <em class="parameter"><code>day</code></em>, <em class="parameter"><code>month</code></em> and <em class="parameter"><code>year</code></em> are valid
448
431
</td>
449
432
</tr>
450
433
<tr>
451
 
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint">guint</a>&#160;<em class="structfield"><code>day</code></em>&#160;:&#160;6;</span></p></td>
 
434
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> <em class="structfield"><code>day</code></em> : 6;</span></p></td>
452
435
<td>the day of the day-month-year representation of the date, as 
453
436
  a number between 1 and 31
454
437
</td>
455
438
</tr>
456
439
<tr>
457
 
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint">guint</a>&#160;<em class="structfield"><code>month</code></em>&#160;:&#160;4;</span></p></td>
 
440
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> <em class="structfield"><code>month</code></em> : 4;</span></p></td>
458
441
<td>the day of the day-month-year representation of the date, as 
459
442
  a number between 1 and 12
460
443
</td>
461
444
</tr>
462
445
<tr>
463
 
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint">guint</a>&#160;<em class="structfield"><code>year</code></em>&#160;:&#160;16;</span></p></td>
 
446
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> <em class="structfield"><code>year</code></em> : 16;</span></p></td>
464
447
<td>the day of the day-month-year representation of the date
465
 
 
466
448
</td>
467
449
</tr>
468
450
</tbody>
470
452
</div>
471
453
<hr>
472
454
<div class="refsect2" lang="en">
473
 
<a name="id3092903"></a><h3>
474
 
<a name="GTime"></a>GTime</h3>
475
 
<a class="indexterm" name="id3092915"></a><pre class="programlisting">typedef gint32  GTime;
 
455
<a name="GTime"></a><h3>GTime</h3>
 
456
<pre class="programlisting">typedef gint32  GTime;
476
457
</pre>
477
458
<p>
478
459
Simply a replacement for <span class="type">time_t</span>. It has been deprected
479
 
since it is <span class="emphasis"><em>not</em></span> equivalent to <span class="type">time_t</span> 
480
 
on 64-bit platforms with a 64-bit <span class="type">time_t</span>. 
481
 
Unrelated to <a class="link" href="glib-Timers.html#GTimer"><span class="type">GTimer</span></a>.
 
460
since it is <span class="emphasis"><em>not</em></span> equivalent to <span class="type">time_t</span>
 
461
on 64-bit platforms with a 64-bit <span class="type">time_t</span>.
 
462
Unrelated to <a class="link" href="glib-Timers.html#GTimer" title="GTimer"><span class="type">GTimer</span></a>.
482
463
</p>
483
464
<p>
484
465
Note that <span class="type">GTime</span> is defined to always be a 32bit integer,
485
 
unlike <span class="type">time_t</span> which may be 64bit on some systems. 
 
466
unlike <span class="type">time_t</span> which may be 64bit on some systems.
486
467
Therefore, <span class="type">GTime</span> will overflow in the year 2038, and
487
 
you cannot use the address of a <span class="type">GTime</span> variable as argument 
 
468
you cannot use the address of a <span class="type">GTime</span> variable as argument
488
469
to the UNIX <code class="function">time()</code> function. Instead, do the following:
489
470
</p>
490
471
<div class="informalexample"><pre class="programlisting">
491
472
time_t ttime;
492
473
GTime gtime;
493
 
 
494
474
time (&amp;ttime);
495
475
gtime = (GTime)ttime;
496
476
</pre></div>
499
479
</div>
500
480
<hr>
501
481
<div class="refsect2" lang="en">
502
 
<a name="id3092999"></a><h3>
503
 
<a name="GDateDMY"></a>enum GDateDMY</h3>
504
 
<a class="indexterm" name="id3093011"></a><pre class="programlisting">typedef enum
 
482
<a name="GDateDMY"></a><h3>enum GDateDMY</h3>
 
483
<pre class="programlisting">typedef enum
505
484
{
506
485
  G_DATE_DAY   = 0,
507
486
  G_DATE_MONTH = 1,
516
495
<col align="left" valign="top">
517
496
<tbody>
518
497
<tr>
519
 
<td><p><span class="term"><a name="G-DATE-DAY:CAPS"></a><code class="literal">G_DATE_DAY</code></span></p></td>
 
498
<td><p><a name="G-DATE-DAY--CAPS"></a><span class="term"><code class="literal">G_DATE_DAY</code></span></p></td>
520
499
<td>a day
521
500
</td>
522
501
</tr>
523
502
<tr>
524
 
<td><p><span class="term"><a name="G-DATE-MONTH:CAPS"></a><code class="literal">G_DATE_MONTH</code></span></p></td>
 
503
<td><p><a name="G-DATE-MONTH--CAPS"></a><span class="term"><code class="literal">G_DATE_MONTH</code></span></p></td>
525
504
<td>a month
526
505
</td>
527
506
</tr>
528
507
<tr>
529
 
<td><p><span class="term"><a name="G-DATE-YEAR:CAPS"></a><code class="literal">G_DATE_YEAR</code></span></p></td>
 
508
<td><p><a name="G-DATE-YEAR--CAPS"></a><span class="term"><code class="literal">G_DATE_YEAR</code></span></p></td>
530
509
<td>a year
531
 
 
532
510
</td>
533
511
</tr>
534
512
</tbody>
536
514
</div>
537
515
<hr>
538
516
<div class="refsect2" lang="en">
539
 
<a name="id3093100"></a><h3>
540
 
<a name="GDateDay"></a>GDateDay</h3>
541
 
<a class="indexterm" name="id3093112"></a><pre class="programlisting">typedef guint8  GDateDay;   /* day of the month */
 
517
<a name="GDateDay"></a><h3>GDateDay</h3>
 
518
<pre class="programlisting">typedef guint8  GDateDay;   /* day of the month */
542
519
</pre>
543
520
<p>
544
521
Integer representing a day of the month; between 1 and
545
 
31. <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-DAY:CAPS"><span class="type">G_DATE_BAD_DAY</span></a> represents an invalid day of the month.
 
522
31. <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-DAY--CAPS" title="G_DATE_BAD_DAY"><span class="type">G_DATE_BAD_DAY</span></a> represents an invalid day of the month.
546
523
</p>
547
524
</div>
548
525
<hr>
549
526
<div class="refsect2" lang="en">
550
 
<a name="id3093137"></a><h3>
551
 
<a name="GDateMonth"></a>enum GDateMonth</h3>
552
 
<a class="indexterm" name="id3093149"></a><pre class="programlisting">typedef enum
 
527
<a name="GDateMonth"></a><h3>enum GDateMonth</h3>
 
528
<pre class="programlisting">typedef enum
553
529
{
554
530
  G_DATE_BAD_MONTH = 0,
555
531
  G_DATE_JANUARY   = 1,
567
543
} GDateMonth;
568
544
</pre>
569
545
<p>
570
 
Enumeration representing a month; values are <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-JANUARY:CAPS"><span class="type">G_DATE_JANUARY</span></a>,
571
 
<a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-FEBRUARY:CAPS"><span class="type">G_DATE_FEBRUARY</span></a>, etc. <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-MONTH:CAPS"><span class="type">G_DATE_BAD_MONTH</span></a> is the invalid value.
 
546
Enumeration representing a month; values are <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-JANUARY--CAPS"><span class="type">G_DATE_JANUARY</span></a>,
 
547
<a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-FEBRUARY--CAPS"><span class="type">G_DATE_FEBRUARY</span></a>, etc. <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-MONTH--CAPS"><span class="type">G_DATE_BAD_MONTH</span></a> is the invalid value.
572
548
</p>
573
549
<div class="variablelist"><table border="0">
574
550
<col align="left" valign="top">
575
551
<tbody>
576
552
<tr>
577
 
<td><p><span class="term"><a name="G-DATE-BAD-MONTH:CAPS"></a><code class="literal">G_DATE_BAD_MONTH</code></span></p></td>
 
553
<td><p><a name="G-DATE-BAD-MONTH--CAPS"></a><span class="term"><code class="literal">G_DATE_BAD_MONTH</code></span></p></td>
578
554
<td>invalid value
579
555
</td>
580
556
</tr>
581
557
<tr>
582
 
<td><p><span class="term"><a name="G-DATE-JANUARY:CAPS"></a><code class="literal">G_DATE_JANUARY</code></span></p></td>
 
558
<td><p><a name="G-DATE-JANUARY--CAPS"></a><span class="term"><code class="literal">G_DATE_JANUARY</code></span></p></td>
583
559
<td>January
584
560
</td>
585
561
</tr>
586
562
<tr>
587
 
<td><p><span class="term"><a name="G-DATE-FEBRUARY:CAPS"></a><code class="literal">G_DATE_FEBRUARY</code></span></p></td>
 
563
<td><p><a name="G-DATE-FEBRUARY--CAPS"></a><span class="term"><code class="literal">G_DATE_FEBRUARY</code></span></p></td>
588
564
<td>February
589
565
</td>
590
566
</tr>
591
567
<tr>
592
 
<td><p><span class="term"><a name="G-DATE-MARCH:CAPS"></a><code class="literal">G_DATE_MARCH</code></span></p></td>
 
568
<td><p><a name="G-DATE-MARCH--CAPS"></a><span class="term"><code class="literal">G_DATE_MARCH</code></span></p></td>
593
569
<td>March
594
570
</td>
595
571
</tr>
596
572
<tr>
597
 
<td><p><span class="term"><a name="G-DATE-APRIL:CAPS"></a><code class="literal">G_DATE_APRIL</code></span></p></td>
 
573
<td><p><a name="G-DATE-APRIL--CAPS"></a><span class="term"><code class="literal">G_DATE_APRIL</code></span></p></td>
598
574
<td>April
599
575
</td>
600
576
</tr>
601
577
<tr>
602
 
<td><p><span class="term"><a name="G-DATE-MAY:CAPS"></a><code class="literal">G_DATE_MAY</code></span></p></td>
 
578
<td><p><a name="G-DATE-MAY--CAPS"></a><span class="term"><code class="literal">G_DATE_MAY</code></span></p></td>
603
579
<td>May
604
580
</td>
605
581
</tr>
606
582
<tr>
607
 
<td><p><span class="term"><a name="G-DATE-JUNE:CAPS"></a><code class="literal">G_DATE_JUNE</code></span></p></td>
 
583
<td><p><a name="G-DATE-JUNE--CAPS"></a><span class="term"><code class="literal">G_DATE_JUNE</code></span></p></td>
608
584
<td>June
609
585
</td>
610
586
</tr>
611
587
<tr>
612
 
<td><p><span class="term"><a name="G-DATE-JULY:CAPS"></a><code class="literal">G_DATE_JULY</code></span></p></td>
 
588
<td><p><a name="G-DATE-JULY--CAPS"></a><span class="term"><code class="literal">G_DATE_JULY</code></span></p></td>
613
589
<td>July
614
590
</td>
615
591
</tr>
616
592
<tr>
617
 
<td><p><span class="term"><a name="G-DATE-AUGUST:CAPS"></a><code class="literal">G_DATE_AUGUST</code></span></p></td>
 
593
<td><p><a name="G-DATE-AUGUST--CAPS"></a><span class="term"><code class="literal">G_DATE_AUGUST</code></span></p></td>
618
594
<td>August
619
595
</td>
620
596
</tr>
621
597
<tr>
622
 
<td><p><span class="term"><a name="G-DATE-SEPTEMBER:CAPS"></a><code class="literal">G_DATE_SEPTEMBER</code></span></p></td>
 
598
<td><p><a name="G-DATE-SEPTEMBER--CAPS"></a><span class="term"><code class="literal">G_DATE_SEPTEMBER</code></span></p></td>
623
599
<td>September
624
600
</td>
625
601
</tr>
626
602
<tr>
627
 
<td><p><span class="term"><a name="G-DATE-OCTOBER:CAPS"></a><code class="literal">G_DATE_OCTOBER</code></span></p></td>
 
603
<td><p><a name="G-DATE-OCTOBER--CAPS"></a><span class="term"><code class="literal">G_DATE_OCTOBER</code></span></p></td>
628
604
<td>October
629
605
</td>
630
606
</tr>
631
607
<tr>
632
 
<td><p><span class="term"><a name="G-DATE-NOVEMBER:CAPS"></a><code class="literal">G_DATE_NOVEMBER</code></span></p></td>
 
608
<td><p><a name="G-DATE-NOVEMBER--CAPS"></a><span class="term"><code class="literal">G_DATE_NOVEMBER</code></span></p></td>
633
609
<td>November
634
610
</td>
635
611
</tr>
636
612
<tr>
637
 
<td><p><span class="term"><a name="G-DATE-DECEMBER:CAPS"></a><code class="literal">G_DATE_DECEMBER</code></span></p></td>
 
613
<td><p><a name="G-DATE-DECEMBER--CAPS"></a><span class="term"><code class="literal">G_DATE_DECEMBER</code></span></p></td>
638
614
<td>December
639
 
 
640
615
</td>
641
616
</tr>
642
617
</tbody>
644
619
</div>
645
620
<hr>
646
621
<div class="refsect2" lang="en">
647
 
<a name="id3093491"></a><h3>
648
 
<a name="GDateYear"></a>GDateYear</h3>
649
 
<a class="indexterm" name="id3093502"></a><pre class="programlisting">typedef guint16 GDateYear;
 
622
<a name="GDateYear"></a><h3>GDateYear</h3>
 
623
<pre class="programlisting">typedef guint16 GDateYear;
650
624
</pre>
651
625
<p>
652
 
Integer representing a year; <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-YEAR:CAPS"><span class="type">G_DATE_BAD_YEAR</span></a> is the invalid
 
626
Integer representing a year; <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-YEAR--CAPS" title="G_DATE_BAD_YEAR"><span class="type">G_DATE_BAD_YEAR</span></a> is the invalid
653
627
value. The year must be 1 or higher; negative (BC) years are not
654
628
allowed. The year is represented with four digits.
655
629
</p>
656
630
</div>
657
631
<hr>
658
632
<div class="refsect2" lang="en">
659
 
<a name="id3093529"></a><h3>
660
 
<a name="GDateWeekday"></a>enum GDateWeekday</h3>
661
 
<a class="indexterm" name="id3093542"></a><pre class="programlisting">typedef enum
 
633
<a name="GDateWeekday"></a><h3>enum GDateWeekday</h3>
 
634
<pre class="programlisting">typedef enum
662
635
{
663
636
  G_DATE_BAD_WEEKDAY  = 0,
664
637
  G_DATE_MONDAY       = 1,
671
644
} GDateWeekday;
672
645
</pre>
673
646
<p>
674
 
Enumeration representing a day of the week; <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-MONDAY:CAPS"><span class="type">G_DATE_MONDAY</span></a>,
675
 
<a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-TUESDAY:CAPS"><span class="type">G_DATE_TUESDAY</span></a>, etc. <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-WEEKDAY:CAPS"><span class="type">G_DATE_BAD_WEEKDAY</span></a> is an invalid weekday.
 
647
Enumeration representing a day of the week; <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-MONDAY--CAPS"><span class="type">G_DATE_MONDAY</span></a>,
 
648
<a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-TUESDAY--CAPS"><span class="type">G_DATE_TUESDAY</span></a>, etc. <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-WEEKDAY--CAPS"><span class="type">G_DATE_BAD_WEEKDAY</span></a> is an invalid weekday.
676
649
</p>
677
650
<div class="variablelist"><table border="0">
678
651
<col align="left" valign="top">
679
652
<tbody>
680
653
<tr>
681
 
<td><p><span class="term"><a name="G-DATE-BAD-WEEKDAY:CAPS"></a><code class="literal">G_DATE_BAD_WEEKDAY</code></span></p></td>
 
654
<td><p><a name="G-DATE-BAD-WEEKDAY--CAPS"></a><span class="term"><code class="literal">G_DATE_BAD_WEEKDAY</code></span></p></td>
682
655
<td>invalid value
683
656
</td>
684
657
</tr>
685
658
<tr>
686
 
<td><p><span class="term"><a name="G-DATE-MONDAY:CAPS"></a><code class="literal">G_DATE_MONDAY</code></span></p></td>
 
659
<td><p><a name="G-DATE-MONDAY--CAPS"></a><span class="term"><code class="literal">G_DATE_MONDAY</code></span></p></td>
687
660
<td>Monday
688
661
</td>
689
662
</tr>
690
663
<tr>
691
 
<td><p><span class="term"><a name="G-DATE-TUESDAY:CAPS"></a><code class="literal">G_DATE_TUESDAY</code></span></p></td>
 
664
<td><p><a name="G-DATE-TUESDAY--CAPS"></a><span class="term"><code class="literal">G_DATE_TUESDAY</code></span></p></td>
692
665
<td>Tuesday
693
666
</td>
694
667
</tr>
695
668
<tr>
696
 
<td><p><span class="term"><a name="G-DATE-WEDNESDAY:CAPS"></a><code class="literal">G_DATE_WEDNESDAY</code></span></p></td>
 
669
<td><p><a name="G-DATE-WEDNESDAY--CAPS"></a><span class="term"><code class="literal">G_DATE_WEDNESDAY</code></span></p></td>
697
670
<td>Wednesday
698
671
</td>
699
672
</tr>
700
673
<tr>
701
 
<td><p><span class="term"><a name="G-DATE-THURSDAY:CAPS"></a><code class="literal">G_DATE_THURSDAY</code></span></p></td>
 
674
<td><p><a name="G-DATE-THURSDAY--CAPS"></a><span class="term"><code class="literal">G_DATE_THURSDAY</code></span></p></td>
702
675
<td>Thursday
703
676
</td>
704
677
</tr>
705
678
<tr>
706
 
<td><p><span class="term"><a name="G-DATE-FRIDAY:CAPS"></a><code class="literal">G_DATE_FRIDAY</code></span></p></td>
 
679
<td><p><a name="G-DATE-FRIDAY--CAPS"></a><span class="term"><code class="literal">G_DATE_FRIDAY</code></span></p></td>
707
680
<td>Friday
708
681
</td>
709
682
</tr>
710
683
<tr>
711
 
<td><p><span class="term"><a name="G-DATE-SATURDAY:CAPS"></a><code class="literal">G_DATE_SATURDAY</code></span></p></td>
 
684
<td><p><a name="G-DATE-SATURDAY--CAPS"></a><span class="term"><code class="literal">G_DATE_SATURDAY</code></span></p></td>
712
685
<td>Saturday
713
686
</td>
714
687
</tr>
715
688
<tr>
716
 
<td><p><span class="term"><a name="G-DATE-SUNDAY:CAPS"></a><code class="literal">G_DATE_SUNDAY</code></span></p></td>
 
689
<td><p><a name="G-DATE-SUNDAY--CAPS"></a><span class="term"><code class="literal">G_DATE_SUNDAY</code></span></p></td>
717
690
<td>Sunday
718
 
 
719
691
</td>
720
692
</tr>
721
693
</tbody>
723
695
</div>
724
696
<hr>
725
697
<div class="refsect2" lang="en">
726
 
<a name="id3093771"></a><h3>
727
 
<a name="G-DATE-BAD-DAY:CAPS"></a>G_DATE_BAD_DAY</h3>
728
 
<a class="indexterm" name="id3093784"></a><pre class="programlisting">#define G_DATE_BAD_DAY    0U
 
698
<a name="G-DATE-BAD-DAY--CAPS"></a><h3>G_DATE_BAD_DAY</h3>
 
699
<pre class="programlisting">#define G_DATE_BAD_DAY    0U
729
700
</pre>
730
701
<p>
731
 
Represents an invalid <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay"><span class="type">GDateDay</span></a>.
 
702
Represents an invalid <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="type">GDateDay</span></a>.
732
703
</p>
733
704
</div>
734
705
<hr>
735
706
<div class="refsect2" lang="en">
736
 
<a name="id3093807"></a><h3>
737
 
<a name="G-DATE-BAD-JULIAN:CAPS"></a>G_DATE_BAD_JULIAN</h3>
738
 
<a class="indexterm" name="id3093820"></a><pre class="programlisting">#define G_DATE_BAD_JULIAN 0U
 
707
<a name="G-DATE-BAD-JULIAN--CAPS"></a><h3>G_DATE_BAD_JULIAN</h3>
 
708
<pre class="programlisting">#define G_DATE_BAD_JULIAN 0U
739
709
</pre>
740
710
<p>
741
711
Represents an invalid Julian day number.
743
713
</div>
744
714
<hr>
745
715
<div class="refsect2" lang="en">
746
 
<a name="id3093837"></a><h3>
747
 
<a name="G-DATE-BAD-YEAR:CAPS"></a>G_DATE_BAD_YEAR</h3>
748
 
<a class="indexterm" name="id3093850"></a><pre class="programlisting">#define G_DATE_BAD_YEAR   0U
 
716
<a name="G-DATE-BAD-YEAR--CAPS"></a><h3>G_DATE_BAD_YEAR</h3>
 
717
<pre class="programlisting">#define G_DATE_BAD_YEAR   0U
749
718
</pre>
750
719
<p>
751
720
Represents an invalid year.
753
722
</div>
754
723
<hr>
755
724
<div class="refsect2" lang="en">
756
 
<a name="id3093866"></a><h3>
757
 
<a name="g-date-new"></a>g_date_new ()</h3>
758
 
<a class="indexterm" name="id3093878"></a><pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a>*              g_date_new                          (void);</pre>
 
725
<a name="g-date-new"></a><h3>g_date_new ()</h3>
 
726
<pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a>*              g_date_new                          (void);</pre>
759
727
<p>
760
 
Allocates a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> and initializes it to a sane state. The new date will
761
 
be cleared (as if you'd called <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear"><code class="function">g_date_clear()</code></a>) but invalid (it won't
762
 
represent an existing day). Free the return value with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-free"><code class="function">g_date_free()</code></a>.
 
728
Allocates a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> and initializes it to a sane state. The new date will
 
729
be cleared (as if you'd called <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()"><code class="function">g_date_clear()</code></a>) but invalid (it won't
 
730
represent an existing day). Free the return value with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-free" title="g_date_free ()"><code class="function">g_date_free()</code></a>.
763
731
</p>
764
732
<div class="variablelist"><table border="0">
765
733
<col align="left" valign="top">
766
734
<tbody><tr>
767
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
768
 
<td>a newly-allocated <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
769
 
 
770
 
 
 
735
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
736
<td>a newly-allocated <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
771
737
</td>
772
738
</tr></tbody>
773
739
</table></div>
774
740
</div>
775
741
<hr>
776
742
<div class="refsect2" lang="en">
777
 
<a name="id3093954"></a><h3>
778
 
<a name="g-date-new-dmy"></a>g_date_new_dmy ()</h3>
779
 
<a class="indexterm" name="id3093966"></a><pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a>*              g_date_new_dmy                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a> day,
780
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a> month,
781
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);</pre>
 
743
<a name="g-date-new-dmy"></a><h3>g_date_new_dmy ()</h3>
 
744
<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,
 
745
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month,
 
746
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);</pre>
782
747
<p>
783
 
Like <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new"><code class="function">g_date_new()</code></a>, but also sets the value of the date. Assuming the
 
748
Like <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()"><code class="function">g_date_new()</code></a>, but also sets the value of the date. Assuming the
784
749
day-month-year triplet you pass in represents an existing day, the
785
750
returned date will be valid.
786
751
</p>
788
753
<col align="left" valign="top">
789
754
<tbody>
790
755
<tr>
791
 
<td><p><span class="term"><em class="parameter"><code>day</code></em>&#160;:</span></p></td>
 
756
<td><p><span class="term"><em class="parameter"><code>day</code></em> :</span></p></td>
792
757
<td>day of the month
793
758
</td>
794
759
</tr>
795
760
<tr>
796
 
<td><p><span class="term"><em class="parameter"><code>month</code></em>&#160;:</span></p></td>
 
761
<td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
797
762
<td>month of the year
798
763
</td>
799
764
</tr>
800
765
<tr>
801
 
<td><p><span class="term"><em class="parameter"><code>year</code></em>&#160;:</span></p></td>
 
766
<td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
802
767
<td>year
803
768
</td>
804
769
</tr>
805
770
<tr>
806
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
807
 
<td>a newly-allocated <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> initialized with <em class="parameter"><code>day</code></em>, <em class="parameter"><code>month</code></em>, and <em class="parameter"><code>year</code></em>
808
 
 
809
 
 
 
771
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
772
<td>a newly-allocated <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> initialized with <em class="parameter"><code>day</code></em>, <em class="parameter"><code>month</code></em>, and <em class="parameter"><code>year</code></em>
810
773
</td>
811
774
</tr>
812
775
</tbody>
814
777
</div>
815
778
<hr>
816
779
<div class="refsect2" lang="en">
817
 
<a name="id3094105"></a><h3>
818
 
<a name="g-date-new-julian"></a>g_date_new_julian ()</h3>
819
 
<a class="indexterm" name="id3094118"></a><pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a>*              g_date_new_julian                   (<a class="link" href="glib-Basic-Types.html#guint32">guint32</a> julian_day);</pre>
 
780
<a name="g-date-new-julian"></a><h3>g_date_new_julian ()</h3>
 
781
<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>
820
782
<p>
821
 
Like <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new"><code class="function">g_date_new()</code></a>, but also sets the value of the date. Assuming the
 
783
Like <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()"><code class="function">g_date_new()</code></a>, but also sets the value of the date. Assuming the
822
784
Julian day number you pass in is valid (greater than 0, less than an
823
785
unreasonably large number), the returned date will be valid.
824
786
</p>
826
788
<col align="left" valign="top">
827
789
<tbody>
828
790
<tr>
829
 
<td><p><span class="term"><em class="parameter"><code>julian_day</code></em>&#160;:</span></p></td>
 
791
<td><p><span class="term"><em class="parameter"><code>julian_day</code></em> :</span></p></td>
830
792
<td>days since January 1, Year 1
831
793
</td>
832
794
</tr>
833
795
<tr>
834
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
835
 
<td>a newly-allocated <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> initialized with <em class="parameter"><code>julian_day</code></em>
836
 
 
837
 
 
 
796
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
797
<td>a newly-allocated <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> initialized with <em class="parameter"><code>julian_day</code></em>
838
798
</td>
839
799
</tr>
840
800
</tbody>
842
802
</div>
843
803
<hr>
844
804
<div class="refsect2" lang="en">
845
 
<a name="id3094202"></a><h3>
846
 
<a name="g-date-clear"></a>g_date_clear ()</h3>
847
 
<a class="indexterm" name="id3094215"></a><pre class="programlisting">void                g_date_clear                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
848
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_dates);</pre>
 
805
<a name="g-date-clear"></a><h3>g_date_clear ()</h3>
 
806
<pre class="programlisting">void                g_date_clear                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
807
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_dates);</pre>
849
808
<p>
850
 
Initializes one or more <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> structs to a sane but invalid
 
809
Initializes one or more <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> structs to a sane but invalid
851
810
state. The cleared dates will not represent an existing date, but will
852
811
not contain garbage. Useful to init a date declared on the stack.
853
 
Validity can be tested with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid"><code class="function">g_date_valid()</code></a>.
 
812
Validity can be tested with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid" title="g_date_valid ()"><code class="function">g_date_valid()</code></a>.
854
813
</p>
855
814
<div class="variablelist"><table border="0">
856
815
<col align="left" valign="top">
857
816
<tbody>
858
817
<tr>
859
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
 
818
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
860
819
<td>pointer to one or more dates to clear
861
820
</td>
862
821
</tr>
863
822
<tr>
864
 
<td><p><span class="term"><em class="parameter"><code>n_dates</code></em>&#160;:</span></p></td>
 
823
<td><p><span class="term"><em class="parameter"><code>n_dates</code></em> :</span></p></td>
865
824
<td>number of dates to clear
866
 
 
867
 
 
868
825
</td>
869
826
</tr>
870
827
</tbody>
872
829
</div>
873
830
<hr>
874
831
<div class="refsect2" lang="en">
875
 
<a name="id3094306"></a><h3>
876
 
<a name="g-date-free"></a>g_date_free ()</h3>
877
 
<a class="indexterm" name="id3094318"></a><pre class="programlisting">void                g_date_free                         (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
 
832
<a name="g-date-free"></a><h3>g_date_free ()</h3>
 
833
<pre class="programlisting">void                g_date_free                         (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
878
834
<p>
879
 
Frees a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> returned from <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new"><code class="function">g_date_new()</code></a>.
 
835
Frees a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> returned from <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()"><code class="function">g_date_new()</code></a>.
880
836
</p>
881
837
<div class="variablelist"><table border="0">
882
838
<col align="left" valign="top">
883
839
<tbody><tr>
884
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
885
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
886
 
 
887
 
 
 
840
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
841
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
888
842
</td>
889
843
</tr></tbody>
890
844
</table></div>
891
845
</div>
892
846
<hr>
893
847
<div class="refsect2" lang="en">
894
 
<a name="id3094390"></a><h3>
895
 
<a name="g-date-set-day"></a>g_date_set_day ()</h3>
896
 
<a class="indexterm" name="id3094403"></a><pre class="programlisting">void                g_date_set_day                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
897
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a> day);</pre>
 
848
<a name="g-date-set-day"></a><h3>g_date_set_day ()</h3>
 
849
<pre class="programlisting">void                g_date_set_day                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
850
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a> day);</pre>
898
851
<p>
899
 
Sets the day of the month for a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>. If the resulting day-month-year
 
852
Sets the day of the month for a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>. If the resulting day-month-year
900
853
triplet is invalid, the date will be invalid.
901
854
</p>
902
855
<div class="variablelist"><table border="0">
903
856
<col align="left" valign="top">
904
857
<tbody>
905
858
<tr>
906
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
907
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
 
859
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
860
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
908
861
</td>
909
862
</tr>
910
863
<tr>
911
 
<td><p><span class="term"><em class="parameter"><code>day</code></em>&#160;:</span></p></td>
 
864
<td><p><span class="term"><em class="parameter"><code>day</code></em> :</span></p></td>
912
865
<td>day to set
913
 
 
914
 
 
915
866
</td>
916
867
</tr>
917
868
</tbody>
919
870
</div>
920
871
<hr>
921
872
<div class="refsect2" lang="en">
922
 
<a name="id3094488"></a><h3>
923
 
<a name="g-date-set-month"></a>g_date_set_month ()</h3>
924
 
<a class="indexterm" name="id3094501"></a><pre class="programlisting">void                g_date_set_month                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
925
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a> month);</pre>
 
873
<a name="g-date-set-month"></a><h3>g_date_set_month ()</h3>
 
874
<pre class="programlisting">void                g_date_set_month                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
875
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month);</pre>
926
876
<p>
927
 
Sets the month of the year for a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>.  If the resulting
 
877
Sets the month of the year for a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>.  If the resulting
928
878
day-month-year triplet is invalid, the date will be invalid.
929
879
</p>
930
880
<div class="variablelist"><table border="0">
931
881
<col align="left" valign="top">
932
882
<tbody>
933
883
<tr>
934
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
935
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
 
884
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
885
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
936
886
</td>
937
887
</tr>
938
888
<tr>
939
 
<td><p><span class="term"><em class="parameter"><code>month</code></em>&#160;:</span></p></td>
 
889
<td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
940
890
<td>month to set
941
 
 
942
 
 
943
891
</td>
944
892
</tr>
945
893
</tbody>
947
895
</div>
948
896
<hr>
949
897
<div class="refsect2" lang="en">
950
 
<a name="id3094586"></a><h3>
951
 
<a name="g-date-set-year"></a>g_date_set_year ()</h3>
952
 
<a class="indexterm" name="id3094599"></a><pre class="programlisting">void                g_date_set_year                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
953
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);</pre>
 
898
<a name="g-date-set-year"></a><h3>g_date_set_year ()</h3>
 
899
<pre class="programlisting">void                g_date_set_year                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
900
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);</pre>
954
901
<p>
955
 
Sets the year for a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>. If the resulting day-month-year triplet is
 
902
Sets the year for a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>. If the resulting day-month-year triplet is
956
903
invalid, the date will be invalid.
957
904
</p>
958
905
<div class="variablelist"><table border="0">
959
906
<col align="left" valign="top">
960
907
<tbody>
961
908
<tr>
962
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
963
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
 
909
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
910
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
964
911
</td>
965
912
</tr>
966
913
<tr>
967
 
<td><p><span class="term"><em class="parameter"><code>year</code></em>&#160;:</span></p></td>
 
914
<td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
968
915
<td>year to set
969
 
 
970
 
 
971
916
</td>
972
917
</tr>
973
918
</tbody>
975
920
</div>
976
921
<hr>
977
922
<div class="refsect2" lang="en">
978
 
<a name="id3094684"></a><h3>
979
 
<a name="g-date-set-dmy"></a>g_date_set_dmy ()</h3>
980
 
<a class="indexterm" name="id3094696"></a><pre class="programlisting">void                g_date_set_dmy                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
981
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a> day,
982
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a> month,
983
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> y);</pre>
 
923
<a name="g-date-set-dmy"></a><h3>g_date_set_dmy ()</h3>
 
924
<pre class="programlisting">void                g_date_set_dmy                      (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
925
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a> day,
 
926
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month,
 
927
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> y);</pre>
984
928
<p>
985
 
Sets the value of a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> from a day, month, and year. The day-month-year 
986
 
triplet must be valid; if you aren't sure it is, call <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-dmy"><code class="function">g_date_valid_dmy()</code></a> to
 
929
Sets the value of a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> from a day, month, and year. The day-month-year
 
930
triplet must be valid; if you aren't sure it is, call <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-dmy" title="g_date_valid_dmy ()"><code class="function">g_date_valid_dmy()</code></a> to
987
931
check before you set it.
988
932
</p>
989
933
<div class="variablelist"><table border="0">
990
934
<col align="left" valign="top">
991
935
<tbody>
992
936
<tr>
993
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
994
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
 
937
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
938
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
995
939
</td>
996
940
</tr>
997
941
<tr>
998
 
<td><p><span class="term"><em class="parameter"><code>day</code></em>&#160;:</span></p></td>
 
942
<td><p><span class="term"><em class="parameter"><code>day</code></em> :</span></p></td>
999
943
<td>day
1000
944
</td>
1001
945
</tr>
1002
946
<tr>
1003
 
<td><p><span class="term"><em class="parameter"><code>month</code></em>&#160;:</span></p></td>
 
947
<td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
1004
948
<td>month
1005
949
</td>
1006
950
</tr>
1007
951
<tr>
1008
 
<td><p><span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></p></td>
 
952
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
1009
953
<td>year
1010
 
 
1011
 
 
1012
954
</td>
1013
955
</tr>
1014
956
</tbody>
1016
958
</div>
1017
959
<hr>
1018
960
<div class="refsect2" lang="en">
1019
 
<a name="id3094836"></a><h3>
1020
 
<a name="g-date-set-julian"></a>g_date_set_julian ()</h3>
1021
 
<a class="indexterm" name="id3094849"></a><pre class="programlisting">void                g_date_set_julian                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
1022
 
                                                         <a class="link" href="glib-Basic-Types.html#guint32">guint32</a> julian_date);</pre>
 
961
<a name="g-date-set-julian"></a><h3>g_date_set_julian ()</h3>
 
962
<pre class="programlisting">void                g_date_set_julian                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
963
                                                         <a class="link" href="glib-Basic-Types.html#guint32" title="guint32">guint32</a> julian_date);</pre>
1023
964
<p>
1024
 
Sets the value of a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> from a Julian day number.
 
965
Sets the value of a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> from a Julian day number.
1025
966
</p>
1026
967
<div class="variablelist"><table border="0">
1027
968
<col align="left" valign="top">
1028
969
<tbody>
1029
970
<tr>
1030
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1031
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
 
971
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
972
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1032
973
</td>
1033
974
</tr>
1034
975
<tr>
1035
 
<td><p><span class="term"><em class="parameter"><code>julian_date</code></em>&#160;:</span></p></td>
 
976
<td><p><span class="term"><em class="parameter"><code>julian_date</code></em> :</span></p></td>
1036
977
<td>Julian day number (days since January 1, Year 1)
1037
 
 
1038
 
 
1039
978
</td>
1040
979
</tr>
1041
980
</tbody>
1043
982
</div>
1044
983
<hr>
1045
984
<div class="refsect2" lang="en">
1046
 
<a name="id3094933"></a><h3>
1047
 
<a name="g-date-set-time"></a>g_date_set_time ()</h3>
1048
 
<a class="indexterm" name="id3094948"></a><pre class="programlisting">void                g_date_set_time                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
1049
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTime">GTime</a> time_);</pre>
 
985
<a name="g-date-set-time"></a><h3>g_date_set_time ()</h3>
 
986
<pre class="programlisting">void                g_date_set_time                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
987
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime">GTime</a> time_);</pre>
1050
988
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1051
989
<h3 class="title">Warning</h3>
1052
990
<p><code class="literal">g_date_set_time</code> is deprecated and should not be used in newly-written code.</p>
1053
991
</div>
1054
992
<p>
1055
 
Sets the value of a date from a <a class="link" href="glib-Date-and-Time-Functions.html#GTime"><span class="type">GTime</span></a> value. 
 
993
Sets the value of a date from a <a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime"><span class="type">GTime</span></a> value.
 
994
The time to date conversion is done using the user's current timezone.
1056
995
</p>
1057
996
<p>
1058
 
<em class="parameter"><code>Deprecated</code></em>:2.10: Use <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-time-t"><code class="function">g_date_set_time_t()</code></a> instead.</p>
 
997
<em class="parameter"><code>Deprecated</code></em>:2.10: Use <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-time-t" title="g_date_set_time_t ()"><code class="function">g_date_set_time_t()</code></a> instead.</p>
1059
998
<p>
1060
 
 
1061
999
</p>
1062
1000
<div class="variablelist"><table border="0">
1063
1001
<col align="left" valign="top">
1064
1002
<tbody>
1065
1003
<tr>
1066
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1067
 
<td> a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>.
 
1004
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1005
<td> a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>.
1068
1006
</td>
1069
1007
</tr>
1070
1008
<tr>
1071
 
<td><p><span class="term"><em class="parameter"><code>time_</code></em>&#160;:</span></p></td>
1072
 
<td> <a class="link" href="glib-Date-and-Time-Functions.html#GTime"><span class="type">GTime</span></a> value to set.
 
1009
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
 
1010
<td> <a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime"><span class="type">GTime</span></a> value to set.
1073
1011
</td>
1074
1012
</tr>
1075
1013
</tbody>
1077
1015
</div>
1078
1016
<hr>
1079
1017
<div class="refsect2" lang="en">
1080
 
<a name="id3095076"></a><h3>
1081
 
<a name="g-date-set-time-t"></a>g_date_set_time_t ()</h3>
1082
 
<a class="indexterm" name="id3095091"></a><pre class="programlisting">void                g_date_set_time_t                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
 
1018
<a name="g-date-set-time-t"></a><h3>g_date_set_time_t ()</h3>
 
1019
<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,
1083
1020
                                                         time_t timet);</pre>
1084
1021
<p>
1085
 
Sets the value of a date from a <span class="type">time_t</span> value. 
 
1022
Sets the value of a date to the date corresponding to a time 
 
1023
specified as a time_t. The time to date conversion is done using 
 
1024
the user's current timezone.
1086
1025
</p>
1087
1026
<p>
1088
1027
To set the value of a date to the current day, you could write:
1091
1030
 g_date_set_time_t (date, time (NULL)); 
1092
1031
</pre></div>
1093
1032
<p>
1094
 
 
1095
1033
</p>
1096
1034
<div class="variablelist"><table border="0">
1097
1035
<col align="left" valign="top">
1098
1036
<tbody>
1099
1037
<tr>
1100
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1101
 
<td> a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> 
 
1038
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1039
<td> a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> 
1102
1040
</td>
1103
1041
</tr>
1104
1042
<tr>
1105
 
<td><p><span class="term"><em class="parameter"><code>timet</code></em>&#160;:</span></p></td>
 
1043
<td><p><span class="term"><em class="parameter"><code>timet</code></em> :</span></p></td>
1106
1044
<td> <span class="type">time_t</span> value to set
1107
1045
</td>
1108
1046
</tr>
1109
1047
</tbody>
1110
1048
</table></div>
1111
 
<p class="since">Since  2.10
1112
 
</p>
 
1049
<p class="since">Since 2.10</p>
1113
1050
</div>
1114
1051
<hr>
1115
1052
<div class="refsect2" lang="en">
1116
 
<a name="id3095195"></a><h3>
1117
 
<a name="g-date-set-time-val"></a>g_date_set_time_val ()</h3>
1118
 
<a class="indexterm" name="id3095211"></a><pre class="programlisting">void                g_date_set_time_val                 (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
1119
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal">GTimeVal</a> *timeval);</pre>
 
1053
<a name="g-date-set-time-val"></a><h3>g_date_set_time_val ()</h3>
 
1054
<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,
 
1055
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a> *timeval);</pre>
1120
1056
<p>
1121
 
Sets the value of a date from a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> value.  Note that the
1122
 
<em class="parameter"><code>tv_usec</code></em> member is ignored, because <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> can't make use of the
 
1057
Sets the value of a date from a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> value.  Note that the
 
1058
<em class="parameter"><code>tv_usec</code></em> member is ignored, because <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> can't make use of the
1123
1059
additional precision.</p>
1124
1060
<p>
1125
 
 
1126
1061
</p>
1127
1062
<div class="variablelist"><table border="0">
1128
1063
<col align="left" valign="top">
1129
1064
<tbody>
1130
1065
<tr>
1131
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1132
 
<td> a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> 
 
1066
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1067
<td> a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> 
1133
1068
</td>
1134
1069
</tr>
1135
1070
<tr>
1136
 
<td><p><span class="term"><em class="parameter"><code>timeval</code></em>&#160;:</span></p></td>
1137
 
<td> <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> value to set
 
1071
<td><p><span class="term"><em class="parameter"><code>timeval</code></em> :</span></p></td>
 
1072
<td> <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> value to set
1138
1073
</td>
1139
1074
</tr>
1140
1075
</tbody>
1141
1076
</table></div>
1142
 
<p class="since">Since  2.10
1143
 
</p>
 
1077
<p class="since">Since 2.10</p>
1144
1078
</div>
1145
1079
<hr>
1146
1080
<div class="refsect2" lang="en">
1147
 
<a name="id3095328"></a><h3>
1148
 
<a name="g-date-set-parse"></a>g_date_set_parse ()</h3>
1149
 
<a class="indexterm" name="id3095340"></a><pre class="programlisting">void                g_date_set_parse                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
1150
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str);</pre>
 
1081
<a name="g-date-set-parse"></a><h3>g_date_set_parse ()</h3>
 
1082
<pre class="programlisting">void                g_date_set_parse                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
1083
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *str);</pre>
1151
1084
<p>
1152
1085
Parses a user-inputted string <em class="parameter"><code>str</code></em>, and try to figure out what date it
1153
 
represents, taking the <a class="link" href="glib-running.html#setlocale" title="Locale">current locale</a> 
1154
 
into account. If the string is successfully parsed, the date will be 
1155
 
valid after the call. Otherwise, it will be invalid. You should check 
1156
 
using <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid"><code class="function">g_date_valid()</code></a> to see whether the parsing succeeded.
 
1086
represents, taking the <a class="link" href="glib-running.html#setlocale" title="Locale">current locale</a>
 
1087
into account. If the string is successfully parsed, the date will be
 
1088
valid after the call. Otherwise, it will be invalid. You should check
 
1089
using <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid" title="g_date_valid ()"><code class="function">g_date_valid()</code></a> to see whether the parsing succeeded.
1157
1090
</p>
1158
1091
<p>
1159
1092
This function is not appropriate for file formats and the like; it
1166
1099
<col align="left" valign="top">
1167
1100
<tbody>
1168
1101
<tr>
1169
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1170
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to fill in
 
1102
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1103
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to fill in
1171
1104
</td>
1172
1105
</tr>
1173
1106
<tr>
1174
 
<td><p><span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></p></td>
 
1107
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
1175
1108
<td>string to parse
1176
 
 
1177
 
 
1178
1109
</td>
1179
1110
</tr>
1180
1111
</tbody>
1182
1113
</div>
1183
1114
<hr>
1184
1115
<div class="refsect2" lang="en">
1185
 
<a name="id3095452"></a><h3>
1186
 
<a name="g-date-add-days"></a>g_date_add_days ()</h3>
1187
 
<a class="indexterm" name="id3095465"></a><pre class="programlisting">void                g_date_add_days                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
1188
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_days);</pre>
 
1116
<a name="g-date-add-days"></a><h3>g_date_add_days ()</h3>
 
1117
<pre class="programlisting">void                g_date_add_days                     (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
1118
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_days);</pre>
1189
1119
<p>
1190
1120
Increments a date some number of days. To move forward by weeks, add
1191
1121
weeks*7 days. The date must be valid.
1194
1124
<col align="left" valign="top">
1195
1125
<tbody>
1196
1126
<tr>
1197
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1198
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to increment
 
1127
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1128
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to increment
1199
1129
</td>
1200
1130
</tr>
1201
1131
<tr>
1202
 
<td><p><span class="term"><em class="parameter"><code>n_days</code></em>&#160;:</span></p></td>
 
1132
<td><p><span class="term"><em class="parameter"><code>n_days</code></em> :</span></p></td>
1203
1133
<td>number of days to move the date forward
1204
 
 
1205
 
 
1206
1134
</td>
1207
1135
</tr>
1208
1136
</tbody>
1210
1138
</div>
1211
1139
<hr>
1212
1140
<div class="refsect2" lang="en">
1213
 
<a name="id3095543"></a><h3>
1214
 
<a name="g-date-subtract-days"></a>g_date_subtract_days ()</h3>
1215
 
<a class="indexterm" name="id3095557"></a><pre class="programlisting">void                g_date_subtract_days                (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
1216
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_days);</pre>
 
1141
<a name="g-date-subtract-days"></a><h3>g_date_subtract_days ()</h3>
 
1142
<pre class="programlisting">void                g_date_subtract_days                (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
1143
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_days);</pre>
1217
1144
<p>
1218
1145
Moves a date some number of days into the past. To move by weeks, just
1219
1146
move by weeks*7 days. The date must be valid.
1222
1149
<col align="left" valign="top">
1223
1150
<tbody>
1224
1151
<tr>
1225
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1226
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to decrement
 
1152
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1153
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to decrement
1227
1154
</td>
1228
1155
</tr>
1229
1156
<tr>
1230
 
<td><p><span class="term"><em class="parameter"><code>n_days</code></em>&#160;:</span></p></td>
 
1157
<td><p><span class="term"><em class="parameter"><code>n_days</code></em> :</span></p></td>
1231
1158
<td>number of days to move
1232
 
 
1233
 
 
1234
1159
</td>
1235
1160
</tr>
1236
1161
</tbody>
1238
1163
</div>
1239
1164
<hr>
1240
1165
<div class="refsect2" lang="en">
1241
 
<a name="id3095635"></a><h3>
1242
 
<a name="g-date-add-months"></a>g_date_add_months ()</h3>
1243
 
<a class="indexterm" name="id3095648"></a><pre class="programlisting">void                g_date_add_months                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
1244
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_months);</pre>
 
1166
<a name="g-date-add-months"></a><h3>g_date_add_months ()</h3>
 
1167
<pre class="programlisting">void                g_date_add_months                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
1168
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_months);</pre>
1245
1169
<p>
1246
1170
Increments a date by some number of months. If the day of the month is
1247
1171
greater than 28, this routine may change the day of the month (because
1252
1176
<col align="left" valign="top">
1253
1177
<tbody>
1254
1178
<tr>
1255
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1256
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to increment
 
1179
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1180
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to increment
1257
1181
</td>
1258
1182
</tr>
1259
1183
<tr>
1260
 
<td><p><span class="term"><em class="parameter"><code>n_months</code></em>&#160;:</span></p></td>
 
1184
<td><p><span class="term"><em class="parameter"><code>n_months</code></em> :</span></p></td>
1261
1185
<td>number of months to move forward
1262
 
 
1263
 
 
1264
1186
</td>
1265
1187
</tr>
1266
1188
</tbody>
1268
1190
</div>
1269
1191
<hr>
1270
1192
<div class="refsect2" lang="en">
1271
 
<a name="id3095728"></a><h3>
1272
 
<a name="g-date-subtract-months"></a>g_date_subtract_months ()</h3>
1273
 
<a class="indexterm" name="id3095741"></a><pre class="programlisting">void                g_date_subtract_months              (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
1274
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_months);</pre>
 
1193
<a name="g-date-subtract-months"></a><h3>g_date_subtract_months ()</h3>
 
1194
<pre class="programlisting">void                g_date_subtract_months              (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
1195
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_months);</pre>
1275
1196
<p>
1276
1197
Moves a date some number of months into the past. If the current day of
1277
1198
the month doesn't exist in the destination month, the day of the month
1281
1202
<col align="left" valign="top">
1282
1203
<tbody>
1283
1204
<tr>
1284
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1285
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to decrement
 
1205
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1206
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to decrement
1286
1207
</td>
1287
1208
</tr>
1288
1209
<tr>
1289
 
<td><p><span class="term"><em class="parameter"><code>n_months</code></em>&#160;:</span></p></td>
 
1210
<td><p><span class="term"><em class="parameter"><code>n_months</code></em> :</span></p></td>
1290
1211
<td>number of months to move
1291
 
 
1292
 
 
1293
1212
</td>
1294
1213
</tr>
1295
1214
</tbody>
1297
1216
</div>
1298
1217
<hr>
1299
1218
<div class="refsect2" lang="en">
1300
 
<a name="id3095820"></a><h3>
1301
 
<a name="g-date-add-years"></a>g_date_add_years ()</h3>
1302
 
<a class="indexterm" name="id3095833"></a><pre class="programlisting">void                g_date_add_years                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
1303
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_years);</pre>
 
1219
<a name="g-date-add-years"></a><h3>g_date_add_years ()</h3>
 
1220
<pre class="programlisting">void                g_date_add_years                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
1221
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_years);</pre>
1304
1222
<p>
1305
1223
Increments a date by some number of years. If the date is February 29,
1306
1224
and the destination year is not a leap year, the date will be changed
1310
1228
<col align="left" valign="top">
1311
1229
<tbody>
1312
1230
<tr>
1313
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1314
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to increment
 
1231
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1232
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to increment
1315
1233
</td>
1316
1234
</tr>
1317
1235
<tr>
1318
 
<td><p><span class="term"><em class="parameter"><code>n_years</code></em>&#160;:</span></p></td>
 
1236
<td><p><span class="term"><em class="parameter"><code>n_years</code></em> :</span></p></td>
1319
1237
<td>number of years to move forward
1320
 
 
1321
 
 
1322
1238
</td>
1323
1239
</tr>
1324
1240
</tbody>
1326
1242
</div>
1327
1243
<hr>
1328
1244
<div class="refsect2" lang="en">
1329
 
<a name="id3095912"></a><h3>
1330
 
<a name="g-date-subtract-years"></a>g_date_subtract_years ()</h3>
1331
 
<a class="indexterm" name="id3095925"></a><pre class="programlisting">void                g_date_subtract_years               (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
1332
 
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n_years);</pre>
 
1245
<a name="g-date-subtract-years"></a><h3>g_date_subtract_years ()</h3>
 
1246
<pre class="programlisting">void                g_date_subtract_years               (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
1247
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n_years);</pre>
1333
1248
<p>
1334
1249
Moves a date some number of years into the past. If the current day
1335
1250
doesn't exist in the destination year (i.e. it's February 29 and you
1340
1255
<col align="left" valign="top">
1341
1256
<tbody>
1342
1257
<tr>
1343
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1344
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to decrement
 
1258
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1259
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to decrement
1345
1260
</td>
1346
1261
</tr>
1347
1262
<tr>
1348
 
<td><p><span class="term"><em class="parameter"><code>n_years</code></em>&#160;:</span></p></td>
 
1263
<td><p><span class="term"><em class="parameter"><code>n_years</code></em> :</span></p></td>
1349
1264
<td>number of years to move
1350
 
 
1351
 
 
1352
1265
</td>
1353
1266
</tr>
1354
1267
</tbody>
1356
1269
</div>
1357
1270
<hr>
1358
1271
<div class="refsect2" lang="en">
1359
 
<a name="id3096005"></a><h3>
1360
 
<a name="g-date-days-between"></a>g_date_days_between ()</h3>
1361
 
<a class="indexterm" name="id3096018"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_date_days_between                 (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date1,
1362
 
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date2);</pre>
 
1272
<a name="g-date-days-between"></a><h3>g_date_days_between ()</h3>
 
1273
<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,
 
1274
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date2);</pre>
1363
1275
<p>
1364
1276
Computes the number of days between two dates.
1365
1277
If <em class="parameter"><code>date2</code></em> is prior to <em class="parameter"><code>date1</code></em>, the returned value is negative.
1369
1281
<col align="left" valign="top">
1370
1282
<tbody>
1371
1283
<tr>
1372
 
<td><p><span class="term"><em class="parameter"><code>date1</code></em>&#160;:</span></p></td>
 
1284
<td><p><span class="term"><em class="parameter"><code>date1</code></em> :</span></p></td>
1373
1285
<td>the first date
1374
1286
</td>
1375
1287
</tr>
1376
1288
<tr>
1377
 
<td><p><span class="term"><em class="parameter"><code>date2</code></em>&#160;:</span></p></td>
 
1289
<td><p><span class="term"><em class="parameter"><code>date2</code></em> :</span></p></td>
1378
1290
<td>the second date
1379
1291
</td>
1380
1292
</tr>
1381
1293
<tr>
1382
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1294
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1383
1295
<td>the number of days between <em class="parameter"><code>date1</code></em> and <em class="parameter"><code>date2</code></em>
1384
 
 
1385
 
 
1386
1296
</td>
1387
1297
</tr>
1388
1298
</tbody>
1390
1300
</div>
1391
1301
<hr>
1392
1302
<div class="refsect2" lang="en">
1393
 
<a name="id3096123"></a><h3>
1394
 
<a name="g-date-compare"></a>g_date_compare ()</h3>
1395
 
<a class="indexterm" name="id3096136"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_date_compare                      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *lhs,
1396
 
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *rhs);</pre>
 
1303
<a name="g-date-compare"></a><h3>g_date_compare ()</h3>
 
1304
<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,
 
1305
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *rhs);</pre>
1397
1306
<p>
1398
1307
<code class="function">qsort()</code>-style comparsion function for dates. Both
1399
1308
dates must be valid.
1402
1311
<col align="left" valign="top">
1403
1312
<tbody>
1404
1313
<tr>
1405
 
<td><p><span class="term"><em class="parameter"><code>lhs</code></em>&#160;:</span></p></td>
 
1314
<td><p><span class="term"><em class="parameter"><code>lhs</code></em> :</span></p></td>
1406
1315
<td>first date to compare
1407
1316
</td>
1408
1317
</tr>
1409
1318
<tr>
1410
 
<td><p><span class="term"><em class="parameter"><code>rhs</code></em>&#160;:</span></p></td>
 
1319
<td><p><span class="term"><em class="parameter"><code>rhs</code></em> :</span></p></td>
1411
1320
<td>second date to compare
1412
1321
</td>
1413
1322
</tr>
1414
1323
<tr>
1415
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1324
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1416
1325
<td>0 for equal, less than zero if <em class="parameter"><code>lhs</code></em> is less than <em class="parameter"><code>rhs</code></em>,
1417
1326
    greater than zero if <em class="parameter"><code>lhs</code></em> is greater than <em class="parameter"><code>rhs</code></em>
1418
 
 
1419
 
 
1420
1327
</td>
1421
1328
</tr>
1422
1329
</tbody>
1424
1331
</div>
1425
1332
<hr>
1426
1333
<div class="refsect2" lang="en">
1427
 
<a name="id3096251"></a><h3>
1428
 
<a name="g-date-clamp"></a>g_date_clamp ()</h3>
1429
 
<a class="indexterm" name="id3096264"></a><pre class="programlisting">void                g_date_clamp                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
1430
 
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *min_date,
1431
 
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *max_date);</pre>
 
1334
<a name="g-date-clamp"></a><h3>g_date_clamp ()</h3>
 
1335
<pre class="programlisting">void                g_date_clamp                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date,
 
1336
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *min_date,
 
1337
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *max_date);</pre>
1432
1338
<p>
1433
1339
If <em class="parameter"><code>date</code></em> is prior to <em class="parameter"><code>min_date</code></em>, sets <em class="parameter"><code>date</code></em> equal to <em class="parameter"><code>min_date</code></em>.
1434
1340
If <em class="parameter"><code>date</code></em> falls after <em class="parameter"><code>max_date</code></em>, sets <em class="parameter"><code>date</code></em> equal to <em class="parameter"><code>max_date</code></em>.
1435
1341
Otherwise, <em class="parameter"><code>date</code></em> is unchanged.
1436
 
Either of <em class="parameter"><code>min_date</code></em> and <em class="parameter"><code>max_date</code></em> may be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.  All non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> dates
 
1342
Either of <em class="parameter"><code>min_date</code></em> and <em class="parameter"><code>max_date</code></em> may be <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>.  All non-<a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> dates
1437
1343
must be valid.
1438
1344
</p>
1439
1345
<div class="variablelist"><table border="0">
1440
1346
<col align="left" valign="top">
1441
1347
<tbody>
1442
1348
<tr>
1443
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1444
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to clamp
 
1349
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1350
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to clamp
1445
1351
</td>
1446
1352
</tr>
1447
1353
<tr>
1448
 
<td><p><span class="term"><em class="parameter"><code>min_date</code></em>&#160;:</span></p></td>
 
1354
<td><p><span class="term"><em class="parameter"><code>min_date</code></em> :</span></p></td>
1449
1355
<td>minimum accepted value for <em class="parameter"><code>date</code></em>
1450
1356
</td>
1451
1357
</tr>
1452
1358
<tr>
1453
 
<td><p><span class="term"><em class="parameter"><code>max_date</code></em>&#160;:</span></p></td>
 
1359
<td><p><span class="term"><em class="parameter"><code>max_date</code></em> :</span></p></td>
1454
1360
<td>maximum accepted value for <em class="parameter"><code>date</code></em>
1455
 
 
1456
 
 
1457
1361
</td>
1458
1362
</tr>
1459
1363
</tbody>
1461
1365
</div>
1462
1366
<hr>
1463
1367
<div class="refsect2" lang="en">
1464
 
<a name="id3096461"></a><h3>
1465
 
<a name="g-date-order"></a>g_date_order ()</h3>
1466
 
<a class="indexterm" name="id3096473"></a><pre class="programlisting">void                g_date_order                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date1,
1467
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date2);</pre>
 
1368
<a name="g-date-order"></a><h3>g_date_order ()</h3>
 
1369
<pre class="programlisting">void                g_date_order                        (<a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date1,
 
1370
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date2);</pre>
1468
1371
<p>
1469
1372
Checks if <em class="parameter"><code>date1</code></em> is less than or equal to <em class="parameter"><code>date2</code></em>,
1470
1373
and swap the values if this is not the case.
1473
1376
<col align="left" valign="top">
1474
1377
<tbody>
1475
1378
<tr>
1476
 
<td><p><span class="term"><em class="parameter"><code>date1</code></em>&#160;:</span></p></td>
 
1379
<td><p><span class="term"><em class="parameter"><code>date1</code></em> :</span></p></td>
1477
1380
<td>the first date
1478
1381
</td>
1479
1382
</tr>
1480
1383
<tr>
1481
 
<td><p><span class="term"><em class="parameter"><code>date2</code></em>&#160;:</span></p></td>
 
1384
<td><p><span class="term"><em class="parameter"><code>date2</code></em> :</span></p></td>
1482
1385
<td>the second date
1483
 
 
1484
 
 
1485
1386
</td>
1486
1387
</tr>
1487
1388
</tbody>
1489
1390
</div>
1490
1391
<hr>
1491
1392
<div class="refsect2" lang="en">
1492
 
<a name="id3096555"></a><h3>
1493
 
<a name="g-date-get-day"></a>g_date_get_day ()</h3>
1494
 
<a class="indexterm" name="id3096567"></a><pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a>            g_date_get_day                      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
 
1393
<a name="g-date-get-day"></a><h3>g_date_get_day ()</h3>
 
1394
<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>
1495
1395
<p>
1496
1396
Returns the day of the month. The date must be valid.
1497
1397
</p>
1499
1399
<col align="left" valign="top">
1500
1400
<tbody>
1501
1401
<tr>
1502
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1503
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to extract the day of the month from
 
1402
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1403
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to extract the day of the month from
1504
1404
</td>
1505
1405
</tr>
1506
1406
<tr>
1507
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1407
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1508
1408
<td>day of the month
1509
 
 
1510
 
 
1511
1409
</td>
1512
1410
</tr>
1513
1411
</tbody>
1515
1413
</div>
1516
1414
<hr>
1517
1415
<div class="refsect2" lang="en">
1518
 
<a name="id3096634"></a><h3>
1519
 
<a name="g-date-get-month"></a>g_date_get_month ()</h3>
1520
 
<a class="indexterm" name="id3096646"></a><pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a>          g_date_get_month                    (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
 
1416
<a name="g-date-get-month"></a><h3>g_date_get_month ()</h3>
 
1417
<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>
1521
1418
<p>
1522
1419
Returns the month of the year. The date must be valid.
1523
1420
</p>
1525
1422
<col align="left" valign="top">
1526
1423
<tbody>
1527
1424
<tr>
1528
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1529
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to get the month from
 
1425
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1426
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to get the month from
1530
1427
</td>
1531
1428
</tr>
1532
1429
<tr>
1533
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1534
 
<td>month of the year as a <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth"><span class="type">GDateMonth</span></a>
1535
 
 
1536
 
 
 
1430
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1431
<td>month of the year as a <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a>
1537
1432
</td>
1538
1433
</tr>
1539
1434
</tbody>
1541
1436
</div>
1542
1437
<hr>
1543
1438
<div class="refsect2" lang="en">
1544
 
<a name="id3096720"></a><h3>
1545
 
<a name="g-date-get-year"></a>g_date_get_year ()</h3>
1546
 
<a class="indexterm" name="id3096733"></a><pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a>           g_date_get_year                     (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
 
1439
<a name="g-date-get-year"></a><h3>g_date_get_year ()</h3>
 
1440
<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>
1547
1441
<p>
1548
 
Returns the year of a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>. The date must be valid.
 
1442
Returns the year of a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>. The date must be valid.
1549
1443
</p>
1550
1444
<div class="variablelist"><table border="0">
1551
1445
<col align="left" valign="top">
1552
1446
<tbody>
1553
1447
<tr>
1554
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1555
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
 
1448
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1449
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1556
1450
</td>
1557
1451
</tr>
1558
1452
<tr>
1559
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1453
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1560
1454
<td>year in which the date falls
1561
 
 
1562
 
 
1563
1455
</td>
1564
1456
</tr>
1565
1457
</tbody>
1567
1459
</div>
1568
1460
<hr>
1569
1461
<div class="refsect2" lang="en">
1570
 
<a name="id3096806"></a><h3>
1571
 
<a name="g-date-get-julian"></a>g_date_get_julian ()</h3>
1572
 
<a class="indexterm" name="id3096819"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint32">guint32</a>             g_date_get_julian                   (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
 
1462
<a name="g-date-get-julian"></a><h3>g_date_get_julian ()</h3>
 
1463
<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>
1573
1464
<p>
1574
 
Returns the Julian day or "serial number" of the <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>. The
 
1465
Returns the Julian day or "serial number" of the <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>. The
1575
1466
Julian day is simply the number of days since January 1, Year 1; i.e.,
1576
1467
January 1, Year 1 is Julian day 1; January 2, Year 1 is Julian day 2,
1577
1468
etc. The date must be valid.
1580
1471
<col align="left" valign="top">
1581
1472
<tbody>
1582
1473
<tr>
1583
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1584
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to extract the Julian day from
 
1474
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1475
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to extract the Julian day from
1585
1476
</td>
1586
1477
</tr>
1587
1478
<tr>
1588
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1479
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1589
1480
<td>Julian day
1590
 
 
1591
 
 
1592
1481
</td>
1593
1482
</tr>
1594
1483
</tbody>
1596
1485
</div>
1597
1486
<hr>
1598
1487
<div class="refsect2" lang="en">
1599
 
<a name="id3096896"></a><h3>
1600
 
<a name="g-date-get-weekday"></a>g_date_get_weekday ()</h3>
1601
 
<a class="indexterm" name="id3096909"></a><pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday">GDateWeekday</a>        g_date_get_weekday                  (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
 
1488
<a name="g-date-get-weekday"></a><h3>g_date_get_weekday ()</h3>
 
1489
<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>
1602
1490
<p>
1603
 
Returns the day of the week for a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>. The date must be valid.
 
1491
Returns the day of the week for a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>. The date must be valid.
1604
1492
</p>
1605
1493
<div class="variablelist"><table border="0">
1606
1494
<col align="left" valign="top">
1607
1495
<tbody>
1608
1496
<tr>
1609
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1610
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>.
 
1497
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1498
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>.
1611
1499
</td>
1612
1500
</tr>
1613
1501
<tr>
1614
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1615
 
<td>day of the week as a <a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday"><span class="type">GDateWeekday</span></a>.
1616
 
 
1617
 
 
 
1502
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1503
<td>day of the week as a <a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday"><span class="type">GDateWeekday</span></a>.
1618
1504
</td>
1619
1505
</tr>
1620
1506
</tbody>
1622
1508
</div>
1623
1509
<hr>
1624
1510
<div class="refsect2" lang="en">
1625
 
<a name="id3096991"></a><h3>
1626
 
<a name="g-date-get-day-of-year"></a>g_date_get_day_of_year ()</h3>
1627
 
<a class="indexterm" name="id3097004"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint">guint</a>               g_date_get_day_of_year              (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
 
1511
<a name="g-date-get-day-of-year"></a><h3>g_date_get_day_of_year ()</h3>
 
1512
<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>
1628
1513
<p>
1629
1514
Returns the day of the year, where Jan 1 is the first day of the
1630
1515
year. The date must be valid.
1633
1518
<col align="left" valign="top">
1634
1519
<tbody>
1635
1520
<tr>
1636
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1637
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to extract day of year from
 
1521
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1522
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to extract day of year from
1638
1523
</td>
1639
1524
</tr>
1640
1525
<tr>
1641
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1526
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1642
1527
<td>day of the year
1643
 
 
1644
 
 
1645
1528
</td>
1646
1529
</tr>
1647
1530
</tbody>
1649
1532
</div>
1650
1533
<hr>
1651
1534
<div class="refsect2" lang="en">
1652
 
<a name="id3097070"></a><h3>
1653
 
<a name="g-date-get-days-in-month"></a>g_date_get_days_in_month ()</h3>
1654
 
<a class="indexterm" name="id3097084"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint8">guint8</a>              g_date_get_days_in_month            (<a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a> month,
1655
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);</pre>
 
1535
<a name="g-date-get-days-in-month"></a><h3>g_date_get_days_in_month ()</h3>
 
1536
<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,
 
1537
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);</pre>
1656
1538
<p>
1657
1539
Returns the number of days in a month, taking leap years into account.
1658
1540
</p>
1660
1542
<col align="left" valign="top">
1661
1543
<tbody>
1662
1544
<tr>
1663
 
<td><p><span class="term"><em class="parameter"><code>month</code></em>&#160;:</span></p></td>
 
1545
<td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
1664
1546
<td>month
1665
1547
</td>
1666
1548
</tr>
1667
1549
<tr>
1668
 
<td><p><span class="term"><em class="parameter"><code>year</code></em>&#160;:</span></p></td>
 
1550
<td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
1669
1551
<td>year
1670
1552
</td>
1671
1553
</tr>
1672
1554
<tr>
1673
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1555
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1674
1556
<td>number of days in <em class="parameter"><code>month</code></em> during the <em class="parameter"><code>year</code></em>
1675
 
 
1676
 
 
1677
 
</td>
1678
 
</tr>
1679
 
</tbody>
1680
 
</table></div>
1681
 
</div>
1682
 
<hr>
1683
 
<div class="refsect2" lang="en">
1684
 
<a name="id3097176"></a><h3>
1685
 
<a name="g-date-is-first-of-month"></a>g_date_is_first_of_month ()</h3>
1686
 
<a class="indexterm" name="id3097189"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_date_is_first_of_month            (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
1687
 
<p>
1688
 
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the date is on the first of a month. The date must be valid.
1689
 
</p>
1690
 
<div class="variablelist"><table border="0">
1691
 
<col align="left" valign="top">
1692
 
<tbody>
1693
 
<tr>
1694
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1695
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to check
1696
 
</td>
1697
 
</tr>
1698
 
<tr>
1699
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1700
 
<td>
1701
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the date is the first of the month
1702
 
 
1703
 
 
1704
 
</td>
1705
 
</tr>
1706
 
</tbody>
1707
 
</table></div>
1708
 
</div>
1709
 
<hr>
1710
 
<div class="refsect2" lang="en">
1711
 
<a name="id3097274"></a><h3>
1712
 
<a name="g-date-is-last-of-month"></a>g_date_is_last_of_month ()</h3>
1713
 
<a class="indexterm" name="id3097287"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_date_is_last_of_month             (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
1714
 
<p>
1715
 
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the date is the last day of the month. The date must be valid.
1716
 
</p>
1717
 
<div class="variablelist"><table border="0">
1718
 
<col align="left" valign="top">
1719
 
<tbody>
1720
 
<tr>
1721
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1722
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to check
1723
 
</td>
1724
 
</tr>
1725
 
<tr>
1726
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1727
 
<td>
1728
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the date is the last day of the month
1729
 
 
1730
 
 
1731
 
</td>
1732
 
</tr>
1733
 
</tbody>
1734
 
</table></div>
1735
 
</div>
1736
 
<hr>
1737
 
<div class="refsect2" lang="en">
1738
 
<a name="id3097373"></a><h3>
1739
 
<a name="g-date-is-leap-year"></a>g_date_is_leap_year ()</h3>
1740
 
<a class="indexterm" name="id3097386"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_date_is_leap_year                 (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);</pre>
1741
 
<p>
1742
 
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the year is a leap year.<sup>[<a name="id3097424" href="#ftn.id3097424" class="footnote">4</a>]</sup>
1743
 
</p>
1744
 
<div class="variablelist"><table border="0">
1745
 
<col align="left" valign="top">
1746
 
<tbody>
1747
 
<tr>
1748
 
<td><p><span class="term"><em class="parameter"><code>year</code></em>&#160;:</span></p></td>
 
1557
</td>
 
1558
</tr>
 
1559
</tbody>
 
1560
</table></div>
 
1561
</div>
 
1562
<hr>
 
1563
<div class="refsect2" lang="en">
 
1564
<a name="g-date-is-first-of-month"></a><h3>g_date_is_first_of_month ()</h3>
 
1565
<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>
 
1566
<p>
 
1567
Returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the date is on the first of a month. The date must be valid.
 
1568
</p>
 
1569
<div class="variablelist"><table border="0">
 
1570
<col align="left" valign="top">
 
1571
<tbody>
 
1572
<tr>
 
1573
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1574
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to check
 
1575
</td>
 
1576
</tr>
 
1577
<tr>
 
1578
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1579
<td>%TRUE if the date is the first of the month
 
1580
</td>
 
1581
</tr>
 
1582
</tbody>
 
1583
</table></div>
 
1584
</div>
 
1585
<hr>
 
1586
<div class="refsect2" lang="en">
 
1587
<a name="g-date-is-last-of-month"></a><h3>g_date_is_last_of_month ()</h3>
 
1588
<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>
 
1589
<p>
 
1590
Returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the date is the last day of the month. The date must be valid.
 
1591
</p>
 
1592
<div class="variablelist"><table border="0">
 
1593
<col align="left" valign="top">
 
1594
<tbody>
 
1595
<tr>
 
1596
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1597
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to check
 
1598
</td>
 
1599
</tr>
 
1600
<tr>
 
1601
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1602
<td>%TRUE if the date is the last day of the month
 
1603
</td>
 
1604
</tr>
 
1605
</tbody>
 
1606
</table></div>
 
1607
</div>
 
1608
<hr>
 
1609
<div class="refsect2" lang="en">
 
1610
<a name="g-date-is-leap-year"></a><h3>g_date_is_leap_year ()</h3>
 
1611
<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>
 
1612
<p>
 
1613
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="id3138938" href="#ftn.id3138938" class="footnote">4</a>]</sup>
 
1614
</p>
 
1615
<div class="variablelist"><table border="0">
 
1616
<col align="left" valign="top">
 
1617
<tbody>
 
1618
<tr>
 
1619
<td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
1749
1620
<td>year to check
1750
1621
</td>
1751
1622
</tr>
1752
1623
<tr>
1753
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1754
 
<td>
1755
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the year is a leap year
1756
 
 
1757
 
 
 
1624
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1625
<td>%TRUE if the year is a leap year
1758
1626
</td>
1759
1627
</tr>
1760
1628
</tbody>
1762
1630
</div>
1763
1631
<hr>
1764
1632
<div class="refsect2" lang="en">
1765
 
<a name="id3097471"></a><h3>
1766
 
<a name="g-date-get-monday-week-of-year"></a>g_date_get_monday_week_of_year ()</h3>
1767
 
<a class="indexterm" name="id3097485"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint">guint</a>               g_date_get_monday_week_of_year      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
 
1633
<a name="g-date-get-monday-week-of-year"></a><h3>g_date_get_monday_week_of_year ()</h3>
 
1634
<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>
1768
1635
<p>
1769
1636
Returns the week of the year, where weeks are understood to start on
1770
1637
Monday. If the date is before the first Monday of the year, return
1774
1641
<col align="left" valign="top">
1775
1642
<tbody>
1776
1643
<tr>
1777
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1778
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
 
1644
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1645
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1779
1646
</td>
1780
1647
</tr>
1781
1648
<tr>
1782
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1649
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1783
1650
<td>week of the year
1784
 
 
1785
 
 
1786
1651
</td>
1787
1652
</tr>
1788
1653
</tbody>
1790
1655
</div>
1791
1656
<hr>
1792
1657
<div class="refsect2" lang="en">
1793
 
<a name="id3097552"></a><h3>
1794
 
<a name="g-date-get-monday-weeks-in-year"></a>g_date_get_monday_weeks_in_year ()</h3>
1795
 
<a class="indexterm" name="id3097566"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint8">guint8</a>              g_date_get_monday_weeks_in_year     (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);</pre>
 
1658
<a name="g-date-get-monday-weeks-in-year"></a><h3>g_date_get_monday_weeks_in_year ()</h3>
 
1659
<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>
1796
1660
<p>
1797
1661
Returns the number of weeks in the year, where weeks are taken to start
1798
1662
on Monday. Will be 52 or 53. The date must be valid. (Years always have 52
1805
1669
<col align="left" valign="top">
1806
1670
<tbody>
1807
1671
<tr>
1808
 
<td><p><span class="term"><em class="parameter"><code>year</code></em>&#160;:</span></p></td>
 
1672
<td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
1809
1673
<td>a year
1810
1674
</td>
1811
1675
</tr>
1812
1676
<tr>
1813
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1677
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1814
1678
<td>number of Mondays in the year
1815
 
 
1816
 
 
1817
1679
</td>
1818
1680
</tr>
1819
1681
</tbody>
1821
1683
</div>
1822
1684
<hr>
1823
1685
<div class="refsect2" lang="en">
1824
 
<a name="id3097630"></a><h3>
1825
 
<a name="g-date-get-sunday-week-of-year"></a>g_date_get_sunday_week_of_year ()</h3>
1826
 
<a class="indexterm" name="id3097643"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint">guint</a>               g_date_get_sunday_week_of_year      (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
 
1686
<a name="g-date-get-sunday-week-of-year"></a><h3>g_date_get_sunday_week_of_year ()</h3>
 
1687
<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>
1827
1688
<p>
1828
 
Returns the week of the year during which this date falls, if weeks 
1829
 
are understood to being on Sunday. The date must be valid. Can return 0 if 
 
1689
Returns the week of the year during which this date falls, if weeks
 
1690
are understood to being on Sunday. The date must be valid. Can return 0 if
1830
1691
the day is before the first Sunday of the year.
1831
1692
</p>
1832
1693
<div class="variablelist"><table border="0">
1833
1694
<col align="left" valign="top">
1834
1695
<tbody>
1835
1696
<tr>
1836
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1837
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
 
1697
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1698
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1838
1699
</td>
1839
1700
</tr>
1840
1701
<tr>
1841
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1702
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1842
1703
<td>week number
1843
 
 
1844
 
 
1845
1704
</td>
1846
1705
</tr>
1847
1706
</tbody>
1849
1708
</div>
1850
1709
<hr>
1851
1710
<div class="refsect2" lang="en">
1852
 
<a name="id3097711"></a><h3>
1853
 
<a name="g-date-get-sunday-weeks-in-year"></a>g_date_get_sunday_weeks_in_year ()</h3>
1854
 
<a class="indexterm" name="id3097725"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint8">guint8</a>              g_date_get_sunday_weeks_in_year     (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);</pre>
 
1711
<a name="g-date-get-sunday-weeks-in-year"></a><h3>g_date_get_sunday_weeks_in_year ()</h3>
 
1712
<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>
1855
1713
<p>
1856
1714
Returns the number of weeks in the year, where weeks are taken to start
1857
1715
on Sunday. Will be 52 or 53. The date must be valid. (Years always have 52
1864
1722
<col align="left" valign="top">
1865
1723
<tbody>
1866
1724
<tr>
1867
 
<td><p><span class="term"><em class="parameter"><code>year</code></em>&#160;:</span></p></td>
 
1725
<td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
1868
1726
<td>year to count weeks in
1869
1727
</td>
1870
1728
</tr>
1871
1729
<tr>
1872
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1730
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1873
1731
<td>number of weeks
1874
 
 
1875
 
 
1876
1732
</td>
1877
1733
</tr>
1878
1734
</tbody>
1880
1736
</div>
1881
1737
<hr>
1882
1738
<div class="refsect2" lang="en">
1883
 
<a name="id3097788"></a><h3>
1884
 
<a name="g-date-get-iso8601-week-of-year"></a>g_date_get_iso8601_week_of_year ()</h3>
1885
 
<a class="indexterm" name="id3097804"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint">guint</a>               g_date_get_iso8601_week_of_year     (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
 
1739
<a name="g-date-get-iso8601-week-of-year"></a><h3>g_date_get_iso8601_week_of_year ()</h3>
 
1740
<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>
1886
1741
<p>
1887
1742
Returns the week of the year, where weeks are interpreted according
1888
1743
to ISO 8601.</p>
1889
1744
<p>
1890
 
 
1891
1745
</p>
1892
1746
<div class="variablelist"><table border="0">
1893
1747
<col align="left" valign="top">
1894
1748
<tbody>
1895
1749
<tr>
1896
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1897
 
<td> a valid <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
 
1750
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1751
<td> a valid <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1898
1752
</td>
1899
1753
</tr>
1900
1754
<tr>
1901
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1755
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1902
1756
<td> ISO 8601 week number of the year.
1903
1757
 
1904
1758
</td>
1905
1759
</tr>
1906
1760
</tbody>
1907
1761
</table></div>
1908
 
<p class="since">Since  2.6
1909
 
</p>
 
1762
<p class="since">Since 2.6</p>
1910
1763
</div>
1911
1764
<hr>
1912
1765
<div class="refsect2" lang="en">
1913
 
<a name="id3097881"></a><h3>
1914
 
<a name="g-date-strftime"></a>g_date_strftime ()</h3>
1915
 
<a class="indexterm" name="id3097893"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize">gsize</a>               g_date_strftime                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s,
1916
 
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> slen,
1917
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
1918
 
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
 
1766
<a name="g-date-strftime"></a><h3>g_date_strftime ()</h3>
 
1767
<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,
 
1768
                                                         <a class="link" href="glib-Basic-Types.html#gsize" title="gsize">gsize</a> slen,
 
1769
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *format,
 
1770
                                                         const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a> *date);</pre>
1919
1771
<p>
1920
 
Generates a printed representation of the date, in a 
1921
 
<a class="link" href="glib-running.html#setlocale" title="Locale">locale</a>-specific way. Works just like 
1922
 
the platform's C library <code class="function">strftime()</code> function, but only accepts date-related 
1923
 
formats; time-related formats give undefined results. Date must be valid. 
1924
 
Unlike <code class="function">strftime()</code> (which uses the locale encoding), works on a UTF-8 format 
 
1772
Generates a printed representation of the date, in a
 
1773
<a class="link" href="glib-running.html#setlocale" title="Locale">locale</a>-specific way. Works just like
 
1774
the platform's C library <code class="function">strftime()</code> function, but only accepts date-related
 
1775
formats; time-related formats give undefined results. Date must be valid.
 
1776
Unlike <code class="function">strftime()</code> (which uses the locale encoding), works on a UTF-8 format
1925
1777
string and stores a UTF-8 result.
1926
1778
</p>
1927
1779
<p>
1928
1780
This function does not provide any conversion specifiers in addition
1929
1781
to those implemented by the platform's C library. For example, don't
1930
 
expect that using <a class="link" href="glib-Date-and-Time-Functions.html#g-date-strftime"><code class="function">g_date_strftime()</code></a> would make the <code class="literal">F</code> provided by the C99 
 
1782
expect that using <a class="link" href="glib-Date-and-Time-Functions.html#g-date-strftime" title="g_date_strftime ()"><code class="function">g_date_strftime()</code></a> would make the <code class="literal">F</code> provided by the C99
1931
1783
<code class="function">strftime()</code> work on Windows where the C library only complies to C89.
1932
1784
</p>
1933
1785
<div class="variablelist"><table border="0">
1934
1786
<col align="left" valign="top">
1935
1787
<tbody>
1936
1788
<tr>
1937
 
<td><p><span class="term"><em class="parameter"><code>s</code></em>&#160;:</span></p></td>
 
1789
<td><p><span class="term"><em class="parameter"><code>s</code></em> :</span></p></td>
1938
1790
<td>destination buffer
1939
1791
</td>
1940
1792
</tr>
1941
1793
<tr>
1942
 
<td><p><span class="term"><em class="parameter"><code>slen</code></em>&#160;:</span></p></td>
 
1794
<td><p><span class="term"><em class="parameter"><code>slen</code></em> :</span></p></td>
1943
1795
<td>buffer size
1944
1796
</td>
1945
1797
</tr>
1946
1798
<tr>
1947
 
<td><p><span class="term"><em class="parameter"><code>format</code></em>&#160;:</span></p></td>
 
1799
<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
1948
1800
<td>format string
1949
1801
</td>
1950
1802
</tr>
1951
1803
<tr>
1952
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1953
 
<td>valid <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a>
 
1804
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1805
<td>valid <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1954
1806
</td>
1955
1807
</tr>
1956
1808
<tr>
1957
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1809
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1958
1810
<td>number of characters written to the buffer, or 0 the buffer was too small
1959
 
 
1960
 
 
1961
1811
</td>
1962
1812
</tr>
1963
1813
</tbody>
1965
1815
</div>
1966
1816
<hr>
1967
1817
<div class="refsect2" lang="en">
1968
 
<a name="id3098096"></a><h3>
1969
 
<a name="g-date-to-struct-tm"></a>g_date_to_struct_tm ()</h3>
1970
 
<a class="indexterm" name="id3098109"></a><pre class="programlisting">void                g_date_to_struct_tm                 (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date,
 
1818
<a name="g-date-to-struct-tm"></a><h3>g_date_to_struct_tm ()</h3>
 
1819
<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,
1971
1820
                                                         struct tm *tm);</pre>
1972
1821
<p>
1973
1822
Fills in the date-related bits of a <span class="structname">struct tm</span>
1978
1827
<col align="left" valign="top">
1979
1828
<tbody>
1980
1829
<tr>
1981
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
1982
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to set the <span class="structname">struct tm</span> from.
 
1830
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1831
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to set the <span class="structname">struct tm</span> from.
1983
1832
</td>
1984
1833
</tr>
1985
1834
<tr>
1986
 
<td><p><span class="term"><em class="parameter"><code>tm</code></em>&#160;:</span></p></td>
 
1835
<td><p><span class="term"><em class="parameter"><code>tm</code></em> :</span></p></td>
1987
1836
<td>
1988
1837
<span class="structname">struct tm</span> to fill.
1989
 
 
1990
 
 
1991
1838
</td>
1992
1839
</tr>
1993
1840
</tbody>
1995
1842
</div>
1996
1843
<hr>
1997
1844
<div class="refsect2" lang="en">
1998
 
<a name="id3098202"></a><h3>
1999
 
<a name="g-date-valid"></a>g_date_valid ()</h3>
2000
 
<a class="indexterm" name="id3098214"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_date_valid                        (const <a class="link" href="glib-Date-and-Time-Functions.html#GDate">GDate</a> *date);</pre>
 
1845
<a name="g-date-valid"></a><h3>g_date_valid ()</h3>
 
1846
<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>
2001
1847
<p>
2002
 
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> represents an existing day. The date must not
2003
 
contain garbage; it should have been initialized with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear"><code class="function">g_date_clear()</code></a>
2004
 
if it wasn't allocated by one of the <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new"><code class="function">g_date_new()</code></a> variants.
 
1848
Returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> represents an existing day. The date must not
 
1849
contain garbage; it should have been initialized with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()"><code class="function">g_date_clear()</code></a>
 
1850
if it wasn't allocated by one of the <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()"><code class="function">g_date_new()</code></a> variants.
2005
1851
</p>
2006
1852
<div class="variablelist"><table border="0">
2007
1853
<col align="left" valign="top">
2008
1854
<tbody>
2009
1855
<tr>
2010
 
<td><p><span class="term"><em class="parameter"><code>date</code></em>&#160;:</span></p></td>
2011
 
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to check
 
1856
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
 
1857
<td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to check
2012
1858
</td>
2013
1859
</tr>
2014
1860
<tr>
2015
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1861
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2016
1862
<td>Whether the date is valid
2017
 
 
2018
 
 
2019
1863
</td>
2020
1864
</tr>
2021
1865
</tbody>
2023
1867
</div>
2024
1868
<hr>
2025
1869
<div class="refsect2" lang="en">
2026
 
<a name="id3098321"></a><h3>
2027
 
<a name="g-date-valid-day"></a>g_date_valid_day ()</h3>
2028
 
<a class="indexterm" name="id3098334"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_date_valid_day                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a> day);</pre>
 
1870
<a name="g-date-valid-day"></a><h3>g_date_valid_day ()</h3>
 
1871
<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>
2029
1872
<p>
2030
 
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the day of the month is valid (a day is valid if it's
 
1873
Returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the day of the month is valid (a day is valid if it's
2031
1874
between 1 and 31 inclusive).
2032
1875
</p>
2033
1876
<div class="variablelist"><table border="0">
2034
1877
<col align="left" valign="top">
2035
1878
<tbody>
2036
1879
<tr>
2037
 
<td><p><span class="term"><em class="parameter"><code>day</code></em>&#160;:</span></p></td>
 
1880
<td><p><span class="term"><em class="parameter"><code>day</code></em> :</span></p></td>
2038
1881
<td>day to check
2039
1882
</td>
2040
1883
</tr>
2041
1884
<tr>
2042
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2043
 
<td>
2044
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the day is valid
2045
 
 
2046
 
 
 
1885
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1886
<td>%TRUE if the day is valid
2047
1887
</td>
2048
1888
</tr>
2049
1889
</tbody>
2051
1891
</div>
2052
1892
<hr>
2053
1893
<div class="refsect2" lang="en">
2054
 
<a name="id3098411"></a><h3>
2055
 
<a name="g-date-valid-month"></a>g_date_valid_month ()</h3>
2056
 
<a class="indexterm" name="id3098424"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_date_valid_month                  (<a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a> month);</pre>
 
1894
<a name="g-date-valid-month"></a><h3>g_date_valid_month ()</h3>
 
1895
<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>
2057
1896
<p>
2058
 
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the month value is valid. The 12 <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth"><span class="type">GDateMonth</span></a>
 
1897
Returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the month value is valid. The 12 <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a>
2059
1898
enumeration values are the only valid months.
2060
1899
</p>
2061
1900
<div class="variablelist"><table border="0">
2062
1901
<col align="left" valign="top">
2063
1902
<tbody>
2064
1903
<tr>
2065
 
<td><p><span class="term"><em class="parameter"><code>month</code></em>&#160;:</span></p></td>
 
1904
<td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
2066
1905
<td>month
2067
1906
</td>
2068
1907
</tr>
2069
1908
<tr>
2070
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2071
 
<td>
2072
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the month is valid
2073
 
 
2074
 
 
 
1909
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1910
<td>%TRUE if the month is valid
2075
1911
</td>
2076
1912
</tr>
2077
1913
</tbody>
2079
1915
</div>
2080
1916
<hr>
2081
1917
<div class="refsect2" lang="en">
2082
 
<a name="id3098509"></a><h3>
2083
 
<a name="g-date-valid-year"></a>g_date_valid_year ()</h3>
2084
 
<a class="indexterm" name="id3098522"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_date_valid_year                   (<a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);</pre>
 
1918
<a name="g-date-valid-year"></a><h3>g_date_valid_year ()</h3>
 
1919
<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>
2085
1920
<p>
2086
 
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the year is valid. Any year greater than 0 is valid,
2087
 
though there is a 16-bit limit to what <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> will understand.
 
1921
Returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the year is valid. Any year greater than 0 is valid,
 
1922
though there is a 16-bit limit to what <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> will understand.
2088
1923
</p>
2089
1924
<div class="variablelist"><table border="0">
2090
1925
<col align="left" valign="top">
2091
1926
<tbody>
2092
1927
<tr>
2093
 
<td><p><span class="term"><em class="parameter"><code>year</code></em>&#160;:</span></p></td>
 
1928
<td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
2094
1929
<td>year
2095
1930
</td>
2096
1931
</tr>
2097
1932
<tr>
2098
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2099
 
<td>
2100
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the year is valid
2101
 
 
2102
 
 
 
1933
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1934
<td>%TRUE if the year is valid
2103
1935
</td>
2104
1936
</tr>
2105
1937
</tbody>
2107
1939
</div>
2108
1940
<hr>
2109
1941
<div class="refsect2" lang="en">
2110
 
<a name="id3098608"></a><h3>
2111
 
<a name="g-date-valid-dmy"></a>g_date_valid_dmy ()</h3>
2112
 
<a class="indexterm" name="id3098621"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_date_valid_dmy                    (<a class="link" href="glib-Date-and-Time-Functions.html#GDateDay">GDateDay</a> day,
2113
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth">GDateMonth</a> month,
2114
 
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear">GDateYear</a> year);</pre>
 
1942
<a name="g-date-valid-dmy"></a><h3>g_date_valid_dmy ()</h3>
 
1943
<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,
 
1944
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a> month,
 
1945
                                                         <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a> year);</pre>
2115
1946
<p>
2116
 
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the day-month-year triplet forms a valid, existing day
2117
 
in the range of days <a class="link" href="glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> understands (Year 1 or later, no more than
 
1947
Returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the day-month-year triplet forms a valid, existing day
 
1948
in the range of days <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> understands (Year 1 or later, no more than
2118
1949
a few thousand years in the future).
2119
1950
</p>
2120
1951
<div class="variablelist"><table border="0">
2121
1952
<col align="left" valign="top">
2122
1953
<tbody>
2123
1954
<tr>
2124
 
<td><p><span class="term"><em class="parameter"><code>day</code></em>&#160;:</span></p></td>
 
1955
<td><p><span class="term"><em class="parameter"><code>day</code></em> :</span></p></td>
2125
1956
<td>day
2126
1957
</td>
2127
1958
</tr>
2128
1959
<tr>
2129
 
<td><p><span class="term"><em class="parameter"><code>month</code></em>&#160;:</span></p></td>
 
1960
<td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
2130
1961
<td>month
2131
1962
</td>
2132
1963
</tr>
2133
1964
<tr>
2134
 
<td><p><span class="term"><em class="parameter"><code>year</code></em>&#160;:</span></p></td>
 
1965
<td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
2135
1966
<td>year
2136
1967
</td>
2137
1968
</tr>
2138
1969
<tr>
2139
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2140
 
<td>
2141
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the date is a valid one
2142
 
 
2143
 
 
 
1970
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1971
<td>%TRUE if the date is a valid one
2144
1972
</td>
2145
1973
</tr>
2146
1974
</tbody>
2148
1976
</div>
2149
1977
<hr>
2150
1978
<div class="refsect2" lang="en">
2151
 
<a name="id3098751"></a><h3>
2152
 
<a name="g-date-valid-julian"></a>g_date_valid_julian ()</h3>
2153
 
<a class="indexterm" name="id3098764"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_date_valid_julian                 (<a class="link" href="glib-Basic-Types.html#guint32">guint32</a> julian_date);</pre>
 
1979
<a name="g-date-valid-julian"></a><h3>g_date_valid_julian ()</h3>
 
1980
<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>
2154
1981
<p>
2155
 
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the Julian day is valid. Anything greater than zero 
 
1982
Returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the Julian day is valid. Anything greater than zero
2156
1983
is basically a valid Julian, though there is a 32-bit limit.
2157
1984
</p>
2158
1985
<div class="variablelist"><table border="0">
2159
1986
<col align="left" valign="top">
2160
1987
<tbody>
2161
1988
<tr>
2162
 
<td><p><span class="term"><em class="parameter"><code>julian_date</code></em>&#160;:</span></p></td>
 
1989
<td><p><span class="term"><em class="parameter"><code>julian_date</code></em> :</span></p></td>
2163
1990
<td>Julian day to check
2164
1991
</td>
2165
1992
</tr>
2166
1993
<tr>
2167
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2168
 
<td>
2169
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the Julian day is valid
2170
 
 
2171
 
 
 
1994
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1995
<td>%TRUE if the Julian day is valid
2172
1996
</td>
2173
1997
</tr>
2174
1998
</tbody>
2176
2000
</div>
2177
2001
<hr>
2178
2002
<div class="refsect2" lang="en">
2179
 
<a name="id3098842"></a><h3>
2180
 
<a name="g-date-valid-weekday"></a>g_date_valid_weekday ()</h3>
2181
 
<a class="indexterm" name="id3098855"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_date_valid_weekday                (<a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday">GDateWeekday</a> weekday);</pre>
 
2003
<a name="g-date-valid-weekday"></a><h3>g_date_valid_weekday ()</h3>
 
2004
<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>
2182
2005
<p>
2183
 
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the weekday is valid. The seven <a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday"><span class="type">GDateWeekday</span></a> enumeration
 
2006
Returns <a class="link" href="glib-Standard-Macros.html#TRUE--CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the weekday is valid. The seven <a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday"><span class="type">GDateWeekday</span></a> enumeration
2184
2007
values are the only valid weekdays.
2185
2008
</p>
2186
2009
<div class="variablelist"><table border="0">
2187
2010
<col align="left" valign="top">
2188
2011
<tbody>
2189
2012
<tr>
2190
 
<td><p><span class="term"><em class="parameter"><code>weekday</code></em>&#160;:</span></p></td>
 
2013
<td><p><span class="term"><em class="parameter"><code>weekday</code></em> :</span></p></td>
2191
2014
<td>weekday
2192
2015
</td>
2193
2016
</tr>
2194
2017
<tr>
2195
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2196
 
<td>
2197
 
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the weekday is valid
2198
 
 
2199
 
 
 
2018
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
2019
<td>%TRUE if the weekday is valid
2200
2020
</td>
2201
2021
</tr>
2202
2022
</tbody>
2203
2023
</table></div>
2204
2024
</div>
2205
2025
</div>
2206
 
<div class="refsect1" lang="en">
2207
 
<a name="id3098943"></a><div class="refsect2" lang="en"><a name="id3098944"></a></div>
2208
 
<hr>
2209
 
<div class="refsect2" lang="en"><a name="id3098945"></a></div>
2210
 
</div>
2211
2026
<div class="footnotes">
2212
2027
<br><hr width="100" align="left">
2213
 
<div class="footnote"><p><sup>[<a name="ftn.id3097424" href="#id3097424" class="para">4</a>] </sup>
 
2028
<div class="footnote"><p><sup>[<a name="ftn.id3138938" href="#id3138938" class="para">4</a>] </sup>
2214
2029
For the purposes of this function, leap year is every year divisible by
2215
 
4 unless that year is divisible by 100. If it is divisible by 100 it would 
 
2030
4 unless that year is divisible by 100. If it is divisible by 100 it would
2216
2031
be a leap year only if that year is also divisible by 400.</p></div>
2217
2032
</div>
2218
2033
</div>
 
2034
<div class="footer">
 
2035
<hr>
 
2036
          Generated by GTK-Doc V1.11</div>
2219
2037
</body>
2220
2038
</html>