6. The Datetime library

The datetime library date and time manipulation facilities

6.1. Squirrel API

6.1.1. Global Symbols

clock()

returns a float representing the number of seconds elapsed since the start of the process

date([time[, format]])

returns a table containing a date/time split into the slots:

sec	Seconds after minute (0 - 59).
min	Minutes after hour (0 - 59).
hour	Hours since midnight (0 - 23).
day	Day of month (1 - 31).
month	Month (0 - 11; January = 0).
year	Year (current year).
wday	Day of week (0 - 6; Sunday = 0).
yday	Day of year (0 - 365; January 1 = 0).

if time is omitted the current time is used.

if format can be ‘l’ local time or ‘u’ UTC time, if omitted is defaulted as ‘l’(local time).

time()

returns the number of seconds elapsed since midnight 00:00:00, January 1, 1970.

the result of this function can be formatted through the function date()

6.2. C API

SQRESULT sqstd_register_datetimelib(HSQUIRRELVM v)

Parameters

• v (HSQUIRRELVM) – the target VM

Returns

an SQRESULT

Remarks

The function expects a table on top of the stack where to register the global library functions.

initialize and register the datetime library in the given VM.