Max API
8.2.0
|
The Systime API provides the means of getting the system time, instead of the scheduler time as you would with functions like gettime(). More...
Data Structures | |
struct | t_datetime |
The Systime data structure. More... | |
Enumerations | |
enum | e_max_dateflags { SYSDATEFORMAT_FLAGS_SHORT , SYSDATEFORMAT_FLAGS_MEDIUM , SYSDATEFORMAT_FLAGS_LONG , SYSDATEFORMAT_RELATIVE } |
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 January 1, 1970, GMT. More... | |
void | systime_datetime (t_datetime *d) |
Find out the operating system’s current local date and time. More... | |
t_ptr_uint | systime_seconds (void) |
Find out the operating system’s time in seconds since midnight, January 1, 1904, GMT (mac HFS time). 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 (const t_datetime *d) |
Convert a t_datetime representation of time into seconds since midnight, January 1, 1904, GMT. More... | |
void | sysdateformat_strftimetodatetime (const char *strf, t_datetime *d) |
Fill a t_datetime struct with a datetime formatted string. More... | |
void | sysdateformat_formatdatetime (const t_datetime *d, long dateflags, long timeflags, char *s, long buflen) |
Get a human friendly string representation of a t_datetime. More... | |
The Systime API provides the means of getting the system time, instead of the scheduler time as you would with functions like gettime().
enum e_max_dateflags |
Flags for the sysdateformat_formatdatetime() function.
Enumerator | |
---|---|
SYSDATEFORMAT_FLAGS_SHORT | short |
SYSDATEFORMAT_FLAGS_MEDIUM | medium |
SYSDATEFORMAT_FLAGS_LONG | long |
void sysdateformat_formatdatetime | ( | const t_datetime * | d, |
long | dateflags, | ||
long | timeflags, | ||
char * | s, | ||
long | buflen | ||
) |
Get a human friendly string representation of a t_datetime.
For example: "Dec 17, 2020 at 10:48 AM" or, when dateflags is SYSDATEFORMAT_RELATIVE a string like "Today", "Yesterday", etc.
d | The address of a t_datetime to format as a string. The t_datetime entries correspond to the local time. |
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 | ( | const 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".
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 current local date and time.
d | Returns the system’s date and time in the local time zone in a t_datetime data structure. |
t_int64 systime_datetime_milliseconds | ( | void | ) |
Find out the current date/time as number of ms since January 1, 1970, GMT.
t_ptr_uint systime_datetoseconds | ( | const t_datetime * | d | ) |
Convert a t_datetime representation of time into seconds since midnight, January 1, 1904, GMT.
d | The address of a t_datetime to be converted to seconds. The t_datetime values are in the local time zone. |
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.
t_ptr_uint systime_seconds | ( | void | ) |
Find out the operating system’s time in seconds since midnight, January 1, 1904, GMT (mac HFS time).
void systime_secondstodate | ( | t_ptr_uint | secs, |
t_datetime * | d | ||
) |
Convert a time in seconds into a t_datetime representation.
secs | A number of seconds since midnight, January 1, 1904, GMT, to be represented as a t_datetime. |
d | The address of a t_datetime that will be filled to the corresponding time, in the local time zone. |
t_uint32 systime_ticks | ( | void | ) |
Find out the operating system’s time in ticks.
Referenced by jit_rand_setseed().