Time

Various common formatted times. The time is based on the last time it was updated by the process, which may vary from systems. You can use a force_update flag in most methods to refresh the time value at the cost of minimal CPU.

cloud.time

Example

local localTime = cloud.time.localTime( true ) --force update

Epoch

.epoch

cloud.time.epoch( [ force_update ] )

Parameters

Key Description Type Default Required
force_update Force the system clock to refresh. boolean false N

Returns

Time since the epcoch. Known also as "UNIX" time.

Example

local epoch = cloud.time.epoch()

UTC

.utc

cloud.time.utc( [ force_update ] )

Parameters

Key Description Type Default Required
force_update Force the system clock to refresh. boolean false N

Returns

Universal Time.

Example

local utc_time = cloud.time.utc()

LocalTime

.localTime

cloud.time.localTime( [ force_update ] )

Parameters

Key Description Type Default Required
force_update Force the system clock to refresh. boolean false N

Returns

Local Timestamp.

Example

local local_time = cloud.time.localTime()

CookieTime

.cookieTime

cloud.time.cookieTime( seconds[, force_update ] )

Parameters

Key Description Type Default Required
seconds Seconds to convert to a "cookie" timestamp. number nil Y
force_update Force the system clock to refresh. boolean false N

Returns

A timestamp formatted for use with a HTTP "cookie".

Example

local cookie_time = cloud.time.cookieTime(time.now()+20000)

HTTPTime

.httpTime

cloud.time.httpTime( seconds[, force_update ] )

Parameters

Key Description Type Default Required
seconds Seconds to convert to a "HTTP" timestamp. number nil Y
force_update Force the system clock to refresh. boolean false N

Returns

A timestamp formatted for use with a HTTP "header".

Example

local http_time = cloud.time.httpTime(time.now()+20000)

Now

.now

cloud.time.now( [ force_update ] )

Parameters

Key Description Type Default Required
force_update Force the system clock to refresh. boolean false N

Returns

Returns the current epoch time as a floating point value.

Example

local now = cloud.time.now(true) --force update

Today

.today

cloud.time.today( [ force_update ] )

Parameters

Key Description Type Default Required
force_update Force the system clock to refresh. boolean false N

Returns

Returns the current datetime.

Example

local today = cloud.time.today()

Update

.update

Updates the system time cache. Same as passing force_update flag.

cloud.time.update()

Parameters

None

Returns

None

Example

cloud.time.update() -- Force the system clock to refresh.