Method

GLibTimeZoneadjust_time

Declaration

gint
g_time_zone_adjust_time (
  GTimeZone* tz,
  GTimeType type,
  gint64* time_
)

Description

Finds an interval within tz that corresponds to the given time_, possibly adjusting time_ if required to fit into an interval. The meaning of time_ depends on type.

This function is similar to g_time_zone_find_interval(), with the difference that it always succeeds (by making the adjustments described below).

In any of the cases where g_time_zone_find_interval() succeeds then this function returns the same value, without modifying time_.

This function may, however, modify time_ in order to deal with non-existent times. If the non-existent local time_ of 02:30 were requested on March 14th 2010 in Toronto then this function would adjust time_ to be 03:00 and return the interval containing the adjusted time.

Available since:2.26

Parameters

type GTimeType
 

The GTimeType of time_

time_ gint64*
 

A pointer to a number of seconds since January 1, 1970

 The data is owned by the caller of the function.

Return value

Returns: gint
 

The interval containing time_, never -1