gstreamer/gst/gstdatetime.h

/* GStreamer
 * Copyright (C) 2010 Thiago Santos <thiago.sousa.santos@collabora.co.uk>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 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
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library 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 __GST_DATE_TIME_H__
#define __GST_DATE_TIME_H__

#include <time.h>
#include <glib.h>

G_BEGIN_DECLS

/**
 * GstDateTime:
 *
 * Opaque, immutable, refcounted struct that stores date, time and timezone
 * information. It currently supports ranges from 0001-01-01 to
 * 9999-12-31 in the Gregorian proleptic calendar.
 *
 * Use the acessor functions to get the stored values.
 */
typedef struct _GstDateTime GstDateTime;

gint	gst_date_time_get_year 		(const GstDateTime * datetime);
gint	gst_date_time_get_month		(const GstDateTime * datetime);
gint	gst_date_time_get_day		(const GstDateTime * datetime);
gint	gst_date_time_get_hour 		(const GstDateTime * datetime);
gint	gst_date_time_get_minute 	(const GstDateTime * datetime);
gint	gst_date_time_get_second 	(const GstDateTime * datetime);
gint	gst_date_time_get_microsecond 	(const GstDateTime * datetime);
gfloat	gst_date_time_get_time_zone_offset (const GstDateTime * datetime);

GstDateTime 	*gst_date_time_new_from_unix_epoch_local_time (gint64 secs) G_GNUC_MALLOC;
GstDateTime 	*gst_date_time_new_from_unix_epoch_utc  (gint64 secs) G_GNUC_MALLOC;
GstDateTime 	*gst_date_time_new_local_time		(gint year, gint month,
							 gint day, gint hour,
							 gint minute,
							 gdouble seconds) G_GNUC_MALLOC;
GstDateTime 	*gst_date_time_new			(gfloat tzoffset,
							 gint year, gint month,
							 gint day, gint hour,
							 gint minute,
							 gdouble seconds) G_GNUC_MALLOC;
GstDateTime 	*gst_date_time_new_now_local_time (void) G_GNUC_MALLOC;
GstDateTime 	*gst_date_time_new_now_utc 	(void) G_GNUC_MALLOC;

GstDateTime 	*gst_date_time_ref 		(GstDateTime * datetime);
void 		gst_date_time_unref 		(GstDateTime * datetime);

G_END_DECLS
#endif /* __GST_DATE_TIME_H__ */