/*
 * This file is part of gtkD.
 *
 * gtkD 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 3
 * of the License, or (at your option) any later version, with
 * some exceptions, please read the COPYING file.
 *
 * gtkD 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 gtkD; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
 */
 
// generated automatically - do not change
// find conversion definition on APILookup.txt
// implement new conversion functionalities on the wrap.utils pakage

/*
 * Conversion parameters:
 * inFile  = gstreamer-GstDateTime.html
 * outPack = gstreamer
 * outFile = DateTime
 * strct   = GstDateTime
 * realStrct=
 * ctorStrct=
 * clss    = DateTime
 * interf  = 
 * class Code: Yes
 * interface Code: No
 * template for:
 * extend  = 
 * implements:
 * prefixes:
 * 	- gst_date_time_
 * omit structs:
 * omit prefixes:
 * omit code:
 * 	- gst_date_time_new_now_utc
 * 	- gst_date_time_new_now_local_time
 * 	- gst_date_time_new_from_unix_epoch_utc
 * 	- gst_date_time_new_from_unix_epoch_local_time
 * omit signals:
 * imports:
 * 	- glib.Str
 * 	- gstreamer.DateTime
 * structWrap:
 * 	- GstDateTime* -> DateTime
 * module aliases:
 * local aliases:
 * overrides:
 */

module gstreamer.DateTime;

public  import gstreamerc.gstreamertypes;

private import gstreamerc.gstreamer;
private import glib.ConstructionException;
private import gobject.ObjectG;


private import glib.Str;
private import gstreamer.DateTime;




/**
 * Struct to store date, time and timezone information altogether.
 * GstDateTime is refcounted and immutable.
 *
 * Date information is handled using the proleptic Gregorian calendar.
 *
 * Provides basic creation functions and accessor functions to its fields.
 */
public class DateTime
{
	
	/** the main Gtk struct */
	protected GstDateTime* gstDateTime;
	
	
	public GstDateTime* getDateTimeStruct()
	{
		return gstDateTime;
	}
	
	
	/** the main Gtk struct as a void* */
	protected void* getStruct()
	{
		return cast(void*)gstDateTime;
	}
	
	/**
	 * Sets our main struct and passes it to the parent class
	 */
	public this (GstDateTime* gstDateTime)
	{
		this.gstDateTime = gstDateTime;
	}
	
	/**
	 * Creates a new GstDateTime representing the current date and time.
	 *
	 * Params:
	 *     utc  = If true use utc else use the local timezone.
	 * Throws: ConstructionException GTK+ fails to create the object.
	 */
	public this (bool utc)
	{
		GstDateTime* p;
		
		if ( utc )
		{
			p = gst_date_time_new_now_utc();
		}
		else
		{
			p = gst_date_time_new_now_local_time();
		}
		
		if(p is null)
		{
			throw new ConstructionException("null returned by gst_date_time_new_now_local_time()");
		}
		this(cast(GstDateTime*) p);
	}
	
	/**
	 * Creates a new GstDateTime using the time since Jan 1, 1970 specified by
	 * secs.
	 *
	 * Params:
	 *     secs = Seconds from the Unix epoch
	 *     utc  = If true use utc else use the local timezone.
	 * Throws: ConstructionException GTK+ fails to create the object.
	 */
	public this (long secs, bool utc)
	{
		GstDateTime* p;
		
		if ( utc )
		{
			p = gst_date_time_new_from_unix_epoch_utc(secs);
		}
		else
		{
			p = gst_date_time_new_from_unix_epoch_local_time(secs);
		}
		
		if(p is null)
		{
			throw new ConstructionException("null returned by gst_date_time_new_from_unix_epoch_local_time(secs)");
		}
		this(cast(GstDateTime*) p);
	}
	
	/**
	 */
	
	/**
	 * Returns the day of the month of this GstDateTime.
	 * Call gst_date_time_has_day before, to avoid warnings.
	 * Returns: The day of this GstDateTime
	 */
	public int getDay()
	{
		// gint gst_date_time_get_day (const GstDateTime *datetime);
		return gst_date_time_get_day(gstDateTime);
	}
	
