DateTime

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.

[proleptic Gregorian calendar]: https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar

Constructors

this
this(float tzoffset, int year, int month, int day, int hour, int minute, double seconds)

Creates a new #GstDateTime using the date and times in the gregorian calendar in the supplied timezone.

Members

Functions

getDay
int getDay()

Returns the day of the month of this #GstDateTime.

getHour
int getHour()

Retrieves the hour of the day represented by datetime in the gregorian calendar. The return is in the range of 0 to 23.

getMicrosecond
int getMicrosecond()

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

getMinute
int getMinute()

Retrieves the minute of the hour represented by datetime in the gregorian calendar.

getMonth
int getMonth()

Returns the month of this #GstDateTime. January is 1, February is 2, etc..

getSecond
int getSecond()

Retrieves the second of the minute represented by datetime in the gregorian calendar.

getTimeZoneOffset
float getTimeZoneOffset()

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
int getYear()

Returns the year of this #GstDateTime. Call gst.date_time.DateTime.hasYear before, to avoid warnings.

hasDay
bool hasDay()
hasMonth
bool hasMonth()
hasSecond
bool hasSecond()
hasTime
bool hasTime()
hasYear
bool hasYear()
toGDateTime
glib.date_time.DateTime toGDateTime()

Creates a new #GDateTime from a fully defined #GstDateTime object.

toIso8601String
string toIso8601String()

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

Static functions

newFromGDateTime
gst.date_time.DateTime newFromGDateTime(glib.date_time.DateTime dt)

Creates a new #GstDateTime from a #GDateTime object.

newFromIso8601String
gst.date_time.DateTime newFromIso8601String(string string_)

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.

newFromUnixEpochLocalTime
gst.date_time.DateTime newFromUnixEpochLocalTime(long secs)

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

newFromUnixEpochLocalTimeUsecs
gst.date_time.DateTime newFromUnixEpochLocalTimeUsecs(long usecs)

Creates a new #GstDateTime using the time since Jan 1, 1970 specified by usecs. The #GstDateTime is in the local timezone.

newFromUnixEpochUtc
gst.date_time.DateTime newFromUnixEpochUtc(long secs)

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

newFromUnixEpochUtcUsecs
gst.date_time.DateTime newFromUnixEpochUtcUsecs(long usecs)

Creates a new #GstDateTime using the time since Jan 1, 1970 specified by usecs. The #GstDateTime is in UTC.

newLocalTime
gst.date_time.DateTime newLocalTime(int year, int month, int day, int hour, int minute, double seconds)

Creates a new #GstDateTime using the date and times in the gregorian calendar in the local timezone.

newNowLocalTime
gst.date_time.DateTime newNowLocalTime()

Creates a new #GstDateTime representing the current date and time.

newNowUtc
gst.date_time.DateTime newNowUtc()

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

newY
gst.date_time.DateTime newY(int year)

Creates a new #GstDateTime using the date and times in the gregorian calendar in the local timezone.

newYm
gst.date_time.DateTime newYm(int year, int month)

Creates a new #GstDateTime using the date and times in the gregorian calendar in the local timezone.

newYmd
gst.date_time.DateTime newYmd(int year, int month, int day)

Creates a new #GstDateTime using the date and times in the gregorian calendar in the local timezone.

Inherited Members

From Boxed

cInstancePtr
void* cInstancePtr;

Pointer to the C boxed value

getType
GType getType()

Get the GType of this boxed type.

gType
GType gType [@property getter]

Boxed GType property.

self
Boxed self()

Convenience method to return this cast to a type. For use in D with statements.

copy_
void* copy_()

Make a copy of the wrapped C boxed data.

boxedCopy
void* boxedCopy(void* cBoxed)

Copy a C boxed value using g_boxed_copy.

boxedFree
void boxedFree(void* cBoxed)

Free a C boxed value using g_boxed_free.