Summary

Converts a UNIX timestamp to a human friendly structure.

Usage

gettime( timestamp )

Parameters

Name	Type	Description	Required
timestamp	integer	A UNIX timestamp.	Yes.

Returns

An associative array (see below).

Description

This operator takes a UNIX timestamp as a parameter and returns an associative array that contains a human friendly representation of the provided timestamp. The following table shows the keys of the returned hash.

Key	Type	Description
seconds	integer	Number of seconds.
minutes	integer	Number of minutes.
hours	integer	Number of hours.
day	integer	The day of the month (1-31).
month	integer	The month number (1 is January).
year	integer	A four digit representation of the year (for example "1978").
weekday	integer	The day of the week (1-7).
weeknumber	string	The week of the year (1-52).
yearday	integer	The day of the year (1-365).
epoch	integer	The UNIX timestamp that was provided.

Examples

Example 1

{gettime( currentdate() )|attribute(show)}

The "currentdate" operator is used to generate the UNIX timestamp for the current date/time. This value is then fed to the "gettime" operator, which converts it to a human friendly structure. The array is viewed using the "attribute" operator. The following output will be produced:

---