time_days_in_month ()

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).

time_day_of_year ()

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.

time_day_of_week ()

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.

time_is_leap_year ()

gboolean
time_is_leap_year (gint year);

Returns whether the specified year is a leap year. Year is the normal year, e.g. 2001.

time_leap_years_up_to ()

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.

isodate_from_time_t ()

gchar *
isodate_from_time_t (time_t t);

Creates an ISO 8601 UTC representation from a time value.

time_from_isodate ()

time_t
time_from_isodate (const gchar *str);

Converts an ISO 8601 UTC time string into a time_t value.

time_add_day ()

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_add_week ()

time_t
time_add_week (time_t time,
               gint weeks);

Adds the given number of weeks to a time value.

time_day_begin ()

time_t
time_day_begin (time_t t);

Returns the start of the day, according to the local time.

time_day_end ()

time_t
time_day_end (time_t t);

Returns the end of the day, according to the local time.

time_add_day_with_zone ()

time_t
time_add_day_with_zone (time_t time,
                        gint days,
                        const 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 ICalTime values and i_cal_time_adjust() to add or subtract days, hours, minutes & seconds.

time_add_week_with_zone ()

time_t
time_add_week_with_zone (time_t time,
                         gint weeks,
                         const 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 ICalTime values and i_cal_time_adjust() to add or subtract days, hours, minutes & seconds.

time_add_month_with_zone ()

time_t
time_add_month_with_zone (time_t time,
                          gint months,
                          const 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 ICalTime values and i_cal_time_adjust() to add or subtract days, hours, minutes & seconds.

time_year_begin_with_zone ()

time_t
time_year_begin_with_zone (time_t time,
                           const 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 ICalTime values and i_cal_time_adjust() to add or subtract days, hours, minutes & seconds.

time_month_begin_with_zone ()

time_t
time_month_begin_with_zone (time_t time,
                            const 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 ICalTime values and i_cal_time_adjust() to add or subtract days, hours, minutes & seconds.

time_week_begin_with_zone ()

time_t
time_week_begin_with_zone (time_t time,
                           gint week_start_day,
                           const 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(), i.e. 0 (Sun) to 6 (Sat). NOTE: this function is only here to make the transition to the timezone functions easier. New code should use ICalTime values and i_cal_time_adjust() to add or subtract days, hours, minutes & seconds.

time_day_begin_with_zone ()

time_t
time_day_begin_with_zone (time_t time,
                          const 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 ICalTime values and i_cal_time_adjust() to add or subtract days, hours, minutes & seconds.

time_day_end_with_zone ()

time_t
time_day_end_with_zone (time_t time,
                        const 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 ICalTime values and i_cal_time_adjust() to add or subtract days, hours, minutes & seconds.

time_to_gdate_with_zone ()

void
time_to_gdate_with_zone (GDate *date,
                         time_t time,
                         const ICalTimezone *zone);

Converts a time_t value to a GDate structure using the specified timezone. This is analogous to g_date_set_time() but takes the timezone into account.

e_cal_util_icaltime_to_tm ()

struct tm
e_cal_util_icaltime_to_tm (const ICalTime *itt);

Converts an ICalTime into a GLibc's struct tm.

Since: 2.22

e_cal_util_icaltime_to_tm_with_zone ()

struct tm
e_cal_util_icaltime_to_tm_with_zone (const ICalTime *itt,
                                     const ICalTimezone *from_zone,
                                     const ICalTimezone *to_zone);

Converts a time value from one timezone to another, and returns a struct tm representation of the time.

Since: 2.22

e_cal_util_tm_to_icaltime ()

ICalTime *
e_cal_util_tm_to_icaltime (struct tm *tm,
                           gboolean is_date);

Converts a struct tm into an ICalTime. Free the returned object with g_object_unref(), when no longer needed.

Since: 2.22

e_cal_util_guess_timezone ()

ICalTimezone *
e_cal_util_guess_timezone (const gchar *tzid);

Tries to match the tzid with a built-in iCal timezone.

Whenever possible, the timezone should be taken from the timezone cache or the VCALENDAR component the owner component belongs to, this should be used just as the last resort when such time zone could not be found.

Since: 3.58

e_cal_util_comp_time_to_zone ()

time_t
e_cal_util_comp_time_to_zone (ICalComponent *icomp,
                              ICalPropertyKind prop_kind,
                              ICalTimezone *to_zone,
                              ICalComponent *vcalendar,
                              ETimezoneCache *tz_cache,
                              ICalTime **out_itt);

Converts the time/date property prop_kind to to_zone . When such property does not exist, or does not contain DATE nor DATE-TIME value, then the function returns -1 and no output argument is set.

The vcalendar is used to get the timezone for the property, if provided, otherwise the timezone is tried to be found in the tz_cache . If neither can get it, the iCal builtin timezones are checked. When the set timezone cannot be found, floating time is used (which can be almost always wrong).

Note: this uses i_cal_component_get_first_property(), thus it cannot be used in case any upper caller uses it too at the same time.

Since: 3.58

e_cal_util_property_time_to_zone ()

time_t
e_cal_util_property_time_to_zone (ICalProperty *prop,
                                  ICalTimezone *to_zone,
                                  ICalComponent *vcalendar,
                                  ETimezoneCache *tz_cache,
                                  ICalTime **out_itt);

Converts the time/date property prop to to_zone . When such property does not contain DATE nor DATE-TIME value, the function returns -1 and no output argument is set.

The vcalendar is used to get the timezone for the property, if provided, otherwise the timezone is tried to be found in the tz_cache . If neither can get it, the iCal builtin timezones are checked. When the set timezone cannot be found, floating time is used (which can be almost always wrong).

Since: 3.58

e_cal_util_time_to_zone ()

time_t
e_cal_util_time_to_zone (const ICalTime *itt,
                         const gchar *tzid,
                         ICalTimezone *to_zone,
                         ICalComponent *vcalendar,
                         ETimezoneCache *tz_cache,
                         ICalTime **out_itt);

Converts the itt in tzid to to_zone .

The vcalendar is used to get the timezone for the property, if provided, otherwise the timezone is tried to be found in the tz_cache . If neither can get it, the iCal builtin timezones are checked. When the set timezone cannot be found, floating time is used (which can be almost always wrong).

Since: 3.58