llGetTime

From Second Life Wiki
Revision as of 21:03, 19 October 2007 by Ppaatt Lynagh (talk | contribs) (clarify to "seconds and fractional seconds" from the misleadingly brief "seconds" that can mean counting only whole seconds)
Jump to navigation Jump to search

Summary

Function: float llGetTime( );
0.0 Forced Delay
10.0 Energy

Returns a float that is the dilated time in seconds and fractional seconds since the last sim reset, script reset, call of llResetTime, or call of llGetAndResetTime.

Reports elapsed run time more accurately than llGetTimestamp by accounting correctly for time dilation.

Caveats

  • Correctly slowed by time dilation, whenever llGetRegionTimeDilation returns a value other than exactly 1.
  • Reset by various events outside user control, such as sim resets.

Examples

default {
    state_entry()
    {
        llResetTime();
    }
    touch_start(integer num_touch)
    {
        float time;
        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." );
    }
}

Notes

To measure elapsed calendar time, call llGetTimestamp instead, since time dilation and resets often make dilated time intervals differ from calendar time intervals.

See Also

Deep Notes

Signature

function float llGetTime();