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.