/var/data/www/opensync/code/opensync/format/opensync_time.h

/*
 * libopensync - A synchronization framework
 * Copyright (C) 2004-2005  Armin Bauer <armin.bauer@opensync.org>
 * Copyright (C) 2006-2008 Daniel Gollub <dgollub@suse.de>
 * Copyright (C) 2007 Chris Frey <cdfrey@netdirect.ca>
 * 
 * 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.1 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
 * 
 */

#ifndef _OPENSYNC_TIME_H_
#define _OPENSYNC_TIME_H_


/* 
 * Time formatting helper
 */

OSYNC_EXPORT char *osync_time_timestamp(const char *vtime);

OSYNC_EXPORT char *osync_time_datestamp(const char *vtime); 

OSYNC_EXPORT osync_bool osync_time_isdate(const char *vformat);

OSYNC_EXPORT osync_bool osync_time_isutc(const char *vformat);

/*****************************************************************************/


OSYNC_EXPORT struct tm *osync_time_vtime2tm(const char *vtime);

OSYNC_EXPORT char *osync_time_tm2vtime(const struct tm *time, osync_bool is_utc);

/*****************************************************************************/


OSYNC_EXPORT time_t osync_time_vtime2unix(const char *vtime, int offset);

OSYNC_EXPORT char *osync_time_unix2vtime(const time_t *timestamp);

/* Unix time_t converters */

OSYNC_EXPORT time_t osync_time_localtm2unix(const struct tm *localtime);

OSYNC_EXPORT time_t osync_time_utctm2unix(const struct tm *utctime);

OSYNC_EXPORT struct tm *osync_time_unix2localtm(const time_t *timestamp);

OSYNC_EXPORT struct tm *osync_time_unix2utctm(const time_t *timestamp);

/*****************************************************************************/


OSYNC_EXPORT int osync_time_timezone_diff(const struct tm *local);

OSYNC_EXPORT struct tm *osync_time_tm2utc(const struct tm *ltime, int offset);

OSYNC_EXPORT struct tm *osync_time_tm2localtime(const struct tm *utime, int offset);

OSYNC_EXPORT char *osync_time_vtime2utc(const char* localtime, int offset);

OSYNC_EXPORT char *osync_time_vtime2localtime(const char* utc, int offset);

OSYNC_EXPORT int osync_time_utcoffset2sec(const char *offset);

/*****************************************************************************/



OSYNC_EXPORT char *osync_time_vcal2localtime(const char *vcal);

OSYNC_EXPORT char *osync_time_vcal2utc(const char *vcal);


/*****************************************************************************/


OSYNC_EXPORT char *osync_time_sec2alarmdu(int seconds);

OSYNC_EXPORT int osync_time_alarmdu2sec(const char *alarm);

/*****************************************************************************/


OSYNC_EXPORT int osync_time_str2wday(const char *swday);

OSYNC_EXPORT struct tm *osync_time_relative2tm(const char *byday, const int bymonth, const int year);

#ifdef _WIN32
/* Windows does not provide gmtime_r and localtime_r */
/* This module uses these two functions internally   */
/* They are also exported for testing purposes       */
OSYNC_TEST_EXPORT inline struct tm* gmtime_r (const time_t *clock, struct tm *result);
OSYNC_TEST_EXPORT inline struct tm* localtime_r (const time_t *clock, struct tm *result);
#endif /* _WIN32 */

#endif /*_OPENSYNC_TIME_H_*/

---