HP C/iX Library Reference Manual (30026-90004)

206 Chapter5

HP C/iX Library Function Descriptions

gmtime

Converts time to Coordinated Universal Time (UTC) in the structured tm type format.

Syntax

#include <time.h>

struct tm *gmtime (const time_t *

timer

);

Parameters

timer

A pointer to a variable of type time_t.

Return Values

x A pointer to a variable of type tm.

NULL The Coordinated Universal Time (UTC) is not available.

Description

The gmtime function converts a time_t variable, such as that returned by the time

function, into a structured tm format. The converted value is expressed in Coordinated

Universal Time (UTC).