	/**
	 * Returns the month of this GstDateTime. January is 1, February is 2, etc..
	 * Call gst_date_time_has_month before, to avoid warnings.
	 * Returns: The month of this GstDateTime
	 */
	public int getMonth()
	{
		// gint gst_date_time_get_month (const GstDateTime *datetime);
		return gst_date_time_get_month(gstDateTime);
	}
	
	/**
	 * Retrieves the hour of the day represented by datetime in the gregorian
	 * calendar. The return is in the range of 0 to 23.
	 * Call gst_date_time_has_haur before, to avoid warnings.
	 * Returns: the hour of the day
	 */
	public int getHour()
	{
		// gint gst_date_time_get_hour (const GstDateTime *datetime);
		return gst_date_time_get_hour(gstDateTime);
	}
	
	/**
	 * Retrieves the fractional part of the seconds in microseconds represented by
	 * datetime in the gregorian calendar.
	 * Returns: the microsecond of the second
	 */
	public int getMicrosecond()
	{
		// gint gst_date_time_get_microsecond (const GstDateTime *datetime);
		return gst_date_time_get_microsecond(gstDateTime);
	}
	
	/**
	 * Retrieves the minute of the hour represented by datetime in the gregorian
	 * calendar.
	 * Call gst_date_time_has_minute before, to avoid warnings.
	 * Returns: the minute of the hour
	 */
	public int getMinute()
	{
		// gint gst_date_time_get_minute (const GstDateTime *datetime);
		return gst_date_time_get_minute(gstDateTime);
	}
	
	/**
	 * Retrieves the offset from UTC in hours that the timezone specified
	 * by datetime represents. Timezones ahead (to the east) of UTC have positive
	 * values, timezones before (to the west) of UTC have negative values.
	 * If datetime represents UTC time, then the offset is zero.
	 * Returns: the offset from UTC in hours
	 */
	public float getTimeZoneOffset()
	{
		// gfloat gst_date_time_get_time_zone_offset (const GstDateTime *datetime);
		return gst_date_time_get_time_zone_offset(gstDateTime);
	}
	
	/**
	 * Retrieves the second of the minute represented by datetime in the gregorian
	 * calendar.
	 * Call gst_date_time_has_second before, to avoid warnings.
	 * Returns: the second represented by datetime
	 */
	public int getSecond()
	{
		// gint gst_date_time_get_second (const GstDateTime *datetime);
		return gst_date_time_get_second(gstDateTime);
	}
	
	/**
	 * Returns the year of this GstDateTime
	 * Call gst_date_time_has_year before, to avoid warnings.
	 * Returns: The year of this GstDateTime
	 */
	public int getYear()
	{
		// gint gst_date_time_get_year (const GstDateTime *datetime);
		return gst_date_time_get_year(gstDateTime);
	}
	
	/**
	 * Creates a new GstDateTime using the date and times in the gregorian calendar
	 * in the supplied timezone.
	 * year should be from 1 to 9999, month should be from 1 to 12, day from
	 * 1 to 31, hour from 0 to 23, minutes and seconds from 0 to 59.
	 * Note that tzoffset is a float and was chosen so for being able to handle
	 * some fractional timezones, while it still keeps the readability of
	 * represeting it in hours for most timezones.
	 * If value is -1 then all over value will be ignored. For example
	 * if month == -1, then GstDateTime will created only for year. If
	 * day == -1, then GstDateTime will created for year and month and
	 * so on.
	 * Free-function: gst_date_time_unref
	 * Params:
	 * tzoffset = Offset from UTC in hours.
	 * year = the gregorian year
	 * month = the gregorian month
	 * day = the day of the gregorian month
	 * hour = the hour of the day
	 * minute = the minute of the hour
	 * seconds = the second of the minute
	 * Throws: ConstructionException GTK+ fails to create the object.
	 */
	public this (float tzoffset, int year, int month, int day, int hour, int minute, double seconds)
	{
		// GstDateTime * gst_date_time_new (gfloat tzoffset,  gint year,  gint month,  gint day,  gint hour,  gint minute,  gdouble seconds);
		auto p = gst_date_time_new(tzoffset, year, month, day, hour, minute, seconds);
		if(p is null)
		{
			throw new ConstructionException("null returned by gst_date_time_new(tzoffset, year, month, day, hour, minute, seconds)");
		}
		this(cast(GstDateTime*) p);
	}
	
