Difference between revisions of "LlGetTime"

From Second Life Wiki
Jump to: navigation, search
(add sim reset to the list of events that reset this llGetTime dilated measure of elapsed run time)
(clarify to "seconds and fractional seconds" from the misleadingly brief "seconds" that can mean counting only whole seconds)
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 sim reset, script reset, call of [[llResetTime]], or call of [[llGetAndResetTime]].
+
|return_text=that is the dilated time in seconds and fractional 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 21:03, 19 October 2007

Summary

Function: float llGetTime( );

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.
All Issues ~ Search JIRA for related Bugs

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

Search JIRA for related Issues

Signature

function float llGetTime();