OCIDateTimeGetTimeZoneName()

Purpose

Gets the time zone name portion of a datetime value.

Syntax

void OCIDateTimeGetTimeZoneName ( dvoid              *hndl, 
                                  OCIError           *err, 
                                  CONST OCIDateTime  *datetime, 
                                  ub1                *buf,
                                  ub4                *buflen, );

Parameters

hndl (IN)

The OCI user session handle or environment handle.

err (IN/OUT)

The OCI error handle. If there is an error, it is recorded in err and this function returns OCI_ERROR. Obtain diagnostic information by calling OCIErrorGet().

datetime (IN)

Pointer to an OCIDateTime descriptor.

buf (OUT)

Buffer to store the retrieved time zone name.

buflen (IN/OUT)

The size of the buffer (IN). The size of the name field (OUT)

Comments

This function gets the time portion (hour, min, second, fractional second) out of a given datetime value.

This function returns an error if the given datetime does not contain time information.

Returns

OCI_SUCCESS,

OCI_ERROR if datetime does not contain time zone (SQLT_DATE, SQLT_TIMESTAMP).

Related Functions

OCIDateTimeGetDate(), OCIDateTimeGetTimeZoneOffset().