	/**
	 * Creates a new GstDateTime using the date and times in the gregorian calendar
	 * in the local timezone.
	 * year should be from 1 to 9999, month should be from 1 to 12, day from
	 * 1 to 31.
	 * If value is -1 then all over value will be ignored. For example
	 * if month == -1, then GstDateTime will created only for year. If
	 * day == -1, then GstDateTime will created for year and month and
	 * so on.
	 * Free-function: gst_date_time_unref
	 * Params:
	 * year = the gregorian year
	 * month = the gregorian month
	 * day = the day of the gregorian month
	 * Throws: ConstructionException GTK+ fails to create the object.
	 */
	public this (int year, int month, int day)
	{
		// GstDateTime * gst_date_time_new_ymd (gint year,  gint month,  gint day);
		auto p = gst_date_time_new_ymd(year, month, day);
		if(p is null)
		{
			throw new ConstructionException("null returned by gst_date_time_new_ymd(year, month, day)");
		}
		this(cast(GstDateTime*) p);
	}
	
	/**
	 * Creates a new GstDateTime using the date and times in the gregorian calendar
	 * in the local timezone.
	 * year should be from 1 to 9999, month should be from 1 to 12.
	 * If value is -1 then all over value will be ignored. For example
	 * if month == -1, then GstDateTime will created only for year.
	 * Free-function: gst_date_time_unref
	 * Params:
	 * year = the gregorian year
	 * month = the gregorian month
	 * Throws: ConstructionException GTK+ fails to create the object.
	 */
	public this (int year, int month)
	{
		// GstDateTime * gst_date_time_new_ym (gint year,  gint month);
		auto p = gst_date_time_new_ym(year, month);
		if(p is null)
		{
			throw new ConstructionException("null returned by gst_date_time_new_ym(year, month)");
		}
		this(cast(GstDateTime*) p);
	}
	
	/**
	 * Creates a new GstDateTime using the date and times in the gregorian calendar
	 * in the local timezone.
	 * year should be from 1 to 9999.
	 * Free-function: gst_date_time_unref
	 * Params:
	 * year = the gregorian year
	 * Throws: ConstructionException GTK+ fails to create the object.
	 */
	public this (int year)
	{
		// GstDateTime * gst_date_time_new_y (gint year);
		auto p = gst_date_time_new_y(year);
		if(p is null)
		{
			throw new ConstructionException("null returned by gst_date_time_new_y(year)");
		}
		this(cast(GstDateTime*) p);
	}
	
	/**
	 * Creates a new GstDateTime using the date and times in the gregorian calendar
	 * in the local timezone.
	 * year should be from 1 to 9999, month should be from 1 to 12, day from
	 * 1 to 31, hour from 0 to 23, minutes and seconds from 0 to 59.
	 * If month is -1, then the GstDateTime created will only contain year,
	 * and all other fields will be considered not set.
	 * If day is -1, then the GstDateTime created will only contain year and
	 * month and all other fields will be considered not set.
	 * If hour is -1, then the GstDateTime created will only contain year and
	 * month and day, and the time fields will be considered not set. In this
	 * case minute and seconds should also be -1.
	 * Free-function: gst_date_time_unref
	 * Params:
	 * year = the gregorian year
	 * month = the gregorian month, or -1
	 * day = the day of the gregorian month, or -1
	 * hour = the hour of the day, or -1
	 * minute = the minute of the hour, or -1
	 * seconds = the second of the minute, or -1
	 * Throws: ConstructionException GTK+ fails to create the object.
	 */
	public this (int year, int month, int day, int hour, int minute, double seconds)
	{
		// GstDateTime * gst_date_time_new_local_time (gint year,  gint month,  gint day,  gint hour,  gint minute,  gdouble seconds);
		auto p = gst_date_time_new_local_time(year, month, day, hour, minute, seconds);
		if(p is null)
		{
			throw new ConstructionException("null returned by gst_date_time_new_local_time(year, month, day, hour, minute, seconds)");
		}
		this(cast(GstDateTime*) p);
	}
	
	/**
	 * Atomically increments the reference count of datetime by one.
	 * Returns: the reference datetime. [transfer full]
	 */
	public DateTime doref()
	{
		// GstDateTime * gst_date_time_ref (GstDateTime *datetime);
		auto p = gst_date_time_ref(gstDateTime);
		
		if(p is null)
		{
			return null;
		}
		
		return ObjectG.getDObject!(DateTime)(cast(GstDateTime*) p);
	}
	
