Systime API

The Systime API provides the means of getting the system time, instead of the scheduler time as you would with functions like gettime(). More...

Collaboration diagram for Systime API:

Data Structures
struct	t_datetime
	The Systime data structure. More...

Enumerations
enum	e_max_dateflags { SYSDATEFORMAT_FLAGS_SHORT, SYSDATEFORMAT_FLAGS_MEDIUM, SYSDATEFORMAT_FLAGS_LONG }
	Flags for the sysdateformat_formatdatetime() function. More...

Functions
t_uint32	systime_ticks (void)
	Find out the operating system’s time in ticks. More...
t_uint32	systime_ms (void)
	Find out the operating system’s time in milliseconds. More...
t_int64	systime_datetime_milliseconds (void)
	Find out the current date/time as number of ms since 1/1/1970. More...
void	systime_datetime (t_datetime *d)
	Find out the operating system’s date and time. More...
t_ptr_uint	systime_seconds (void)
	Find out the operating system’s time in seconds. More...
void	systime_secondstodate (t_ptr_uint secs, t_datetime *d)
	Convert a time in seconds into a t_datetime representation. More...
t_ptr_uint	systime_datetoseconds (t_datetime *d)
	Convert a t_datetime representation of time into seconds. More...
void	sysdateformat_strftimetodatetime (char *strf, t_datetime *d)
	Fill a t_datetime struct with a datetime formatted string. More...
void	sysdateformat_formatdatetime (t_datetime *d, long dateflags, long timeflags, char *s, long buflen)
	Get a human friendly string representation of a t_datetime. More...

Detailed Description

The Systime API provides the means of getting the system time, instead of the scheduler time as you would with functions like gettime().

Enumeration Type Documentation

enum e_max_dateflags

Flags for the sysdateformat_formatdatetime() function.

Enumerator
SYSDATEFORMAT_FLAGS_SHORT	short
SYSDATEFORMAT_FLAGS_MEDIUM	medium
SYSDATEFORMAT_FLAGS_LONG	long

Function Documentation

void sysdateformat_formatdatetime	(	t_datetime *	d,
		long	dateflags,
		long	timeflags,
		char *	s,
		long	buflen
	)

Get a human friendly string representation of a t_datetime.

For example: "Today", "Yesterday", etc.

Parameters

d	The address of a t_datetime to fill.
dateflags	One of the values defined in e_max_dateflags.
timeflags	Currently unused. Pass 0.
s	An already allocated string to hold the human friendly result.
buflen	The number of characters allocated to the string s.

void sysdateformat_strftimetodatetime	(	char *	strf,
		t_datetime *	d
	)

Fill a t_datetime struct with a datetime formatted string.

For example, the string "2007-12-24 12:21:00".

Parameters

strf	A string containing the datetime.
d	The address of a t_datetime to fill.

void systime_datetime

(

t_datetime *

d

)

Find out the operating system’s date and time.

Parameters

d	Returns the system’s date and time in a t_datetime data structure.

t_int64 systime_datetime_milliseconds

(

void

)

Find out the current date/time as number of ms since 1/1/1970.

Returns

the number of milliseconds since 1/1/1970.

t_ptr_uint systime_datetoseconds

(

t_datetime *

d

)

Convert a t_datetime representation of time into seconds.

Parameters

d	The address of a t_datetime that contains a valid period of time.

Returns

The number of seconds represented by d.

t_uint32 systime_ms

(

void

)

Find out the operating system’s time in milliseconds.

Note that this is approximately the number of milliseconds since the OS was started up.

Returns

the system time in milliseconds.

t_ptr_uint systime_seconds

(

void

)

Find out the operating system’s time in seconds.

Returns

the system time in seconds.

void systime_secondstodate	(	t_ptr_uint	secs,
		t_datetime *	d
	)

Convert a time in seconds into a t_datetime representation.

Parameters

secs	A number of seconds to be represented as a t_datetime.
d	The address of a t_datetime that will be filled with the converted value.

t_uint32 systime_ticks

(

void

)

Find out the operating system’s time in ticks.

Returns

the system time in ticks.

Referenced by jit_rand_setseed().