Difference between revisions of "NXSL:localtime"

From NetXMS Wiki
Jump to navigation Jump to search
m (Text replacement - "^" to "{{deprecated}}")
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
<syntaxhighlight>localtime([time])</syntaxhighlight>
{{deprecated}}__NOTOC__
Converts time in UNIX format (number of seconds since epoch) to calendar date and time broken down into its components. Function uses either time given in time argument or current time if time is omitted.


Converts time in UNIX format (number of seconds since epoch) to calendar date and time broken down into its components. Function uses either time given in time argument or current time if time is omitted. Return value is an object of class TIME with the following attributes:
 
{| class="wikitable"
== Syntax ==
|-
 
! Attribute !! Synonym !! Meaning
localtime(''time'');
|-
 
| sec || tm_sec || Seconds after the minute
 
|-
== Parameters ==
| min || tm_min || Minutes after the hour
 
|-
:{|
| hour || tm_hour || Hours since midnight
|-
| mday || tm_mday || Day of the month
|-
|-
| mon || tm_mon || Months since January  
| ''time'' || Time as seconds since epoch (1 January 1970 00:00:00 UTC). If omitted, current time is used.
|-
| year || tm_year || Year
|-
| wday || tm_wday || Days since Sunday
|-
| yday || tm_yday || Days since January 1
|-
| isdst || tm_isdst || Daylight Saving Time flag
|}
|}


== Examples ==
<syntaxhighlight>localtime(time())->year</syntaxhighlight>


Result: 2012 (integer)
== Return Value ==
 
Object of class [[NXSL:TIME|TIME]].
 


Equivalent:
== Examples ==
<syntaxhighlight>localtime()->year</syntaxhighlight>


Result: 2012 (integer)
localtime(time())->year -> 2012
localtime()->year -> 2012

Latest revision as of 16:13, 13 September 2022

This Wiki is deprecated and we are are currrently migrating remaining pages into product documentation (Admin Guide, NXSL Guide)

Converts time in UNIX format (number of seconds since epoch) to calendar date and time broken down into its components. Function uses either time given in time argument or current time if time is omitted.


Syntax

localtime(time);


Parameters

time Time as seconds since epoch (1 January 1970 00:00:00 UTC). If omitted, current time is used.


Return Value

Object of class TIME.


Examples

localtime(time())->year		->	2012
localtime()->year		->	2012