to_timezone


Description:

public DateTime to_timezone (TimeZone tz)

Create a new DateTime corresponding to the same instant in time as this, but in the time zone tz.

This call can fail in the case that the time goes out of bounds. For example, converting 0001-01-01 00:00:00 UTC to a time zone west of Greenwich will fail (due to the year 0 being out of range).

Parameters:

this

a DateTime

tz

the new TimeZone

Returns:

the newly created DateTime which should be freed with g_date_time_unref , or null