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
representing 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 be created only for year
. If
day
== -1, then #GstDateTime will be created for year
and month
and
so on.
Offset from UTC in hours.
the gregorian year
the gregorian month
the day of the gregorian month
the hour of the day
the minute of the hour
the second of the minute
Returns the day of the month of this #GstDateTime.
Retrieves the hour of the day represented by datetime
in the gregorian
calendar. The return is in the range of 0 to 23.
Retrieves the fractional part of the seconds in microseconds represented by
datetime
in the gregorian calendar.
Retrieves the minute of the hour represented by datetime
in the gregorian
calendar.
Returns the month of this #GstDateTime. January is 1, February is 2, etc..
Retrieves the second of the minute represented by datetime
in the gregorian
calendar.
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 year of this #GstDateTime. Call gst_date_time_has_year() before, to avoid warnings.
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
Atomically decrements the reference count of datetime
by one. When the
reference count reaches zero, the structure is freed.
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
representing 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 be created only for year
. If
day
== -1, then #GstDateTime will be created for year
and month
and
so on.
Offset from UTC in hours.
the gregorian year
the gregorian month
the day of the gregorian month
the hour of the day
the minute of the hour
the second of the minute
Tries to parse common variants of ISO-8601 datetime strings into a
#GstDateTime. Possible input formats are (for example):
2012-06-30T22:46:43Z
, 2012
, 2012-06
, 2012-06-30
, 2012-06-30T22:46:43-0430
,
2012-06-30T22:46Z
, 2012-06-30T22:46-0430
, 2012-06-30 22:46
,
2012-06-30 22:46:43
, 2012-06-00
, 2012-00-00
, 2012-00-30
, 22:46:43Z
, 22:46Z
,
22:46:43-0430
, 22:46-0430
, 22:46:30
, 22:46
If no date is provided, it is assumed to be "today" in the timezone
provided (if any), otherwise UTC.
ISO 8601-formatted datetime string.
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.
the gregorian year
the gregorian month, or -1
the day of the gregorian month, or -1
the hour of the day, or -1
the minute of the hour, or -1
the second of the minute, or -1
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
.
the gregorian year
the gregorian month
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.
the gregorian year
the gregorian month
the day of the gregorian month
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.