Top | ![]() |
![]() |
![]() |
![]() |
|
time_days_in_month () |
|
time_day_of_year () |
|
time_day_of_week () |
|
time_is_leap_year () |
|
time_leap_years_up_to () |
|
isodate_from_time_t () |
|
time_from_isodate () |
|
time_add_day () |
|
time_add_week () |
|
time_day_begin () |
|
time_day_end () |
|
time_add_day_with_zone () |
|
time_add_week_with_zone () |
|
time_add_month_with_zone () |
|
time_year_begin_with_zone () |
|
time_month_begin_with_zone () |
|
time_week_begin_with_zone () |
|
time_day_begin_with_zone () |
|
time_day_end_with_zone () |
|
time_to_gdate_with_zone () |
struct tm | icaltimetype_to_tm () |
struct tm | icaltimetype_to_tm_with_zone () |
struct |
tm_to_icaltimetype () |
gint time_days_in_month (,
gint year);
gint month
Returns the number of days in the month. Year is the normal year, e.g. 2001. Month is 0 (Jan) to 11 (Dec).
gint time_day_of_year (,
gint day,
gint month);
gint year
Returns the 1-based day number within the year of the specified date. Year is the normal year, e.g. 2001. Month is 0 to 11.
gint time_day_of_week (,
gint day,
gint month);
gint year
Returns the day of the week for the specified date, 0 (Sun) to 6 (Sat). For the days that were removed on the Gregorian reformation, it returns Thursday. Year is the normal year, e.g. 2001. Month is 0 to 11.
gboolean time_is_leap_year ();
gint year
Returns whether the specified year is a leap year. Year is the normal year, e.g. 2001.
gint time_leap_years_up_to ();
gint year
Returns the number of leap years since year 1 up to (but not including) the specified year. Year is the normal year, e.g. 2001.
gchar * isodate_from_time_t ();
time_t t
Creates an ISO 8601 UTC representation from a time value.
time_t time_from_isodate (const
);gchar *str
Converts an ISO 8601 UTC time string into a time_t value.
time_t time_add_day (,
time_t time);
gint days
Adds a day onto the time, using local time.
Note that if clocks go forward due to daylight savings time, there are
some non-existent local times, so the hour may be changed to make it a
valid time. This also means that it may not be wise to keep calling
time_add_day()
to step through a certain period - if the hour gets changed
to make it valid time, any further calls to time_add_day()
will also return
this hour, which may not be what you want.
time_t time_add_week (,
time_t time);
gint weeks
Adds the given number of weeks to a time value.
time_t time_day_begin ();
time_t t
Returns the start of the day, according to the local time.
time_t time_day_end ();
time_t t
Returns the end of the day, according to the local time.
time_t time_add_day_with_zone (,
time_t time,
gint days);
icaltimezone *zone
Adds or subtracts a number of days to/from the given time_t value, using
the given timezone.
NOTE: this function is only here to make the transition to the timezone
functions easier. New code should use icaltimetype values and
icaltime_adjust()
time_t time_add_week_with_zone (,
time_t time,
gint weeks);
icaltimezone *zone
Adds or subtracts a number of weeks to/from the given time_t value, using
the given timezone.
NOTE: this function is only here to make the transition to the timezone
functions easier. New code should use icaltimetype values and
icaltime_adjust()
time_t time_add_month_with_zone (,
time_t time,
gint months);
icaltimezone *zone
Adds or subtracts a number of months to/from the given time_t value, using the given timezone.
If the day would be off the end of the month (e.g. adding 1 month to 30th January, would lead to an invalid day, 30th February), it moves it down to the last day in the month, e.g. 28th Feb (or 29th in a leap year.)
NOTE: this function is only here to make the transition to the timezone
functions easier. New code should use icaltimetype values and
icaltime_adjust()
time_t time_year_begin_with_zone (,
time_t time);
icaltimezone *zone
Returns the start of the year containing the given time_t, using the given
timezone.
NOTE: this function is only here to make the transition to the timezone
functions easier. New code should use icaltimetype values and
icaltime_adjust()
time_t time_month_begin_with_zone (,
time_t time);
icaltimezone *zone
Returns the start of the month containing the given time_t, using the given
timezone.
NOTE: this function is only here to make the transition to the timezone
functions easier. New code should use icaltimetype values and
icaltime_adjust()
time_t time_week_begin_with_zone (,
time_t time,
gint week_start_day);
icaltimezone *zone
Returns the start of the week containing the given time_t, using the given
timezone. week_start_day should use the same values as mktime()
icaltime_adjust()
time_t time_day_begin_with_zone (,
time_t time);
icaltimezone *zone
Returns the start of the day containing the given time_t, using the given
timezone.
NOTE: this function is only here to make the transition to the timezone
functions easier. New code should use icaltimetype values and
icaltime_adjust()
time_t time_day_end_with_zone (,
time_t time);
icaltimezone *zone
Returns the end of the day containing the given time_t, using the given
timezone. (The end of the day is the start of the next day.)
NOTE: this function is only here to make the transition to the timezone
functions easier. New code should use icaltimetype values and
icaltime_adjust()
void time_to_gdate_with_zone (,
GDate *date,
time_t time);
icaltimezone *zone
Converts a time_t value to a g_date_set_time()
struct tm
icaltimetype_to_tm (struct icaltimetype *itt
);
Convers an icaltimetype structure into a GLibc's struct tm.
The converted time as a struct tm. All fields will be set properly except for tm.tm_yday.
[transfer full]
Since: 2.22
struct tm icaltimetype_to_tm_with_zone (struct icaltimetype *itt
,,
icaltimezone *from_zone);
icaltimezone *to_zone
Converts a time value from one timezone to another, and returns a struct tm representation of the time.
The converted time as a struct tm. All fields will be set properly except for tm.tm_yday.
[transfer full]
Since: 2.22
structicaltimetype tm_to_icaltimetype (struct tm *tm
,);
gboolean is_date
Converts a struct tm into an icaltimetype.
Since: 2.22