c3876df777
2001-10-24 Federico Mena Quintero <federico@ximian.com> Fixes bug #5282. * cal-util/timeutil.c (icaltimetype_to_tm_with_zone): New function to avoid copying the same code all over the place. (icaltimetype_to_tm): Also set the tm.tm_wday. * gui/alarm-notify/alarm-queue.c (queue_midnight_refresh): Use time_day_end_with_zone(). (load_alarms_for_today): Likewise. And oops, we were only computing the times and not loading the alarms. (obj_updated_cb): Likewise. (load_alarms): Removed assertion that is no longer valid because we may load the alarms for a client in two stages. * gui/dialogs/alarm-page.c (get_alarm_string): Convert absolute trigger times to the local timezone. * gui/alarm-notify/alarm-notify-dialog.c (write_html_heading): Convert the times to the local timezone. (alarm_notify_dialog): Likewise, for the window title. (alarm_notify_dialog): Set the window layer to WIN_LAYER_ONTOP. * gui/e-cell-date-edit-text.c (ecd_get_text): Use icaltimetype_to_tm_with_zone(). * gui/alarm-notify/save.c (get_config_db): Made public. (discard_config_db): Made public. * gui/alarm-notify/config-data.[ch]: New files with functions to fetch the calendar configuration data used by the alarm daemon. svn path=/trunk/; revision=13986
123 lines
4.7 KiB
C
123 lines
4.7 KiB
C
/* Miscellaneous time-related utilities
|
|
*
|
|
* Copyright (C) 1998 The Free Software Foundation
|
|
* Copyright (C) 2000 Ximian, Inc.
|
|
*
|
|
* Authors: Federico Mena <federico@ximian.com>
|
|
* Miguel de Icaza <miguel@ximian.com>
|
|
* Damon Chaplin <damon@ximian.com>
|
|
*/
|
|
|
|
#ifndef TIMEUTIL_H
|
|
#define TIMEUTIL_H
|
|
|
|
|
|
#include <time.h>
|
|
#include <ical.h>
|
|
#include <glib.h>
|
|
|
|
|
|
/**************************************************************************
|
|
* General time functions.
|
|
**************************************************************************/
|
|
|
|
/* Returns the number of days in the month. Year is the normal year, e.g. 2001.
|
|
Month is 0 (Jan) to 11 (Dec). */
|
|
int time_days_in_month (int year, int month);
|
|
|
|
/* 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. */
|
|
int time_day_of_year (int day, int month, int 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. */
|
|
int time_day_of_week (int day, int month, int year);
|
|
|
|
/* Returns whether the specified year is a leap year. Year is the normal year,
|
|
e.g. 2001. */
|
|
gboolean time_is_leap_year (int 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. */
|
|
int time_leap_years_up_to (int year);
|
|
|
|
/* Convert to or from an ISO 8601 representation of a time, in UTC,
|
|
e.g. "20010708T183000Z". */
|
|
char *isodate_from_time_t (time_t t);
|
|
time_t time_from_isodate (const char *str);
|
|
|
|
|
|
/**************************************************************************
|
|
* time_t manipulation functions.
|
|
*
|
|
* NOTE: these use the Unix timezone functions like mktime() and localtime()
|
|
* and so should not be used in Evolution. New Evolution code should use
|
|
* icaltimetype values rather than time_t values wherever possible.
|
|
**************************************************************************/
|
|
|
|
/* Add or subtract a number of days, weeks or months. */
|
|
time_t time_add_day (time_t time, int days);
|
|
time_t time_add_week (time_t time, int weeks);
|
|
|
|
/* Returns the beginning or end of the day. */
|
|
time_t time_day_begin (time_t t);
|
|
time_t time_day_end (time_t t);
|
|
|
|
|
|
/**************************************************************************
|
|
* time_t manipulation functions, using timezones in libical.
|
|
*
|
|
* NOTE: these are only here to make the transition to the timezone
|
|
* functions easier. New code should use icaltimetype values rather than
|
|
* time_t values wherever possible.
|
|
**************************************************************************/
|
|
|
|
/* Adds or subtracts a number of days to/from the given time_t value, using
|
|
the given timezone. */
|
|
time_t time_add_day_with_zone (time_t time, int days, icaltimezone *zone);
|
|
|
|
/* Adds or subtracts a number of weeks to/from the given time_t value, using
|
|
the given timezone. */
|
|
time_t time_add_week_with_zone (time_t time, int weeks, icaltimezone *zone);
|
|
|
|
/* Adds or subtracts a number of months to/from the given time_t value, using
|
|
the given timezone. */
|
|
time_t time_add_month_with_zone (time_t time, int months, icaltimezone *zone);
|
|
|
|
/* Returns the start of the year containing the given time_t, using the given
|
|
timezone. */
|
|
time_t time_year_begin_with_zone (time_t time, icaltimezone *zone);
|
|
|
|
/* Returns the start of the month containing the given time_t, using the given
|
|
timezone. */
|
|
time_t time_month_begin_with_zone (time_t time, 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). */
|
|
time_t time_week_begin_with_zone (time_t time, int week_start_day,
|
|
icaltimezone *zone);
|
|
|
|
/* Returns the start of the day containing the given time_t, using the given
|
|
timezone. */
|
|
time_t time_day_begin_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.) */
|
|
time_t time_day_end_with_zone (time_t time, icaltimezone *zone);
|
|
|
|
void time_to_gdate_with_zone (GDate *date, time_t time, icaltimezone *zone);
|
|
|
|
/**************************************************************************
|
|
* struct tm manipulation
|
|
**************************************************************************/
|
|
|
|
struct tm icaltimetype_to_tm (struct icaltimetype *itt);
|
|
struct tm icaltimetype_to_tm_with_zone (struct icaltimetype *itt,
|
|
icaltimezone *from_zone,
|
|
icaltimezone *to_zone);
|
|
struct icaltimetype tm_to_icaltimetype (struct tm *tm, gboolean is_date);
|
|
|
|
#endif
|