Function

GLibDateTimenew_from_timeval_utc

Declaration

GDateTime*
g_date_time_new_from_timeval_utc (
  const GTimeVal* tv
)

Description

Creates a GDateTime corresponding to the given GTimeVal tv in UTC.

The time contained in a GTimeVal is always stored in the form of seconds elapsed since 1970-01-01 00:00:00 UTC.

This call can fail (returning NULL) if tv represents a time outside of the supported range of GDateTime.

You should release the return value by calling g_date_time_unref() when you are done with it.

Available since:2.26
Deprecated since:2.62

GTimeVal is not year-2038-safe. Use g_date_time_new_from_unix_utc() instead.

Parameters

tv GTimeVal
 

A GTimeVal.

 The data is owned by the caller of the function.

Return value

Returns: GDateTime
 

A new GDateTime, or NULL.

 The caller of the function takes ownership of the data, and is responsible for freeing it.
 The return value can be NULL.