Collaboration diagram for Time API:

Functions
uint64_t	rdm_timeMeasureMilliSecs (void)
	Time in milli seconds suitable for measuring elapsed time. More...

RDM_RETCODE	rdm_timeFromString (const char str, RDM_PACKED_TIME_T ptm)
	Convert a string to local time. More...

uint16_t	rdm_timeHour (RDM_PACKED_TIME_T tm)
	Get the hour of the day. More...

uint16_t	rdm_timeMinute (RDM_PACKED_TIME_T tm)
	Get the minute of the hour. More...

uint16_t	rdm_timeSecond (RDM_PACKED_TIME_T tm)
	Get the second of the minute. More...

uint16_t	rdm_timeFraction (RDM_PACKED_TIME_T tm)
	Get the fractions of the second. More...

RDM_RETCODE	rdm_timeToString (RDM_PACKED_TIME_T timeVal, RDM_TIME_FORMAT time_fmt, char buf, size_t bufSize, size_t puSize)
	Convert a time to a string. More...

RDM_PACKED_TIME_T	rdm_timeZero (void)
	Get the local time at the start of a day. More...

RDM_RETCODE	rdm_timeNow (int16_t time_zone, RDM_PACKED_TIME_T *ptm)
	Get the current local time. More...

RDM_RETCODE	rdm_timeNowAsString (int16_t time_zone, char *timebuf, size_t buflen)
	Get current local time as a string. More...

RDM_RETCODE	rdm_timetzNowAsString (int16_t time_zone, char *timebuf, size_t buflen)
	Get current time with timezone as a string. More...

RDM_RETCODE	rdm_timetzFromString (const char str, RDM_PACKED_TIMETZ_T ptz)
	Convert a string to a time. More...

RDM_RETCODE	rdm_timetzNow (int16_t time_zone, RDM_PACKED_TIMETZ_T *ptz)
	Get the current time with timezone. More...

RDM_RETCODE	rdm_timetzToTime (RDM_PACKED_TIMETZ_T timetzVal, int16_t tz_disp, RDM_PACKED_TIME_T *pTimeVal)
	Convert a time with timezone to local time. More...

RDM_RETCODE	rdm_timetzToString (RDM_PACKED_TIMETZ_T timetzVal, RDM_TIME_FORMAT time_fmt, char buf, size_t bufSize, size_t puSize)
	Convert a time with timezone to a string. More...

RDM_PACKED_TIMETZ_T	rdm_timetzZero (void)
	Get the time at the start of a day. More...

Detailed Description

The RaimaDB time datatype API. The functions here are located in RaimaDB Base Functionality. Linker option:

    -lrdmbase

Function Documentation

rdm_timeFraction()

uint16_t rdm_timeFraction ( RDM_PACKED_TIME_T tm )

#include <rdmtimeapi.h>

Get the fractions of the second.

Get the fractions of the second in 1/10,000th of a second from a packed local time

The fractions of the second (0 - 9999)

Parameters

[in] tm RaimaDB packed local time value

rdm_timeFromString()

RDM_RETCODE rdm_timeFromString	(	const char *	str,
		RDM_PACKED_TIME_T *	ptm
	)

#include <rdmtimeapi.h>

Convert a string to local time.

Convert a string to a packed local time.

Return values

sOKAY	Normal, successful return.
eINVLITERAL	Invalid literal constant specification.
eRANGE	Numeric value out of range.

Parameters

[in]	str	The string to be converted
[out]	ptm	The packed local time value. The buffer need to be allocated by the caller.

rdm_timeHour()

uint16_t rdm_timeHour ( RDM_PACKED_TIME_T tm )

#include <rdmtimeapi.h>

Get the hour of the day.

Get the hour from a packed local time.

Returns: The hour of the day

Parameters

[in] tm RaimaDB packed local time value

rdm_timeMeasureMilliSecs()

uint64_t rdm_timeMeasureMilliSecs ( void )

#include <rdmtimeapi.h>

Time in milli seconds suitable for measuring elapsed time.

This function is returning elapsed time with some unspecified base suitable for measuring elapsed time. It is not suitable for generating timestamps or retrieving the actual clock time.

rdm_timeMinute()

uint16_t rdm_timeMinute ( RDM_PACKED_TIME_T tm )

#include <rdmtimeapi.h>

Get the minute of the hour.

Get the minute of the hour from a packed local time.

Returns: The minute of the hour

Parameters

[in] tm RaimaDB packed local time value

rdm_timeNow()

RDM_RETCODE rdm_timeNow	(	int16_t	time_zone,
		RDM_PACKED_TIME_T *	ptm
	)

#include <rdmtimeapi.h>

Get the current local time.

Get the current local time for the timezone passed in.

Return values

sOKAY	Normal, successful return.
eBASE_INVTIMEZONE	Invalid time zone value.

Parameters

[in]	time_zone	timezone value (in min)
[out]	ptm	current time adjusted with time_zone. The buffer need to be allocated by the caller.

rdm_timeNowAsString()

RDM_RETCODE rdm_timeNowAsString	(	int16_t	time_zone,
		char *	timebuf,
		size_t	buflen
	)

#include <rdmtimeapi.h>

Get current local time as a string.

Get the current local time in string format.

Return values

