Represents a precise time, with seconds and microseconds. Similar to the struct timeval returned by the gettimeofday() UNIX system call.
GLib is attempting to unify around the use of 64-bit integers to represent microsecond-precision time. As such, this type will be removed from a future version of GLib. A consequence of using
tv_secis that on 32-bit systems
GTimeValis subject to the year 2038 problem.
Deprecated since version 2.62: Use
GLib.DateTimeor #guint64 instead.
Parameters: iso_date (
str) – an ISO 8601 encoded date string
Trueif the conversion was successful.
Return type: (
Converts a string containing an ISO 8601 encoded date and time to a
GLib.TimeValand puts it into time_.
iso_date must include year, month, day, hours, minutes, and seconds. It can optionally include fractions of a second and a time zone indicator. (In the absence of any time zone indication, the timestamp is assumed to be in local time.)
Any leading or trailing space in iso_date is ignored.
This function was deprecated, along with
GLib.TimeValitself, in GLib 2.62. Equivalent functionality is available using code like:
GDateTime *dt = g_date_time_new_from_iso8601 (iso8601_string, NULL); gint64 time_val = g_date_time_to_unix (dt); g_date_time_unref (dt);
New in version 2.12.
Parameters: microseconds (
int) – number of microseconds to add to time
Adds the given number of microseconds to self. microseconds can also be negative to decrease the value of self.
Returns: a newly allocated string containing an ISO 8601 date, or
Noneif self was too large
Converts self into an RFC 3339 encoded string, relative to the Coordinated Universal Time (UTC). This is one of the many formats allowed by ISO 8601.
ISO 8601 allows a large number of date/time formats, with or without punctuation and optional elements. The format returned by this function is a complete date and time, with optional punctuation included, the UTC time zone represented as “Z”, and the tv_usec part included if and only if it is nonzero, i.e. either “YYYY-MM-DDTHH:MM:py:data::SSZ<GLib.TimeVal.props.SSZ>” or “YYYY-MM-DDTHH:MM:SS.fffffZ”.
This corresponds to the Internet date/time format defined by RFC 3339, and to either of the two most-precise formats defined by the W3C Note Date and Time Formats. Both of these documents are profiles of ISO 8601.
GLib.DateTime.format() or g_strdup_printf() if a different variation of ISO 8601 format is required.
If self represents a date which is too large to fit into a
Nonewill be returned. This is platform dependent. Note also that since
GTimeValstores the number of seconds as a
glong, on 32-bit systems it is subject to the year 2038 problem. Accordingly, since GLib 2.62, this function has been deprecated. Equivalent functionality is available using:
GDateTime *dt = g_date_time_new_from_unix_utc (time_val); iso8601_string = g_date_time_format_iso8601 (dt); g_date_time_unref (dt);
The return value of
GLib.TimeVal.to_iso8601() has been nullable since GLib 2.54; before then, GLib would crash under the same conditions.
New in version 2.12.