2 * Copyright (C) 2010 Thiago Santos <thiago.sousa.santos@collabora.co.uk>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
24 #include "glib-compat-private.h"
25 #include "gst_private.h"
26 #include "gstdatetime.h"
35 * @short_description: A date, time and timezone structure
37 * Struct to store date, time and timezone information altogether.
38 * #GstDateTime is refcounted and immutable.
40 * Date information is handled using the proleptic Gregorian calendar.
42 * Provides basic creation functions and accessor functions to its fields.
47 GST_DATE_TIME_FIELDS_INVALID = 0,
48 GST_DATE_TIME_FIELDS_Y, /* have year */
49 GST_DATE_TIME_FIELDS_YM, /* have year and month */
50 GST_DATE_TIME_FIELDS_YMD, /* have year, month and day */
51 GST_DATE_TIME_FIELDS_YMD_HM,
52 GST_DATE_TIME_FIELDS_YMD_HMS
53 /* Note: if we ever add more granularity here, e.g. for microsecs,
54 * the compare function will need updating */
61 GstDateTimeFields fields;
62 volatile gint ref_count;
66 * gst_date_time_new_from_g_date_time:
67 * @dt: (transfer full): the #GDateTime. The new #GstDateTime takes ownership.
69 * Creates a new #GstDateTime from a #GDateTime object.
71 * Free-function: gst_date_time_unref
73 * Returns: (transfer full): a newly created #GstDateTime, or NULL on error
76 gst_date_time_new_from_g_date_time (GDateTime * dt)
83 gst_dt = g_slice_new (GstDateTime);
84 gst_dt->datetime = dt;
85 gst_dt->fields = GST_DATE_TIME_FIELDS_YMD_HMS;
86 gst_dt->ref_count = 1;
91 * gst_date_time_to_g_date_time:
92 * @datetime: GstDateTime.
94 * Creates a new #GDateTime from a fully defined #GstDateTime object.
96 * Free-function: g_date_time_unref
98 * Returns: (transfer full): a newly created #GDateTime, or NULL on error
101 gst_date_time_to_g_date_time (GstDateTime * datetime)
103 g_return_val_if_fail (datetime != NULL, NULL);
105 if (datetime->fields != GST_DATE_TIME_FIELDS_YMD_HMS)
108 return g_date_time_add (datetime->datetime, 0);
112 * gst_date_time_has_year:
113 * @datetime: a #GstDateTime
115 * Returns: TRUE if @datetime<!-- -->'s year field is set (which should always
116 * be the case), otherwise FALSE
119 gst_date_time_has_year (const GstDateTime * datetime)
121 g_return_val_if_fail (datetime != NULL, FALSE);
123 return (datetime->fields >= GST_DATE_TIME_FIELDS_Y);
127 * gst_date_time_has_month:
128 * @datetime: a #GstDateTime
130 * Returns: TRUE if @datetime<!-- -->'s month field is set, otherwise FALSE
133 gst_date_time_has_month (const GstDateTime * datetime)
135 g_return_val_if_fail (datetime != NULL, FALSE);
137 return (datetime->fields >= GST_DATE_TIME_FIELDS_YM);
141 * gst_date_time_has_day:
142 * @datetime: a #GstDateTime
144 * Returns: TRUE if @datetime<!-- -->'s day field is set, otherwise FALSE
147 gst_date_time_has_day (const GstDateTime * datetime)
149 g_return_val_if_fail (datetime != NULL, FALSE);
151 return (datetime->fields >= GST_DATE_TIME_FIELDS_YMD);
155 * gst_date_time_has_time:
156 * @datetime: a #GstDateTime
158 * Returns: TRUE if @datetime<!-- -->'s hour and minute fields are set,
162 gst_date_time_has_time (const GstDateTime * datetime)
164 g_return_val_if_fail (datetime != NULL, FALSE);
166 return (datetime->fields >= GST_DATE_TIME_FIELDS_YMD_HM);
170 * gst_date_time_has_second:
171 * @datetime: a #GstDateTime
173 * Returns: TRUE if @datetime<!-- -->'s second field is set, otherwise FALSE
176 gst_date_time_has_second (const GstDateTime * datetime)
178 g_return_val_if_fail (datetime != NULL, FALSE);
180 return (datetime->fields >= GST_DATE_TIME_FIELDS_YMD_HMS);
184 * gst_date_time_get_year:
185 * @datetime: a #GstDateTime
187 * Returns the year of this #GstDateTime
188 * Call gst_date_time_has_year before, to avoid warnings.
190 * Return value: The year of this #GstDateTime
193 gst_date_time_get_year (const GstDateTime * datetime)
195 g_return_val_if_fail (datetime != NULL, 0);
197 return g_date_time_get_year (datetime->datetime);
201 * gst_date_time_get_month:
202 * @datetime: a #GstDateTime
204 * Returns the month of this #GstDateTime. January is 1, February is 2, etc..
205 * Call gst_date_time_has_month before, to avoid warnings.
207 * Return value: The month of this #GstDateTime
210 gst_date_time_get_month (const GstDateTime * datetime)
212 g_return_val_if_fail (datetime != NULL, 0);
213 g_return_val_if_fail (gst_date_time_has_month (datetime), 0);
215 return g_date_time_get_month (datetime->datetime);
219 * gst_date_time_get_day:
220 * @datetime: a #GstDateTime
222 * Returns the day of the month of this #GstDateTime.
223 * Call gst_date_time_has_day before, to avoid warnings.
225 * Return value: The day of this #GstDateTime
228 gst_date_time_get_day (const GstDateTime * datetime)
230 g_return_val_if_fail (datetime != NULL, 0);
231 g_return_val_if_fail (gst_date_time_has_day (datetime), 0);
233 return g_date_time_get_day_of_month (datetime->datetime);
237 * gst_date_time_get_hour:
238 * @datetime: a #GstDateTime
240 * Retrieves the hour of the day represented by @datetime in the gregorian
241 * calendar. The return is in the range of 0 to 23.
242 * Call gst_date_time_has_haur before, to avoid warnings.
244 * Return value: the hour of the day
247 gst_date_time_get_hour (const GstDateTime * datetime)
249 g_return_val_if_fail (datetime != NULL, 0);
250 g_return_val_if_fail (gst_date_time_has_time (datetime), 0);
252 return g_date_time_get_hour (datetime->datetime);
256 * gst_date_time_get_minute:
257 * @datetime: a #GstDateTime
259 * Retrieves the minute of the hour represented by @datetime in the gregorian
261 * Call gst_date_time_has_minute before, to avoid warnings.
263 * Return value: the minute of the hour
266 gst_date_time_get_minute (const GstDateTime * datetime)
268 g_return_val_if_fail (datetime != NULL, 0);
269 g_return_val_if_fail (gst_date_time_has_time (datetime), 0);
271 return g_date_time_get_minute (datetime->datetime);
275 * gst_date_time_get_second:
276 * @datetime: a #GstDateTime
278 * Retrieves the second of the minute represented by @datetime in the gregorian
280 * Call gst_date_time_has_second before, to avoid warnings.
282 * Return value: the second represented by @datetime
285 gst_date_time_get_second (const GstDateTime * datetime)
287 g_return_val_if_fail (datetime != NULL, 0);
288 g_return_val_if_fail (gst_date_time_has_second (datetime), 0);
290 return g_date_time_get_second (datetime->datetime);
294 * gst_date_time_get_microsecond:
295 * @datetime: a #GstDateTime
297 * Retrieves the fractional part of the seconds in microseconds represented by
298 * @datetime in the gregorian calendar.
300 * Return value: the microsecond of the second
303 gst_date_time_get_microsecond (const GstDateTime * datetime)
305 g_return_val_if_fail (datetime != NULL, 0);
306 g_return_val_if_fail (gst_date_time_has_second (datetime), 0);
308 return g_date_time_get_microsecond (datetime->datetime);
312 * gst_date_time_get_time_zone_offset:
313 * @datetime: a #GstDateTime
315 * Retrieves the offset from UTC in hours that the timezone specified
316 * by @datetime represents. Timezones ahead (to the east) of UTC have positive
317 * values, timezones before (to the west) of UTC have negative values.
318 * If @datetime represents UTC time, then the offset is zero.
320 * Return value: the offset from UTC in hours
323 gst_date_time_get_time_zone_offset (const GstDateTime * datetime)
325 g_return_val_if_fail (datetime != NULL, 0.0);
326 g_return_val_if_fail (gst_date_time_has_time (datetime), 0.0);
328 return (g_date_time_get_utc_offset (datetime->datetime) /
329 G_USEC_PER_SEC) / 3600.0;
333 * gst_date_time_new_y:
334 * @year: the gregorian year
336 * Creates a new #GstDateTime using the date and times in the gregorian calendar
337 * in the local timezone.
339 * @year should be from 1 to 9999.
341 * Free-function: gst_date_time_unref
343 * Return value: (transfer full): the newly created #GstDateTime
346 gst_date_time_new_y (gint year)
348 return gst_date_time_new (0.0, year, -1, -1, -1, -1, -1);
352 * gst_date_time_new_ym:
353 * @year: the gregorian year
354 * @month: the gregorian month
356 * Creates a new #GstDateTime using the date and times in the gregorian calendar
357 * in the local timezone.
359 * @year should be from 1 to 9999, @month should be from 1 to 12.
361 * If value is -1 then all over value will be ignored. For example
362 * if @month == -1, then #GstDateTime will created only for @year.
364 * Free-function: gst_date_time_unref
366 * Return value: (transfer full): the newly created #GstDateTime
369 gst_date_time_new_ym (gint year, gint month)
371 return gst_date_time_new (0.0, year, month, -1, -1, -1, -1);
375 * gst_date_time_new_ymd:
376 * @year: the gregorian year
377 * @month: the gregorian month
378 * @day: the day of the gregorian month
380 * Creates a new #GstDateTime using the date and times in the gregorian calendar
381 * in the local timezone.
383 * @year should be from 1 to 9999, @month should be from 1 to 12, @day from
386 * If value is -1 then all over value will be ignored. For example
387 * if @month == -1, then #GstDateTime will created only for @year. If
388 * @day == -1, then #GstDateTime will created for @year and @month and
391 * Free-function: gst_date_time_unref
393 * Return value: (transfer full): the newly created #GstDateTime
396 gst_date_time_new_ymd (gint year, gint month, gint day)
398 return gst_date_time_new (0.0, year, month, day, -1, -1, -1);
402 * gst_date_time_new_from_unix_epoch_local_time:
403 * @secs: seconds from the Unix epoch
405 * Creates a new #GstDateTime using the time since Jan 1, 1970 specified by
406 * @secs. The #GstDateTime is in the local timezone.
408 * Free-function: gst_date_time_unref
410 * Return value: (transfer full): the newly created #GstDateTime
413 gst_date_time_new_from_unix_epoch_local_time (gint64 secs)
417 datetime = g_date_time_new_from_unix_local (secs);
418 return gst_date_time_new_from_g_date_time (datetime);
422 * gst_date_time_new_from_unix_epoch_utc:
423 * @secs: seconds from the Unix epoch
425 * Creates a new #GstDateTime using the time since Jan 1, 1970 specified by
426 * @secs. The #GstDateTime is in the UTC timezone.
428 * Free-function: gst_date_time_unref
430 * Return value: (transfer full): the newly created #GstDateTime
433 gst_date_time_new_from_unix_epoch_utc (gint64 secs)
435 GstDateTime *datetime;
437 gst_date_time_new_from_g_date_time (g_date_time_new_from_unix_utc (secs));
441 static GstDateTimeFields
442 gst_date_time_check_fields (gint * year, gint * month, gint * day,
443 gint * hour, gint * minute, gdouble * seconds)
447 *hour = *minute = *seconds = 0;
448 return GST_DATE_TIME_FIELDS_Y;
449 } else if (*day == -1) {
451 *hour = *minute = *seconds = 0;
452 return GST_DATE_TIME_FIELDS_YM;
453 } else if (*hour == -1) {
454 *hour = *minute = *seconds = 0;
455 return GST_DATE_TIME_FIELDS_YMD;
456 } else if (*seconds == -1) {
458 return GST_DATE_TIME_FIELDS_YMD_HM;
460 return GST_DATE_TIME_FIELDS_YMD_HMS;
464 * gst_date_time_new_local_time:
465 * @year: the gregorian year
466 * @month: the gregorian month, or -1
467 * @day: the day of the gregorian month, or -1
468 * @hour: the hour of the day, or -1
469 * @minute: the minute of the hour, or -1
470 * @seconds: the second of the minute, or -1
472 * Creates a new #GstDateTime using the date and times in the gregorian calendar
473 * in the local timezone.
475 * @year should be from 1 to 9999, @month should be from 1 to 12, @day from
476 * 1 to 31, @hour from 0 to 23, @minutes and @seconds from 0 to 59.
478 * If @month is -1, then the #GstDateTime created will only contain @year,
479 * and all other fields will be considered not set.
481 * If @day is -1, then the #GstDateTime created will only contain @year and
482 * @month and all other fields will be considered not set.
484 * If @hour is -1, then the #GstDateTime created will only contain @year and
485 * @month and @day, and the time fields will be considered not set. In this
486 * case @minute and @seconds should also be -1.
488 * Free-function: gst_date_time_unref
490 * Return value: (transfer full): the newly created #GstDateTime
493 gst_date_time_new_local_time (gint year, gint month, gint day, gint hour,
494 gint minute, gdouble seconds)
496 GstDateTimeFields fields;
497 GstDateTime *datetime;
499 g_return_val_if_fail (year > 0 && year <= 9999, NULL);
500 g_return_val_if_fail ((month > 0 && month <= 12) || month == -1, NULL);
501 g_return_val_if_fail ((day > 0 && day <= 31) || day == -1, NULL);
502 g_return_val_if_fail ((hour >= 0 && hour < 24) || hour == -1, NULL);
503 g_return_val_if_fail ((minute >= 0 && minute < 60) || minute == -1, NULL);
504 g_return_val_if_fail ((seconds >= 0 && seconds < 60) || seconds == -1, NULL);
506 fields = gst_date_time_check_fields (&year, &month, &day,
507 &hour, &minute, &seconds);
509 datetime = gst_date_time_new_from_g_date_time (g_date_time_new_local (year,
510 month, day, hour, minute, seconds));
512 datetime->fields = fields;
517 * gst_date_time_new_now_local_time:
519 * Creates a new #GstDateTime representing the current date and time.
521 * Free-function: gst_date_time_unref
523 * Return value: (transfer full): the newly created #GstDateTime which should
524 * be freed with gst_date_time_unref().
527 gst_date_time_new_now_local_time (void)
529 return gst_date_time_new_from_g_date_time (g_date_time_new_now_local ());
533 * gst_date_time_new_now_utc:
535 * Creates a new #GstDateTime that represents the current instant at Universal
538 * Free-function: gst_date_time_unref
540 * Return value: (transfer full): the newly created #GstDateTime which should
541 * be freed with gst_date_time_unref().
544 gst_date_time_new_now_utc (void)
546 return gst_date_time_new_from_g_date_time (g_date_time_new_now_utc ());
550 __gst_date_time_compare (const GstDateTime * dt1, const GstDateTime * dt2)
554 /* we assume here that GST_DATE_TIME_FIELDS_YMD_HMS is the highest
555 * resolution, and ignore microsecond differences on purpose for now */
556 if (dt1->fields != dt2->fields)
557 return GST_VALUE_UNORDERED;
559 /* This will round down to nearest second, which is what we want. We're
560 * not comparing microseconds on purpose here, since we're not
561 * serialising them when doing new_utc_now() + to_string() */
563 g_date_time_to_unix (dt1->datetime) - g_date_time_to_unix (dt2->datetime);
565 return GST_VALUE_LESS_THAN;
567 return GST_VALUE_GREATER_THAN;
569 return GST_VALUE_EQUAL;
574 * @tzoffset: Offset from UTC in hours.
575 * @year: the gregorian year
576 * @month: the gregorian month
577 * @day: the day of the gregorian month
578 * @hour: the hour of the day
579 * @minute: the minute of the hour
580 * @seconds: the second of the minute
582 * Creates a new #GstDateTime using the date and times in the gregorian calendar
583 * in the supplied timezone.
585 * @year should be from 1 to 9999, @month should be from 1 to 12, @day from
586 * 1 to 31, @hour from 0 to 23, @minutes and @seconds from 0 to 59.
588 * Note that @tzoffset is a float and was chosen so for being able to handle
589 * some fractional timezones, while it still keeps the readability of
590 * represeting it in hours for most timezones.
592 * If value is -1 then all over value will be ignored. For example
593 * if @month == -1, then #GstDateTime will created only for @year. If
594 * @day == -1, then #GstDateTime will created for @year and @month and
597 * Free-function: gst_date_time_unref
599 * Return value: (transfer full): the newly created #GstDateTime
602 gst_date_time_new (gfloat tzoffset, gint year, gint month, gint day, gint hour,
603 gint minute, gdouble seconds)
605 GstDateTimeFields fields;
609 GstDateTime *datetime;
610 gint tzhour, tzminute;
612 g_return_val_if_fail (year > 0 && year <= 9999, NULL);
613 g_return_val_if_fail ((month > 0 && month <= 12) || month == -1, NULL);
614 g_return_val_if_fail ((day > 0 && day <= 31) || day == -1, NULL);
615 g_return_val_if_fail ((hour >= 0 && hour < 24) || hour == -1, NULL);
616 g_return_val_if_fail ((minute >= 0 && minute < 60) || minute == -1, NULL);
617 g_return_val_if_fail ((seconds >= 0 && seconds < 60) || seconds == -1, NULL);
618 g_return_val_if_fail (tzoffset >= -12.0 && tzoffset <= 12.0, NULL);
619 g_return_val_if_fail ((hour >= 0 && minute >= 0) ||
620 (hour == -1 && minute == -1 && seconds == -1 && tzoffset == 0.0), NULL);
622 tzhour = (gint) ABS (tzoffset);
623 tzminute = (gint) ((ABS (tzoffset) - tzhour) * 60);
625 g_snprintf (buf, 6, "%c%02d%02d", tzoffset >= 0 ? '+' : '-', tzhour,
628 tz = g_time_zone_new (buf);
630 fields = gst_date_time_check_fields (&year, &month, &day,
631 &hour, &minute, &seconds);
633 dt = g_date_time_new (tz, year, month, day, hour, minute, seconds);
634 g_time_zone_unref (tz);
636 datetime = gst_date_time_new_from_g_date_time (dt);
637 datetime->fields = fields;
643 __gst_date_time_serialize (GstDateTime * datetime, gboolean serialize_usecs)
649 /* we always have at least the year */
650 s = g_string_new (NULL);
651 g_string_append_printf (s, "%04u", gst_date_time_get_year (datetime));
653 if (datetime->fields == GST_DATE_TIME_FIELDS_Y)
657 g_string_append_printf (s, "-%02u", gst_date_time_get_month (datetime));
659 if (datetime->fields == GST_DATE_TIME_FIELDS_YM)
662 /* add day of month */
663 g_string_append_printf (s, "-%02u", gst_date_time_get_day (datetime));
665 if (datetime->fields == GST_DATE_TIME_FIELDS_YMD)
669 g_string_append_printf (s, "T%02u:%02u", gst_date_time_get_hour (datetime),
670 gst_date_time_get_minute (datetime));
672 if (datetime->fields == GST_DATE_TIME_FIELDS_YMD_HM)
676 g_string_append_printf (s, ":%02u", gst_date_time_get_second (datetime));
678 /* add microseconds */
679 if (serialize_usecs) {
680 msecs = gst_date_time_get_microsecond (datetime);
682 g_string_append_printf (s, ".%06u", msecs);
683 /* trim trailing 0s */
684 while (s->str[s->len - 1] == '0')
685 g_string_truncate (s, s->len - 1);
693 gmt_offset = gst_date_time_get_time_zone_offset (datetime);
694 if (gmt_offset == 0) {
695 g_string_append_c (s, 'Z');
697 guint tzhour, tzminute;
699 tzhour = (guint) ABS (gmt_offset);
700 tzminute = (guint) ((ABS (gmt_offset) - tzhour) * 60);
702 g_string_append_c (s, (gmt_offset >= 0) ? '+' : '-');
703 g_string_append_printf (s, "%02u%02u", tzhour, tzminute);
708 return g_string_free (s, FALSE);
712 * gst_date_time_to_iso8601_string:
713 * @datetime: GstDateTime.
715 * Create a minimal string compatible with ISO-8601. Possible output formats
716 * are (for example): 2012, 2012-06, 2012-06-23, 2012-06-23T23:30Z,
717 * 2012-06-23T23:30+0100, 2012-06-23T23:30:59Z, 2012-06-23T23:30:59+0100
719 * Returns: a newly allocated string formatted according to ISO 8601 and
720 * only including the datetime fields that are valid, or NULL in case
721 * there was an error. The string should be freed with g_free().
724 gst_date_time_to_iso8601_string (GstDateTime * datetime)
726 g_return_val_if_fail (datetime != NULL, NULL);
728 if (datetime->fields == GST_DATE_TIME_FIELDS_INVALID)
731 return __gst_date_time_serialize (datetime, FALSE);
735 * gst_date_time_new_from_iso8601_string:
736 * @string: ISO 8601-formatted datetime string.
738 * Tries to parse common variants of ISO-8601 datetime strings into a
741 * Free-function: gst_date_time_unref
743 * Returns: (transfer full): a newly created #GstDateTime, or NULL on error
746 gst_date_time_new_from_iso8601_string (const gchar * string)
748 gint year = -1, month = -1, day = -1, hour = -1, minute = -1;
749 gdouble second = -1.0;
750 gfloat tzoffset = 0.0;
754 len = strlen (string);
756 g_return_val_if_fail (len >= 4, NULL);
757 g_return_val_if_fail (g_ascii_isdigit (*string), NULL);
759 GST_DEBUG ("Parsing %s into a datetime", string);
761 ret = sscanf (string, "%04d-%02d-%02d", &year, &month, &day);
766 if (ret == 3 && day <= 0) {
771 if (ret >= 2 && month <= 0) {
776 if (ret >= 1 && year <= 0)
779 else if (ret >= 1 && len < 16)
780 /* YMD is 10 chars. XMD + HM will be 16 chars. if it is less,
781 * it make no sense to continue. We will stay with YMD. */
785 /* Exit if there is no expeceted value on this stage */
786 if (!(*string == 'T' || *string == '-' || *string == ' '))
789 /* if hour or minute fails, then we will use onlly ymd. */
790 hour = g_ascii_strtoull (string + 1, (gchar **) & string, 10);
791 if (hour > 24 || *string != ':')
795 minute = g_ascii_strtoull (string + 1, (gchar **) & string, 10);
800 if (*string == ':') {
801 second = g_ascii_strtoull (string + 1, (gchar **) & string, 10);
802 /* if we fail here, we still can reuse hour and minute. We
803 * will still attempt to parse any timezone information */
808 if (*string == '.' || *string == ',') {
809 const gchar *usec_start = string + 1;
812 usecs = g_ascii_strtoull (string + 1, (gchar **) & string, 10);
813 if (usecs != G_MAXUINT64 && string > usec_start) {
814 digits = (guint) (string - usec_start);
815 second += (gdouble) usecs / pow (10.0, digits);
824 /* reuse some code from gst-plugins-base/gst-libs/gst/tag/gstxmptag.c */
825 gint gmt_offset_hour = -1, gmt_offset_min = -1, gmt_offset = -1;
826 gchar *plus_pos = NULL;
827 gchar *neg_pos = NULL;
830 GST_LOG ("Checking for timezone information");
832 /* check if there is timezone info */
833 plus_pos = strrchr (string, '+');
834 neg_pos = strrchr (string, '-');
843 ret_tz = sscanf (pos, "%d:%d", &gmt_offset_hour, &gmt_offset_min);
845 ret_tz = sscanf (pos, "%02d%02d", &gmt_offset_hour, &gmt_offset_min);
847 GST_DEBUG ("Parsing timezone: %s", pos);
850 gmt_offset = gmt_offset_hour * 60 + gmt_offset_min;
851 if (neg_pos != NULL && neg_pos + 1 == pos)
854 tzoffset = gmt_offset / 60.0;
856 GST_LOG ("Timezone offset: %f (%d minutes)", tzoffset, gmt_offset);
858 GST_WARNING ("Failed to parse timezone information");
863 return gst_date_time_new (tzoffset, year, month, day, hour, minute, second);
865 return gst_date_time_new_ymd (year, month, day);
870 gst_date_time_free (GstDateTime * datetime)
872 g_date_time_unref (datetime->datetime);
873 g_slice_free (GstDateTime, datetime);
878 * @datetime: a #GstDateTime
880 * Atomically increments the reference count of @datetime by one.
882 * Return value: (transfer full): the reference @datetime
885 gst_date_time_ref (GstDateTime * datetime)
887 g_return_val_if_fail (datetime != NULL, NULL);
888 g_return_val_if_fail (datetime->ref_count > 0, NULL);
889 g_atomic_int_inc (&datetime->ref_count);
894 * gst_date_time_unref:
895 * @datetime: (transfer full): a #GstDateTime
897 * Atomically decrements the reference count of @datetime by one. When the
898 * reference count reaches zero, the structure is freed.
901 gst_date_time_unref (GstDateTime * datetime)
903 g_return_if_fail (datetime != NULL);
904 g_return_if_fail (datetime->ref_count > 0);
906 if (g_atomic_int_dec_and_test (&datetime->ref_count))
907 gst_date_time_free (datetime);