tibasTuple_GetDateTime()

Returns the datetime value stored in the field with the specified name.

Declaration

tibas_status tibasTuple_GetDateTime
(tibasTuple      tuple,
tibas_DateTime*  dateTime,
const char*      fieldname)

Parameters

Parameter Description
tuple Specify the tuple for which you want to return a date and time value.
dateTime Returns a pointer to a _tibas_DateTime struct that holds the datetime information returned by the function.
fieldname The fieldname.

Remarks

Use the tibasTuple_GetDateTime() function to return the datetime value stored in a specified field in a specified tuple.

The function returns a pointer to a _tibas_dateTime structure, The _tibasDateTime struct is defined as follows: 

struct _tibasDateTime {
    tibas_long sec;
    tibas_int nsec;
};

The members in the _tibas_dateTime struct are defined as follows:

sec
 Indicates the time, in seconds, since the UNIX EPOCH time (1970-01-01 00:00:00 +0000).
nsec
 Indicates the time, in nanoseconds, since the UNIX EPOCH time (1970-01-01 00:00:00 +0000). This field provides is extra timing information in addition to the number of seconds since the EPOCH time; usually this is set to 0.
Attention: Internally ActiveSpaces stores seconds and milliseconds. When storing time, any nanoseconds beyond milliseconds will be lost. For example, when storing 38,069,999 nanoseconds internally ActiveSpaces only stores the 38 milliseconds. The other 69,999 nanoseconds are dropped.

See Also

tibasTuple_GetChar(), tibasTuple_GetShort(), tibasTuple_GetInt(), tibasTuple_GetLong(), tibasTuple_GetLong(), tibasTuple_GetFloat(), tibasTuple_GetFloat(), tibasTuple_GetDouble(), tibasTuple_GetString(), tibasTuple_GetBoolean(), tibasTuple_GetBlob(), tibasTuple_PutDateTime()