### Struct

# ECal ComponentDateTime

#### Description [src]

    struct ECalComponentDateTime {
      /* No available fields */
    }

An opaque structure containing an `ICalTime` describing the date/time value and also its TZID parameter. Use the functions below to work with it.

#### Constructors

###### e_cal_component_datetime_new

Creates a new `ECalComponentDateTime` instance, which holds the `value` and `tzid`. The returned structure should be freed with e_cal_component_datetime_free(), when no longer needed.

since: 3.34

###### e_cal_component_datetime_new_take

Creates a new `ECalComponentDateTime` instance, which holds the `value` and `tzid`. It is similar to e_cal_component_datetime_new(), except this function assumes ownership of the `value` and `tzid`. The returned structure should be freed with e_cal_component_datetime_free(), when no longer needed.

since: 3.34

#### Instance methods

###### e_cal_component_datetime_copy

Creates a new copy of `dt`. The returned structure should be freed with `e_cal_component_datetime_free()` when no longer needed.

since: 3.34

###### e_cal_component_datetime_free

Free `dt`, previously created by e_cal_component_datetime_new(), `e_cal_component_datetime_new_take()` or e_cal_component_datetime_copy(). The function does nothing, if `dt` is `NULL`.

since: 3.34

###### e_cal_component_datetime_get_tzid

Returns the TZID stored with the `dt`. The string is owned by `dt` and it’s valid until the `dt` is freed or its TZID overwritten. It never returns an empty string, it returns either set TZID parameter value or `NULL`, when none is set.

since: 3.34

###### e_cal_component_datetime_get_value

Returns the value stored with the `dt`. The object is owned by `dt` and it’s valid until the `dt` is freed or its value overwritten.

since: 3.34

###### e_cal_component_datetime_set

Sets both `value` and `tzid` in one call. Use `e_cal_component_datetime_set_value()` and `e_cal_component_datetime_set_tzid()` to set them separately.

since: 3.34

###### e_cal_component_datetime_set_tzid

Sets the `tzid` of the `dt`. Any previously set TZID is freed. An empty string or a `NULL` as `tzid` is treated as none TZID.

since: 3.34

###### e_cal_component_datetime_set_value

Sets the `value` of the `dt`. Any previously set value is freed.

since: 3.34

###### e_cal_component_datetime_take_tzid

Sets the `tzid` of the `dt` and assumes ownership of `tzid`. Any previously set TZID is freed. An empty string or a `NULL` as `tzid` is treated as none TZID.

since: 3.34

###### e_cal_component_datetime_take_value

Sets the `value` of the `dt` and assumes ownership of the `value`. Any previously set value is freed.

since: 3.34