sOKAY	Normal, successful return.
eBASE_INVTIMEZONE	Invalid time zone value.
sTRUNCATE	Result is truncated.

Parameters

[in]	time_zone	timezone value (in min)
[out]	timebuf	NOW value as string
[in]	buflen	Size of timebuf in number of ASCII characters it can hold

rdm_timeSecond()

uint16_t rdm_timeSecond ( RDM_PACKED_TIME_T tm )

#include <rdmtimeapi.h>

Get the second of the minute.

Get the second of the minute from a packed local time.

Returns: The second of the minute

Parameters

[in] tm RaimaDB packed local time value

rdm_timeToString()

RDM_RETCODE rdm_timeToString	(	RDM_PACKED_TIME_T	timeVal,
		RDM_TIME_FORMAT	time_fmt,
		char *	buf,
		size_t	bufSize,
		size_t *	puSize
	)

#include <rdmtimeapi.h>

Convert a time to a string.

Convert a packed local time to a string.

Return values

sOKAY	Normal, successful return.
eINVLITERAL	Invalid literal constant specification.
sTRUNCATE	Result is truncated.

Parameters

[in]	timeVal	RaimaDB time value
[in]	time_fmt	RaimaDB time format
[out]	buf	result time string
[in]	bufSize	buffer size in number of ASCII characters it can hold
[out]	puSize	resulting size in number of characters

rdm_timetzFromString()

RDM_RETCODE rdm_timetzFromString	(	const char *	str,
		RDM_PACKED_TIMETZ_T *	ptz
	)

#include <rdmtimetzapi.h>

Convert a string to a time.

Convert a string to a packed time with timezone.

Return values

sOKAY	Normal, successful return.
eINVLITERAL	Invalid literal constant specification.
eRANGE	Numeric value out of range.

Parameters

[in]	str	The string to be converted
[out]	ptz	The packed time with timezone. The buffer need to be allocated by the caller.

rdm_timetzNow()

RDM_RETCODE rdm_timetzNow	(	int16_t	time_zone,
		RDM_PACKED_TIMETZ_T *	ptz
	)

#include <rdmtimetzapi.h>

Get the current time with timezone.

Return values

sOKAY	Normal, successful return.
eBASE_INVTIMEZONE	Invalid time zone value.

Parameters

[in]	time_zone	Timezone value
[out]	ptz	The current time with timezone

rdm_timetzNowAsString()

RDM_RETCODE rdm_timetzNowAsString	(	int16_t	time_zone,
		char *	timebuf,
		size_t	buflen
	)

#include <rdmtimetzapi.h>

Get current time with timezone as a string.

Get the current time with timezone as a string.

Return values

sOKAY	Normal, successful return.
eBASE_INVTIMEZONE	Invalid time zone value.
sTRUNCATE	Result is truncated.

See also: rdm_timetzNow

Parameters

[in]	time_zone	Timezone value (in min)
[out]	timebuf	The current time with timezone
[in]	buflen	Size of timebuf in number of ASCII characters it can hold

rdm_timetzToString()

RDM_RETCODE rdm_timetzToString	(	RDM_PACKED_TIMETZ_T	timetzVal,
		RDM_TIME_FORMAT	time_fmt,
		char *	buf,
		size_t	bufSize,
		size_t *	puSize
	)

#include <rdmtimetzapi.h>

Convert a time with timezone to a string.

Convert a packed time with timezone to a string.

Return values

sOKAY	Normal, successful return.
eINVLITERAL	Invalid literal constant specification.
sTRUNCATE	Result is truncated.

Parameters

[in]	timetzVal	time with timezone value
[in]	time_fmt	RaimaDB time format
[out]	buf	result time string
[in]	bufSize	buffer size in number of ASCII characters it can hold
[out]	puSize	resulting size in number of characters

rdm_timetzToTime()

RDM_RETCODE rdm_timetzToTime	(	RDM_PACKED_TIMETZ_T	timetzVal,
		int16_t	tz_disp,
		RDM_PACKED_TIME_T *	pTimeVal
	)

#include <rdmtimetzapi.h>

Convert a time with timezone to local time.

Convert a packed time with timezone to packed local time.

Return values

sOKAY Normal, successful return.

Parameters

[in]	timetzVal	time with timezone value
[in]	tz_disp	The local timezone
[out]	pTimeVal	resulting local time value

rdm_timetzZero()

RDM_PACKED_TIMETZ_T rdm_timetzZero ( void )

#include <rdmtimetzapi.h>

Get the time at the start of a day.

Get the packed time at the start of the day (midnight).

Returns: The time at the start of the day

rdm_timeZero()

RDM_PACKED_TIME_T rdm_timeZero ( void )

#include <rdmtimeapi.h>

Get the local time at the start of a day.

Get the packed local time at the start of the day (midnight).

Returns: The local time at the start of the day

Functions

Detailed Description

Function Documentation

rdm_timeFraction()

rdm_timeFromString()

rdm_timeHour()

rdm_timeMeasureMilliSecs()

rdm_timeMinute()

rdm_timeNow()

rdm_timeNowAsString()

rdm_timeSecond()

rdm_timeToString()

rdm_timetzFromString()

rdm_timetzNow()

rdm_timetzNowAsString()

rdm_timetzToString()

rdm_timetzToTime()

rdm_timetzZero()

rdm_timeZero()