Difference between revisions of "LlGetTime"

From Second Life Wiki
Jump to navigation Jump to search
(politely convert the first mention of llGetTimestamp here into a link)
(add sim reset to the list of events that reset this llGetTime dilated measure of elapsed run time)
Line 3: Line 3:
|func=llGetTime|sort=GetTime
|func=llGetTime|sort=GetTime
|return_type=float
|return_type=float
|return_text=that is the dilated time in seconds since the last script reset, or since the last call to [[llResetTime]] or [[llGetAndResetTime]].
|return_text=that is the dilated time in seconds since the last sim reset, script reset, call of [[llResetTime]], or call of [[llGetAndResetTime]].
|func_footnote=Reports elapsed run time more accurately than [[llGetTimestamp]] by accounting correctly for time dilation.
|func_footnote=Reports elapsed run time more accurately than [[llGetTimestamp]] by accounting correctly for time dilation.
|spec
|spec

Revision as of 20:19, 19 October 2007

Summary

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

Returns a float that is the dilated time in 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();