	/**
	 * Atomically decrements the reference count of datetime by one. When the
	 * reference count reaches zero, the structure is freed.
	 */
	public void unref()
	{
		// void gst_date_time_unref (GstDateTime *datetime);
		gst_date_time_unref(gstDateTime);
	}
	
	/**
	 * Returns: TRUE if datetime's day field is set, otherwise FALSE
	 */
	public int hasDay()
	{
		// gboolean gst_date_time_has_day (const GstDateTime *datetime);
		return gst_date_time_has_day(gstDateTime);
	}
	
	/**
	 * Returns: TRUE if datetime's month field is set, otherwise FALSE
	 */
	public int hasMonth()
	{
		// gboolean gst_date_time_has_month (const GstDateTime *datetime);
		return gst_date_time_has_month(gstDateTime);
	}
	
	/**
	 * Returns: TRUE if datetime's second field is set, otherwise FALSE
	 */
	public int hasSecond()
	{
		// gboolean gst_date_time_has_second (const GstDateTime *datetime);
		return gst_date_time_has_second(gstDateTime);
	}
	
	/**
	 * Returns: TRUE if datetime's hour and minute fields are set, otherwise FALSE
	 */
	public int hasTime()
	{
		// gboolean gst_date_time_has_time (const GstDateTime *datetime);
		return gst_date_time_has_time(gstDateTime);
	}
	
	/**
	 * Returns: TRUE if datetime's year field is set (which should always be the case), otherwise FALSE
	 */
	public int hasYear()
	{
		// gboolean gst_date_time_has_year (const GstDateTime *datetime);
		return gst_date_time_has_year(gstDateTime);
	}
	
	/**
	 * Tries to parse common variants of ISO-8601 datetime strings into a
	 * GstDateTime.
	 * Free-function: gst_date_time_unref
	 * Params:
	 * string = ISO 8601-formatted datetime string.
	 * Throws: ConstructionException GTK+ fails to create the object.
	 */
	public this (string string)
	{
		// GstDateTime * gst_date_time_new_from_iso8601_string  (const gchar *string);
		auto p = gst_date_time_new_from_iso8601_string(Str.toStringz(string));
		if(p is null)
		{
			throw new ConstructionException("null returned by gst_date_time_new_from_iso8601_string(Str.toStringz(string))");
		}
		this(cast(GstDateTime*) p);
	}
	
	/**
	 * Create a minimal string compatible with ISO-8601. Possible output formats
	 * are (for example): 2012, 2012-06, 2012-06-23, 2012-06-23T23:30Z,
	 * 2012-06-23T23:30+0100, 2012-06-23T23:30:59Z, 2012-06-23T23:30:59+0100
	 * Returns: a newly allocated string formatted according to ISO 8601 and only including the datetime fields that are valid, or NULL in case there was an error. The string should be freed with g_free().
	 */
	public string toIso8601_String()
	{
		// gchar * gst_date_time_to_iso8601_string (GstDateTime *datetime);
		return Str.toString(gst_date_time_to_iso8601_string(gstDateTime));
	}
	
	/**
	 * Creates a new GstDateTime from a GDateTime object.
	 * Free-function: gst_date_time_unref
	 * Params:
	 * dt = the GDateTime. The new GstDateTime takes ownership. [transfer full]
	 * Throws: ConstructionException GTK+ fails to create the object.
	 */
	public this (GDateTime* dt)
	{
		// GstDateTime * gst_date_time_new_from_g_date_time (GDateTime *dt);
		auto p = gst_date_time_new_from_g_date_time(dt);
		if(p is null)
		{
			throw new ConstructionException("null returned by gst_date_time_new_from_g_date_time(dt)");
		}
		this(cast(GstDateTime*) p);
	}
	
	/**
	 * Creates a new GDateTime from a fully defined GstDateTime object.
	 * Free-function: g_date_time_unref
	 * Returns: a newly created GDateTime, or NULL on error. [transfer full]
	 */
	public GDateTime* toGDateTime()
	{
		// GDateTime * gst_date_time_to_g_date_time (GstDateTime *datetime);
		return gst_date_time_to_g_date_time(gstDateTime);
	}
}