2 * Copyright (C) 2009-2010 Christian Hergert <chris@dronelabs.com>
3 * Copyright © 2010 Codethink Limited
5 * This library is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU Lesser General Public License as
7 * published by the Free Software Foundation; either version 2.1 of the
8 * licence, or (at your option) any later version.
10 * This is distributed in the hope that it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
13 * License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
20 * Authors: Christian Hergert <chris@dronelabs.com>
21 * Thiago Santos <thiago.sousa.santos@collabora.co.uk>
22 * Emmanuele Bassi <ebassi@linux.intel.com>
23 * Ryan Lortie <desrt@desrt.ca>
26 #ifndef __G_DATE_TIME_H__
27 #define __G_DATE_TIME_H__
29 #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
30 #error "Only <glib.h> can be included directly."
33 #include <glib/gtimezone.h>
40 * Evaluates to a time span of one day.
44 #define G_TIME_SPAN_DAY (G_GINT64_CONSTANT (86400000000))
49 * Evaluates to a time span of one hour.
53 #define G_TIME_SPAN_HOUR (G_GINT64_CONSTANT (3600000000))
58 * Evaluates to a time span of one minute.
62 #define G_TIME_SPAN_MINUTE (G_GINT64_CONSTANT (60000000))
67 * Evaluates to a time span of one second.
71 #define G_TIME_SPAN_SECOND (G_GINT64_CONSTANT (1000000))
74 * G_TIME_SPAN_MILLISECOND:
76 * Evaluates to a time span of one millisecond.
80 #define G_TIME_SPAN_MILLISECOND (G_GINT64_CONSTANT (1000))
85 * A value representing an interval of time, in microseconds.
89 typedef gint64 GTimeSpan
;
94 * <structname>GDateTime</structname> is an opaque structure whose members
95 * cannot be accessed directly.
99 typedef struct _GDateTime GDateTime
;
101 GLIB_AVAILABLE_IN_ALL
102 void g_date_time_unref (GDateTime
*datetime
);
103 GLIB_AVAILABLE_IN_ALL
104 GDateTime
* g_date_time_ref (GDateTime
*datetime
);
106 GLIB_AVAILABLE_IN_ALL
107 GDateTime
* g_date_time_new_now (GTimeZone
*tz
);
108 GLIB_AVAILABLE_IN_ALL
109 GDateTime
* g_date_time_new_now_local (void);
110 GLIB_AVAILABLE_IN_ALL
111 GDateTime
* g_date_time_new_now_utc (void);
113 GLIB_AVAILABLE_IN_ALL
114 GDateTime
* g_date_time_new_from_unix_local (gint64 t
);
115 GLIB_AVAILABLE_IN_ALL
116 GDateTime
* g_date_time_new_from_unix_utc (gint64 t
);
118 GLIB_AVAILABLE_IN_ALL
119 GDateTime
* g_date_time_new_from_timeval_local (const GTimeVal
*tv
);
120 GLIB_AVAILABLE_IN_ALL
121 GDateTime
* g_date_time_new_from_timeval_utc (const GTimeVal
*tv
);
123 GLIB_AVAILABLE_IN_ALL
124 GDateTime
* g_date_time_new (GTimeZone
*tz
,
131 GLIB_AVAILABLE_IN_ALL
132 GDateTime
* g_date_time_new_local (gint year
,
138 GLIB_AVAILABLE_IN_ALL
139 GDateTime
* g_date_time_new_utc (gint year
,
146 GLIB_AVAILABLE_IN_ALL
147 G_GNUC_WARN_UNUSED_RESULT
148 GDateTime
* g_date_time_add (GDateTime
*datetime
,
151 GLIB_AVAILABLE_IN_ALL
152 G_GNUC_WARN_UNUSED_RESULT
153 GDateTime
* g_date_time_add_years (GDateTime
*datetime
,
155 GLIB_AVAILABLE_IN_ALL
156 G_GNUC_WARN_UNUSED_RESULT
157 GDateTime
* g_date_time_add_months (GDateTime
*datetime
,
159 GLIB_AVAILABLE_IN_ALL
160 G_GNUC_WARN_UNUSED_RESULT
161 GDateTime
* g_date_time_add_weeks (GDateTime
*datetime
,
163 GLIB_AVAILABLE_IN_ALL
164 G_GNUC_WARN_UNUSED_RESULT
165 GDateTime
* g_date_time_add_days (GDateTime
*datetime
,
168 GLIB_AVAILABLE_IN_ALL
169 G_GNUC_WARN_UNUSED_RESULT
170 GDateTime
* g_date_time_add_hours (GDateTime
*datetime
,
172 GLIB_AVAILABLE_IN_ALL
173 G_GNUC_WARN_UNUSED_RESULT
174 GDateTime
* g_date_time_add_minutes (GDateTime
*datetime
,
176 GLIB_AVAILABLE_IN_ALL
177 G_GNUC_WARN_UNUSED_RESULT
178 GDateTime
* g_date_time_add_seconds (GDateTime
*datetime
,
181 GLIB_AVAILABLE_IN_ALL
182 G_GNUC_WARN_UNUSED_RESULT
183 GDateTime
* g_date_time_add_full (GDateTime
*datetime
,
191 GLIB_AVAILABLE_IN_ALL
192 gint
g_date_time_compare (gconstpointer dt1
,
194 GLIB_AVAILABLE_IN_ALL
195 GTimeSpan
g_date_time_difference (GDateTime
*end
,
197 GLIB_AVAILABLE_IN_ALL
198 guint
g_date_time_hash (gconstpointer datetime
);
199 GLIB_AVAILABLE_IN_ALL
200 gboolean
g_date_time_equal (gconstpointer dt1
,
203 GLIB_AVAILABLE_IN_ALL
204 void g_date_time_get_ymd (GDateTime
*datetime
,
209 GLIB_AVAILABLE_IN_ALL
210 gint
g_date_time_get_year (GDateTime
*datetime
);
211 GLIB_AVAILABLE_IN_ALL
212 gint
g_date_time_get_month (GDateTime
*datetime
);
213 GLIB_AVAILABLE_IN_ALL
214 gint
g_date_time_get_day_of_month (GDateTime
*datetime
);
216 GLIB_AVAILABLE_IN_ALL
217 gint
g_date_time_get_week_numbering_year (GDateTime
*datetime
);
218 GLIB_AVAILABLE_IN_ALL
219 gint
g_date_time_get_week_of_year (GDateTime
*datetime
);
220 GLIB_AVAILABLE_IN_ALL
221 gint
g_date_time_get_day_of_week (GDateTime
*datetime
);
223 GLIB_AVAILABLE_IN_ALL
224 gint
g_date_time_get_day_of_year (GDateTime
*datetime
);
226 GLIB_AVAILABLE_IN_ALL
227 gint
g_date_time_get_hour (GDateTime
*datetime
);
228 GLIB_AVAILABLE_IN_ALL
229 gint
g_date_time_get_minute (GDateTime
*datetime
);
230 GLIB_AVAILABLE_IN_ALL
231 gint
g_date_time_get_second (GDateTime
*datetime
);
232 GLIB_AVAILABLE_IN_ALL
233 gint
g_date_time_get_microsecond (GDateTime
*datetime
);
234 GLIB_AVAILABLE_IN_ALL
235 gdouble
g_date_time_get_seconds (GDateTime
*datetime
);
237 GLIB_AVAILABLE_IN_ALL
238 gint64
g_date_time_to_unix (GDateTime
*datetime
);
239 GLIB_AVAILABLE_IN_ALL
240 gboolean
g_date_time_to_timeval (GDateTime
*datetime
,
243 GLIB_AVAILABLE_IN_ALL
244 GTimeSpan
g_date_time_get_utc_offset (GDateTime
*datetime
);
245 GLIB_AVAILABLE_IN_ALL
246 const gchar
* g_date_time_get_timezone_abbreviation (GDateTime
*datetime
);
247 GLIB_AVAILABLE_IN_ALL
248 gboolean
g_date_time_is_daylight_savings (GDateTime
*datetime
);
250 GLIB_AVAILABLE_IN_ALL
251 GDateTime
* g_date_time_to_timezone (GDateTime
*datetime
,
253 GLIB_AVAILABLE_IN_ALL
254 GDateTime
* g_date_time_to_local (GDateTime
*datetime
);
255 GLIB_AVAILABLE_IN_ALL
256 GDateTime
* g_date_time_to_utc (GDateTime
*datetime
);
258 GLIB_AVAILABLE_IN_ALL
259 gchar
* g_date_time_format (GDateTime
*datetime
,
260 const gchar
*format
) G_GNUC_MALLOC
;
264 #endif /* __G_DATE_TIME_H__ */