Method

GLibDateTimeto_timezone

Declaration

GDateTime*
g_date_time_to_timezone (
  GDateTime* datetime,
  GTimeZone* tz
)

Description

Create a new GDateTime corresponding to the same instant in time as datetime, 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).

Available since:

2.26

Parameters

`tz`	`GTimeZone`
	The new `GTimeZone`.
	The data is owned by the caller of the function.

Return value

Returns:	`GDateTime`
	The newly created `GDateTime` which should be freed with g_date_time_unref(), or `NULL`.
	The caller of the method takes ownership of the data, and is responsible for freeing it.
	The return value can be `NULL`.