Difference between revisions of "LlGetTime"

From Second Life Wiki
Jump to navigation Jump to search
m
m
Line 30: Line 30:
{{LSL DefineRow||[[llGetRegionTimeDilation]]}}
{{LSL DefineRow||[[llGetRegionTimeDilation]]}}
|also
|also
|notes=Script time can be reset by various events.
|notes=Script time is the amount of real-world time that the script has been in a running state. It is unaffected by time dilation, but it does not count time while the script is suspended, the user is offline (when in an attachment), the object is in inventory rather than rezzed, etc.
To measure elapsed calendar time, call [[llGetTimestamp]] instead, since simulator or script resets will make script time intervals differ from calendar time intervals.
|issues
|issues
|cat1=Time
|cat1=Time

Revision as of 19:31, 14 April 2010

Summary

Function: float llGetTime( );

Returns a float that is script time in seconds with subsecond precision since the script started, was last reset, or call to either llResetTime or llGetAndResetTime.

Specification

Script time matches normal time, it is unaffected by time dilation. For example, if you call llResetTime on two objects in separate simulators at the same time, and later call llGetTime on both at the same time, their values will be equal regardless of differences in dilation.

Caveats

All Issues ~ Search JIRA for related Bugs

Examples

<lsl> default {

   state_entry()
   {
       llResetTime();
   }
   touch_start(integer num_touch)
   {
       float time = llGetTime(); //Instead getting, and then resetting the time, we could use llGetAndReset() to accomplish the same thing.
       llResetTime();
       llSay(0,(string)time + " seconds have elapsed since the last touch." );
   }

}

</lsl>

Notes

Script time is the amount of real-world time that the script has been in a running state. It is unaffected by time dilation, but it does not count time while the script is suspended, the user is offline (when in an attachment), the object is in inventory rather than rezzed, etc.

See Also

Deep Notes

All Issues

~ Search JIRA for related Issues
   llGetTime doesn't reset on admin requested sim restart

Signature

function float llGetTime();