GI.Gst.Structs.DateTime

Struct to store date, time and timezone information altogether. DateTime is refcounted and immutable.

Date information is handled using the proleptic Gregorian calendar.

Provides basic creation functions and accessor functions to its fields.

Exported types

newtype DateTime

Constructors

DateTime (ManagedPtr DateTime)

Instances

BoxedObject DateTime

Methods

boxedType :: DateTime -> IO GType

((~) * info (ResolveDateTimeMethod t DateTime), MethodInfo * info DateTime p) => IsLabel t (DateTime -> p)

Methods

fromLabel :: Proxy# Symbol t -> DateTime -> p

((~) * info (ResolveDateTimeMethod t DateTime), MethodInfo * info DateTime p) => IsLabelProxy t (DateTime -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> DateTime -> p

HasAttributeList * DateTime

((~) * signature (m ()), MonadIO m) => MethodInfo * DateTimeUnrefMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeUnrefMethodInfo DateTime -> signature -> s

((~) * signature (m (Maybe Text)), MonadIO m) => MethodInfo * DateTimeToIso8601StringMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeToIso8601StringMethodInfo DateTime -> signature -> s

((~) * signature (m (Maybe DateTime)), MonadIO m) => MethodInfo * DateTimeToGDateTimeMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeToGDateTimeMethodInfo DateTime -> signature -> s

((~) * signature (m DateTime), MonadIO m) => MethodInfo * DateTimeRefMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeRefMethodInfo DateTime -> signature -> s

((~) * signature (m Bool), MonadIO m) => MethodInfo * DateTimeHasYearMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeHasYearMethodInfo DateTime -> signature -> s

((~) * signature (m Bool), MonadIO m) => MethodInfo * DateTimeHasTimeMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeHasTimeMethodInfo DateTime -> signature -> s

((~) * signature (m Bool), MonadIO m) => MethodInfo * DateTimeHasSecondMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeHasSecondMethodInfo DateTime -> signature -> s

((~) * signature (m Bool), MonadIO m) => MethodInfo * DateTimeHasMonthMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeHasMonthMethodInfo DateTime -> signature -> s

((~) * signature (m Bool), MonadIO m) => MethodInfo * DateTimeHasDayMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeHasDayMethodInfo DateTime -> signature -> s

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetYearMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetYearMethodInfo DateTime -> signature -> s

((~) * signature (m Float), MonadIO m) => MethodInfo * DateTimeGetTimeZoneOffsetMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetTimeZoneOffsetMethodInfo DateTime -> signature -> s

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetSecondMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetSecondMethodInfo DateTime -> signature -> s

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetMonthMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetMonthMethodInfo DateTime -> signature -> s

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetMinuteMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetMinuteMethodInfo DateTime -> signature -> s

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetMicrosecondMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetMicrosecondMethodInfo DateTime -> signature -> s

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetHourMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetHourMethodInfo DateTime -> signature -> s

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetDayMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetDayMethodInfo DateTime -> signature -> s

type AttributeList DateTime

type AttributeList DateTime

noDateTime :: Maybe DateTime

Methods

getDay

data DateTimeGetDayMethodInfo

Instances

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetDayMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetDayMethodInfo DateTime -> signature -> s

dateTimeGetDay

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Int32

Returns: The day of this DateTime

Returns the day of the month of this DateTime. Call gst_date_time_has_day before, to avoid warnings.

getHour

data DateTimeGetHourMethodInfo

Instances

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetHourMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetHourMethodInfo DateTime -> signature -> s

dateTimeGetHour

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Int32

Returns: the hour of the day

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.

getMicrosecond

data DateTimeGetMicrosecondMethodInfo

Instances

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetMicrosecondMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetMicrosecondMethodInfo DateTime -> signature -> s

dateTimeGetMicrosecond

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Int32

Returns: the microsecond of the second

Retrieves the fractional part of the seconds in microseconds represented by datetime in the gregorian calendar.

getMinute

data DateTimeGetMinuteMethodInfo

Instances

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetMinuteMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetMinuteMethodInfo DateTime -> signature -> s

dateTimeGetMinute

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Int32

Returns: the minute of the hour

Retrieves the minute of the hour represented by datetime in the gregorian calendar. Call gst_date_time_has_minute before, to avoid warnings.

getMonth

data DateTimeGetMonthMethodInfo

Instances

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetMonthMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetMonthMethodInfo DateTime -> signature -> s

dateTimeGetMonth

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Int32

Returns: The month of this DateTime

Returns the month of this DateTime. January is 1, February is 2, etc.. Call gst_date_time_has_month before, to avoid warnings.

getSecond

data DateTimeGetSecondMethodInfo

Instances

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetSecondMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetSecondMethodInfo DateTime -> signature -> s

dateTimeGetSecond

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Int32

Returns: the second represented by datetime

Retrieves the second of the minute represented by datetime in the gregorian calendar. Call gst_date_time_has_second before, to avoid warnings.

getTimeZoneOffset

data DateTimeGetTimeZoneOffsetMethodInfo

Instances

((~) * signature (m Float), MonadIO m) => MethodInfo * DateTimeGetTimeZoneOffsetMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetTimeZoneOffsetMethodInfo DateTime -> signature -> s

dateTimeGetTimeZoneOffset

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Float

Returns: the offset from UTC in hours

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.

getYear

data DateTimeGetYearMethodInfo

Instances

((~) * signature (m Int32), MonadIO m) => MethodInfo * DateTimeGetYearMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeGetYearMethodInfo DateTime -> signature -> s

dateTimeGetYear

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Int32

Returns: The year of this DateTime

Returns the year of this DateTime Call gst_date_time_has_year before, to avoid warnings.

hasDay

data DateTimeHasDayMethodInfo

Instances

((~) * signature (m Bool), MonadIO m) => MethodInfo * DateTimeHasDayMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeHasDayMethodInfo DateTime -> signature -> s

dateTimeHasDay

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Bool

Returns: True if datetime<!-- -->'s day field is set, otherwise False

No description available in the introspection data.

hasMonth

data DateTimeHasMonthMethodInfo

Instances

((~) * signature (m Bool), MonadIO m) => MethodInfo * DateTimeHasMonthMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeHasMonthMethodInfo DateTime -> signature -> s

dateTimeHasMonth

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Bool

Returns: True if datetime<!-- -->'s month field is set, otherwise False

No description available in the introspection data.

hasSecond

data DateTimeHasSecondMethodInfo

Instances

((~) * signature (m Bool), MonadIO m) => MethodInfo * DateTimeHasSecondMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeHasSecondMethodInfo DateTime -> signature -> s

dateTimeHasSecond

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Bool

Returns: True if datetime<!-- -->'s second field is set, otherwise False

No description available in the introspection data.

hasTime

data DateTimeHasTimeMethodInfo

Instances

((~) * signature (m Bool), MonadIO m) => MethodInfo * DateTimeHasTimeMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeHasTimeMethodInfo DateTime -> signature -> s

dateTimeHasTime

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Bool

Returns: True if datetime<!-- -->'s hour and minute fields are set, otherwise False

No description available in the introspection data.

hasYear

data DateTimeHasYearMethodInfo

Instances

((~) * signature (m Bool), MonadIO m) => MethodInfo * DateTimeHasYearMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeHasYearMethodInfo DateTime -> signature -> s

dateTimeHasYear

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m Bool

Returns: True if datetime<!-- -->'s year field is set (which should always be the case), otherwise False

No description available in the introspection data.

new

dateTimeNew

Arguments

:: (HasCallStack, MonadIO m)

=> Float

tzoffset: Offset from UTC in hours.

-> Int32

year: the gregorian year

-> Int32

month: the gregorian month

-> Int32

day: the day of the gregorian month

-> Int32

hour: the hour of the day

-> Int32

minute: the minute of the hour

-> Double

seconds: the second of the minute

-> m DateTime

Returns: the newly created DateTime

Creates a new DateTime 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 DateTime will created only for year. If day == -1, then DateTime will created for year and month and so on.

Free-function: gst_date_time_unref

newFromGDateTime

dateTimeNewFromGDateTime

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

dt: the DateTime. The new DateTime takes ownership.

-> m (Maybe DateTime)

Returns: a newly created DateTime, or Nothing on error

Creates a new DateTime from a DateTime object.

Free-function: gst_date_time_unref

newFromIso8601String

dateTimeNewFromIso8601String

Arguments

:: (HasCallStack, MonadIO m)

=> Text

string: ISO 8601-formatted datetime string.

-> m (Maybe DateTime)

Returns: a newly created DateTime, or Nothing on error

Tries to parse common variants of ISO-8601 datetime strings into a DateTime. 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.

Free-function: gst_date_time_unref

newFromUnixEpochLocalTime

dateTimeNewFromUnixEpochLocalTime

Arguments

:: (HasCallStack, MonadIO m)

=> Int64

secs: seconds from the Unix epoch

-> m DateTime

Returns: the newly created DateTime

Creates a new DateTime using the time since Jan 1, 1970 specified by secs. The DateTime is in the local timezone.

Free-function: gst_date_time_unref

newFromUnixEpochUtc

dateTimeNewFromUnixEpochUtc

Arguments

:: (HasCallStack, MonadIO m)

=> Int64

secs: seconds from the Unix epoch

-> m DateTime

Returns: the newly created DateTime

Creates a new DateTime using the time since Jan 1, 1970 specified by secs. The DateTime is in the UTC timezone.

Free-function: gst_date_time_unref

newLocalTime

dateTimeNewLocalTime

Arguments

:: (HasCallStack, MonadIO m)

=> Int32

year: the gregorian year

-> Int32

month: the gregorian month, or -1

-> Int32

day: the day of the gregorian month, or -1

-> Int32

hour: the hour of the day, or -1

-> Int32

minute: the minute of the hour, or -1

-> Double

seconds: the second of the minute, or -1

-> m DateTime

Returns: the newly created DateTime

Creates a new DateTime 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 DateTime created will only contain year, and all other fields will be considered not set.

If day is -1, then the DateTime created will only contain year and month and all other fields will be considered not set.

If hour is -1, then the DateTime 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

newNowLocalTime

dateTimeNewNowLocalTime

Arguments

:: (HasCallStack, MonadIO m)

=> m DateTime

Returns: the newly created DateTime which should be freed with dateTimeUnref.

Creates a new DateTime representing the current date and time.

Free-function: gst_date_time_unref

newNowUtc

dateTimeNewNowUtc

Arguments

:: (HasCallStack, MonadIO m)

=> m DateTime

Returns: the newly created DateTime which should be freed with dateTimeUnref.

Creates a new DateTime that represents the current instant at Universal coordinated time.

Free-function: gst_date_time_unref

newY

dateTimeNewY

Arguments

:: (HasCallStack, MonadIO m)

=> Int32

year: the gregorian year

-> m DateTime

Returns: the newly created DateTime

Creates a new DateTime 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

newYm

dateTimeNewYm

Arguments

:: (HasCallStack, MonadIO m)

=> Int32

year: the gregorian year

-> Int32

month: the gregorian month

-> m DateTime

Returns: the newly created DateTime

Creates a new DateTime 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 DateTime will created only for year.

Free-function: gst_date_time_unref

newYmd

dateTimeNewYmd

Arguments

:: (HasCallStack, MonadIO m)

=> Int32

year: the gregorian year

-> Int32

month: the gregorian month

-> Int32

day: the day of the gregorian month

-> m DateTime

Returns: the newly created DateTime

Creates a new DateTime 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 DateTime will created only for year. If day == -1, then DateTime will created for year and month and so on.

Free-function: gst_date_time_unref

ref

data DateTimeRefMethodInfo

Instances

((~) * signature (m DateTime), MonadIO m) => MethodInfo * DateTimeRefMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeRefMethodInfo DateTime -> signature -> s

dateTimeRef

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m DateTime

Returns: the reference datetime

Atomically increments the reference count of datetime by one.

toGDateTime

data DateTimeToGDateTimeMethodInfo

Instances

((~) * signature (m (Maybe DateTime)), MonadIO m) => MethodInfo * DateTimeToGDateTimeMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeToGDateTimeMethodInfo DateTime -> signature -> s

dateTimeToGDateTime

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: GstDateTime.

-> m (Maybe DateTime)

Returns: a newly created DateTime, or Nothing on error

Creates a new DateTime from a fully defined DateTime object.

Free-function: g_date_time_unref

toIso8601String

data DateTimeToIso8601StringMethodInfo

Instances

((~) * signature (m (Maybe Text)), MonadIO m) => MethodInfo * DateTimeToIso8601StringMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeToIso8601StringMethodInfo DateTime -> signature -> s

dateTimeToIso8601String

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: GstDateTime.

-> m (Maybe Text)

Returns: a newly allocated string formatted according to ISO 8601 and only including the datetime fields that are valid, or Nothing in case there was an error. The string should be freed with free.

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

unref

data DateTimeUnrefMethodInfo

Instances

((~) * signature (m ()), MonadIO m) => MethodInfo * DateTimeUnrefMethodInfo DateTime signature

Methods

overloadedMethod :: MethodProxy DateTimeUnrefMethodInfo DateTime -> signature -> s

dateTimeUnref

Arguments

:: (HasCallStack, MonadIO m)

=> DateTime

datetime: a DateTime

-> m ()

Atomically decrements the reference count of datetime by one. When the reference count reaches zero, the structure is freed.