-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);
-GstDateTime * gst_date_time_new_from_unix_epoch_utc (gint64 secs);
-GstDateTime * gst_date_time_new_local_time (gint year, gint month,
- gint day, gint hour,
+GST_API GType _gst_date_time_type;
+
+/**
+ * GST_TYPE_DATE_TIME:
+ *
+ * a boxed #GValue type for #GstDateTime that represents a date and time.
+ *
+ * Returns: the #GType of GstDateTime
+ */
+
+#define GST_TYPE_DATE_TIME (_gst_date_time_type)
+
+GST_API
+GType gst_date_time_get_type (void);
+
+/* query which fields are set */
+
+GST_API
+gboolean gst_date_time_has_year (const GstDateTime * datetime);
+
+GST_API
+gboolean gst_date_time_has_month (const GstDateTime * datetime);
+
+GST_API
+gboolean gst_date_time_has_day (const GstDateTime * datetime);
+
+GST_API
+gboolean gst_date_time_has_time (const GstDateTime * datetime);
+
+GST_API
+gboolean gst_date_time_has_second (const GstDateTime * datetime);
+
+/* field getters */
+
+GST_API
+gint gst_date_time_get_year (const GstDateTime * datetime);
+
+GST_API
+gint gst_date_time_get_month (const GstDateTime * datetime);
+
+GST_API
+gint gst_date_time_get_day (const GstDateTime * datetime);
+
+GST_API
+gint gst_date_time_get_hour (const GstDateTime * datetime);
+
+GST_API
+gint gst_date_time_get_minute (const GstDateTime * datetime);
+
+GST_API
+gint gst_date_time_get_second (const GstDateTime * datetime);
+
+GST_API
+gint gst_date_time_get_microsecond (const GstDateTime * datetime);
+
+GST_API
+gfloat gst_date_time_get_time_zone_offset (const GstDateTime * datetime);
+
+/* constructors */
+
+GST_API
+GstDateTime * gst_date_time_new_from_unix_epoch_local_time (gint64 secs) G_GNUC_MALLOC;
+
+GST_API
+GstDateTime * gst_date_time_new_from_unix_epoch_utc (gint64 secs) G_GNUC_MALLOC;
+
+GST_API
+GstDateTime * gst_date_time_new_local_time (gint year,
+ gint month,
+ gint day,
+ gint hour,