summaryrefslogtreecommitdiff
path: root/glib/gdatetime.h (plain)
blob: ca975705089a7287a1902f96d5c6502d1c361549
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
/* gdatetime.h
 *
 * Copyright (C) 2009 Christian Hergert
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

#if defined(G_DISABLE_SINGLE_INCLUDES) && !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
#error "Only <glib.h> can be included directly."
#endif
 
#ifndef __G_DATE_TIME_H__
#define __G_DATE_TIME_H__

#include <time.h>
#include <glib/gtypes.h>

G_BEGIN_DECLS

#define G_TIME_SPAN_DAY                  (G_GINT64_CONSTANT (864000000000))
#define G_TIME_SPAN_HOUR                 (G_GINT64_CONSTANT (36000000000))
#define G_TIME_SPAN_MINUTE               (G_GINT64_CONSTANT (600000000))
#define G_TIME_SPAN_SECOND               (G_GINT64_CONSTANT (10000000))
#define G_TIME_SPAN_MILLISECOND          (G_GINT64_CONSTANT (10000))
#define G_TIME_SPAN_TO_DAYS(t)           ((gdouble)(t) / (gdouble)G_TIME_SPAN_DAY)
#define G_TIME_SPAN_TO_HOURS(t)          ((gdouble)(t) / (gdouble)G_TIME_SPAN_HOUR)
#define G_TIME_SPAN_TO_MINUTES(t)        ((gdouble)(t) / (gdouble)G_TIME_SPAN_MINUTE)
#define G_TIME_SPAN_TO_SECONDS(t)        ((gdouble)(t) / (gdouble)G_TIME_SPAN_SECOND)
#define G_TIME_SPAN_TO_MILLISECONDS(t)   ((gdouble)(t) / (gdouble)G_TIME_SPAN_MILLISECOND)

typedef        gint64     GTimeSpan;
typedef struct _GDateTime GDateTime;

void       g_date_time_add                    (GDateTime       *datetime,
                                               GTimeSpan       *timespan);
void       g_date_time_add_years              (GDateTime       *datetime,
                                               gint             years);
void       g_date_time_add_months             (GDateTime       *datetime,
                                               gint             months);
void       g_date_time_add_weeks              (GDateTime       *datetime,
                                               gint             weeks);
void       g_date_time_add_days               (GDateTime       *datetime,
                                               gint             days);
void       g_date_time_add_hours              (GDateTime       *datetime,
                                               gint             hours);
void       g_date_time_add_minutes            (GDateTime       *datetime,
                                               gint             minutes);
void       g_date_time_add_seconds            (GDateTime       *datetime,
                                               gint             seconds);
void       g_date_time_add_milliseconds       (GDateTime       *datetime,
                                               gint             milliseconds);
gint       g_date_time_compare                (GDateTime       *dt1,
                                               GDateTime       *dt2);
GDateTime* g_date_time_copy                   (GDateTime       *datetime);
GDateTime* g_date_time_date                   (GDateTime       *datetime);
void       g_date_time_diff                   (GDateTime       *begin,
                                               GDateTime       *end,
                                               GTimeSpan       *diff);
gboolean   g_date_time_equal                  (gconstpointer    v1,
                                               gconstpointer    v2);
gint       g_date_time_get_day                (GDateTime       *datetime);
gint       g_date_time_get_day_of_week        (GDateTime       *datetime);
gint       g_date_time_get_day_of_year        (GDateTime       *datetime);
gint       g_date_time_get_hour               (GDateTime       *datetime);
gint       g_date_time_get_millisecond        (GDateTime       *datetime);
gint       g_date_time_get_minute             (GDateTime       *datetime);
gint       g_date_time_get_month              (GDateTime       *datetime);
gint       g_date_time_get_second             (GDateTime       *datetime);
void       g_date_time_get_utc_offset         (GDateTime       *datetime,
                                               GTimeSpan       *offset);
gint       g_date_time_get_year               (GDateTime       *datetime);
guint      g_date_time_hash                   (gconstpointer    datetime);
gchar*     g_date_time_format_for_display     (GDateTime       *datetime);
gboolean   g_date_time_is_leap_year           (GDateTime       *datetime);
gboolean   g_date_time_is_daylight_savings    (GDateTime       *datetime);
GDateTime* g_date_time_new                    (void);
GDateTime* g_date_time_new_from_date          (gint             year,
                                               gint             month,
                                               gint             day);
GDateTime* g_date_time_new_from_ticks         (gint64           ticks);
GDateTime* g_date_time_new_from_time_t        (time_t           t);
GDateTime* g_date_time_new_from_timeval       (const GTimeVal  *tv);
GDateTime* g_date_time_new_full               (gint             year,
                                               gint             month,
                                               gint             day,
                                               gint             hour,
                                               gint             minute,
                                               gint             second);
GDateTime* g_date_time_now                    (void);
GDateTime* g_date_time_parse                  (const gchar     *input);
GDateTime* g_date_time_parse_with_format      (const gchar     *format,
                                               const gchar     *input);
GDateTime* g_date_time_ref                    (GDateTime       *datetime);
GDateTime* g_date_time_to_local               (GDateTime       *datetime);
time_t     g_date_time_to_time_t              (GDateTime       *datetime);
void       g_date_time_to_timeval             (GDateTime       *datetime,
                                               GTimeVal        *tv);
GDateTime* g_date_time_to_utc                 (GDateTime       *datetime);
GDateTime* g_date_time_today                  (void);
GDateTime* g_date_time_tomorrow               (void);
void       g_date_time_unref                  (GDateTime       *datetime);
GDateTime* g_date_time_utc_now                (void);
GDateTime* g_date_time_yesterday              (void);
gchar*     g_date_time_printf                 (GDateTime       *datetime,
                                               const gchar     *format);

G_END_DECLS

#endif /* __G_DATE_TIME_H__ */