![]() | ![]() | ![]() | MIME Directory Library Reference Manual | ![]() |
---|
#include <mimedir/mimedir-datetime.h> #define MIMEDIR_DATETIME_NOTZ #define MIMEDIR_DATETIME_UTC struct MIMEDirDateTime; MIMEDirDateTime * mimedir_datetime_new (void
); MIMEDirDateTime * mimedir_datetime_new_now (void
); MIMEDirDateTime * mimedir_datetime_new_from_datetime (,
GDateYear year,
GDateMonth month,
GDateDay day,
guint8 hour,
guint8 minute); MIMEDirDateTime * mimedir_datetime_new_from_date (
guint8 second,
GDateYear year,
GDateMonth month); MIMEDirDateTime * mimedir_datetime_new_from_time (
GDateDay day,
guint8 hour,
guint8 minute); MIMEDirDateTime * mimedir_datetime_new_from_gdate (
guint8 secondconst
); MIMEDirDateTime * mimedir_datetime_new_from_time_t (GDate *date); MIMEDirDateTime * mimedir_datetime_new_from_struct_tm (
time_t tconst struct tm *tm
);void mimedir_datetime_set_datetime (MIMEDirDateTime *dt
,,
GDateYear year,
GDateMonth month,
GDateDay day,
guint8 hour,
guint8 minute);
guint8 secondvoid mimedir_datetime_set_date (MIMEDirDateTime *dt
,,
GDateYear year,
GDateMonth month);
GDateDay dayvoid mimedir_datetime_set_time (MIMEDirDateTime *dt
,,
guint8 hour,
guint8 minute);
guint8 secondvoid mimedir_datetime_set_gdate (MIMEDirDateTime *dt
,const
);GDate *datevoid mimedir_datetime_set_time_t (MIMEDirDateTime *dt
,);
time_t tvoid mimedir_datetime_set_struct_tm (MIMEDirDateTime *dt
,const struct tm *tm
);void mimedir_datetime_get_datetime (MIMEDirDateTime *dt
,,
GDateYear *year,
GDateMonth *month,
GDateDay *day,
guint8 *hour,
guint8 *minute);
guint8 *secondvoid mimedir_datetime_get_date (MIMEDirDateTime *dt
,,
GDateYear *year,
GDateMonth *month);
GDateDay *dayvoid mimedir_datetime_get_time (MIMEDirDateTime *dt
,,
guint8 *hour,
guint8 *minute);
guint8 *secondvoid mimedir_datetime_get_gdate (MIMEDirDateTime *dt
,);
GDate *datetime_t mimedir_datetime_get_time_t (MIMEDirDateTime *dt
);void mimedir_datetime_get_struct_tm (MIMEDirDateTime *dt
,struct tm *tm
);gboolean mimedir_datetime_is_valid (MIMEDirDateTime *dt
);gboolean mimedir_datetime_is_valid_date (,
GDateYear year,
GDateMonth month);
GDateDay daygboolean mimedir_datetime_is_valid_time (,
guint8 hour,
guint8 minute);
guint8 secondvoid mimedir_datetime_to_utc (MIMEDirDateTime *dt
);gchar * mimedir_datetime_to_string (MIMEDirDateTime *dt
);gint mimedir_datetime_compare (MIMEDirDateTime *dt1
,MIMEDirDateTime *dt2
);
#define MIMEDIR_DATETIME_NOTZ (30000)
This date time object does not specify the time zone.
#define MIMEDIR_DATETIME_UTC (30001)
The time is given in Universal Standard Time (UTC).
struct MIMEDirDateTime { GObject parent; GDateYear year; GDateMonth month; GDateDay day; guint8 hour; guint8 minute; guint8 second; gint16 timezone; MIMEDirDateTimeFlags flags; MIMEDirDateTimePriv *priv; };
MIMEDirDateTime * mimedir_datetime_new (void
);
Creates a new MIME Directory Date/Time object.
Returns : | a new date/time object |
MIMEDirDateTime * mimedir_datetime_new_now (void
);
Creates a new MIME Directory Date/Time object. The date and time will be set to the current date/time.
Returns : | a new date/time object |
MIMEDirDateTime * mimedir_datetime_new_from_datetime (,
GDateYear year,
GDateMonth month,
GDateDay day,
guint8 hour,
guint8 minute);
guint8 second
Creates a new MIME Directory Date/Time object and fills it with the supplied date and time.
Returns : | a new date/time object |
MIMEDirDateTime * mimedir_datetime_new_from_date (,
GDateYear year,
GDateMonth month);
GDateDay day
Creates a new MIME Directory Date/Time object and fills it with the supplied date.
Returns : | a new date/time object |
MIMEDirDateTime * mimedir_datetime_new_from_time (,
guint8 hour,
guint8 minute);
guint8 second
Creates a new MIME Directory Date/Time object and fills it with the supplied time.
Returns : | a new date/time object |
MIMEDirDateTime * mimedir_datetime_new_from_gdate (const GDate *date
);
Creates a new MIME Directory Date/Time object and fills it with the
date from date
.
date : | a |
Returns : | a new date/time object |
MIMEDirDateTime * mimedir_datetime_new_from_time_t (time_t t
);
Creates a new MIME Directory Date/Time object and fills it with the
date from t
.
t : | time |
Returns : | a new date/time object |
MIMEDirDateTime * mimedir_datetime_new_from_struct_tm (const struct tm *tm
);
Creates a new MIME Directory Date/Time object and fills it with the
date from date
.
tm : | a struct tm pointer |
Returns : | a new date/time object |
void mimedir_datetime_set_datetime (MIMEDirDateTime *dt
,,
GDateYear year,
GDateMonth month,
GDateDay day,
guint8 hour,
guint8 minute);
guint8 second
Sets the date and time of dt
.
dt : | a MIMEDirDateTime object |
void mimedir_datetime_set_date (MIMEDirDateTime *dt
,,
GDateYear year,
GDateMonth month);
GDateDay day
Sets the date of dt
.
dt : | a MIMEDirDateTime object |
void mimedir_datetime_set_time (MIMEDirDateTime *dt
,,
guint8 hour,
guint8 minute);
guint8 second
Sets the time of dt
.
dt : | a MIMEDirDateTime object |
void mimedir_datetime_set_gdate (MIMEDirDateTime *dt
,const
);GDate *date
Sets dt
to the date of date
.
dt : | a MIMEDirDateTime object |
date : | a |
void mimedir_datetime_set_time_t (MIMEDirDateTime *dt
,);
time_t t
Sets dt
to the date of t
.
dt : | a MIMEDirDateTime object |
t : | the time |
void mimedir_datetime_set_struct_tm (MIMEDirDateTime *dt
,const struct tm *tm
);
Sets dt
to the date of tm
.
dt : | a MIMEDirDateTime object |
tm : | a struct tm pointer |
void mimedir_datetime_get_datetime (MIMEDirDateTime *dt
,,
GDateYear *year,
GDateMonth *month,
GDateDay *day,
guint8 *hour,
guint8 *minute);
guint8 *second
Gets the date and time of dt
.
dt : | a MIMEDirDateTime object |
void mimedir_datetime_get_date (MIMEDirDateTime *dt
,,
GDateYear *year,
GDateMonth *month);
GDateDay *day
Gets the date of dt
.
dt : | a MIMEDirDateTime object |
void mimedir_datetime_get_time (MIMEDirDateTime *dt
,,
guint8 *hour,
guint8 *minute);
guint8 *second
Gets the time of dt
.
dt : | a MIMEDirDateTime object |
void mimedir_datetime_get_gdate (MIMEDirDateTime *dt
,);
GDate *date
Gets the date as a
dt : | a MIMEDirDateTime object |
date : | a |
time_t mimedir_datetime_get_time_t (MIMEDirDateTime *dt
);
Gets the the date a
dt : | a MIMEDirDateTime object |
Returns : | the time in seconds since the epoch or -1 |
void mimedir_datetime_get_struct_tm (MIMEDirDateTime *dt
,struct tm *tm
);
Gets the date as a
dt : | a MIMEDirDateTime object |
tm : | a struct tm pointer |
gboolean mimedir_datetime_is_valid (MIMEDirDateTime *dt
);
Checks whether dt
is has a valid date and/or time.
dt : | a MIMEDirDateTime object |
Returns : | validity indicator |
gboolean mimedir_datetime_is_valid_date (,
GDateYear year,
GDateMonth month);
GDateDay day
Check whether the given date is valid.
Returns : | validity indicator |
gboolean mimedir_datetime_is_valid_time (,
guint8 hour,
guint8 minute);
guint8 second
Check whether the given time is valid.
Returns : | validity indicator |
void mimedir_datetime_to_utc (MIMEDirDateTime *dt
);
Converts the date/time object to a UTC date/time.
dt : | a MIMEDirDateTime object |
gchar * mimedir_datetime_to_string (MIMEDirDateTime *dt
);
Returns a human-readable, localized string that represents the date
and/or the time this object represent. In case that neither date nor
time is valid, NULL is returned. Otherwise the returned string must
be freed with g_free()
dt : | a MIMEDirDateTime object |
Returns : | human-readable string representing the date and/or time |
gint mimedir_datetime_compare (MIMEDirDateTime *dt1
,MIMEDirDateTime *dt2
);
Compares the dates of dt1
and dt2
and return -1 if dt1
is earlier than
dt2
, 0 if both dates are equal and 1 if dt1
is later than d2
. Both
dates must be valid.
dt1 : | a MIMEDirDateTime object |
dt2 : | a second MIMEDirDateTime object |
Returns : | -1, 0, or 1 |
<<< MIMEDirAttendee | MIMEDirRecurrence >>> |