Difference between revisions of "LlGetTime"

From Second Life Wiki
Jump to: navigation, search
m
(Unqualify the precision)
 
(12 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{LSL_Function
+
{{Issues/SVC-3293}}{{LSL_Function
 
|func_id=82|func_sleep=0.0|func_energy=10.0
 
|func_id=82|func_sleep=0.0|func_energy=10.0
 
|func=llGetTime|sort=GetTime
 
|func=llGetTime|sort=GetTime
 
|return_type=float
 
|return_type=float
|return_text=that is script time in seconds with subsecond precision since the last sim reset, script reset or call to either [[llResetTime]] or [[llGetAndResetTime]].
+
|return_text=that is script time in seconds with subsecond precision since the script started, was last reset, or call to either [[llResetTime]] or [[llGetAndResetTime]].
 
|func_footnote
 
|func_footnote
|spec=Script time differs from normal time, it is affected by time dilation. See [[llGetRegionTimeDilation]] for details.
+
|spec=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=
 
|caveats=
 +
*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.
 
*Script time resets when...
 
*Script time resets when...
 
**Script reset (user or [[llResetScript]] or [[llResetOtherScript]])
 
**Script reset (user or [[llResetScript]] or [[llResetOtherScript]])
**Simulator reset (admin or crash){{Footnote|[[#SVC-3293|SVC-3293]] may interfere with this|SVC-3293 may interfere with this}}
 
 
**Call to either [[llResetTime]] or [[llGetAndResetTime]]
 
**Call to either [[llResetTime]] or [[llGetAndResetTime]]
*Script time doesn't measure real world time, it is affected by time dilation.
+
* Due to (32 bit) floating point number limitations, the accuracy of this function is 1/32sec up to ~3 days, 1/16sec up to ~6 days, etc... doubling each time, e.g. it's only 1 second at ~194 days. Use [[llResetTime]] or [[llGetAndResetTime]] whenever practical to maintain the accuracy you require.
|examples=<lsl>
+
|examples=<source lang="lsl2">
 
default {
 
default {
 
     state_entry()
 
     state_entry()
Line 25: Line 25:
 
     }
 
     }
 
}
 
}
</lsl>
+
</source>
 +
<source lang="lsl2">
 +
// Distinguish between a single click and a double click
 +
 
 +
float gHoldTime;
 +
 
 +
default
 +
{
 +
    touch_start(integer total_number)
 +
    {
 +
        float now = llGetTime();
 +
        if (now - gHoldTime < 0.3)
 +
        {
 +
            llSay(PUBLIC_CHANNEL,"Double clicked");
 +
            // Trigger one sequence of actions
 +
        }
 +
        else
 +
        {
 +
            llSetTimerEvent(0.32);
 +
        }
 +
        gHoldTime = now;
 +
    }
 +
   
 +
    timer()
 +
    {
 +
        llSetTimerEvent(0.0);
 +
        if (llGetTime()-gHoldTime > 0.3)
 +
        {
 +
            llSay(PUBLIC_CHANNEL,"Single clicked.");
 +
            // Trigger a different sequence of actions
 +
        }
 +
    }
 +
}
 +
</source>
 +
<source lang="lsl2">
 +
//  To do time-dependant loops of whatever:
 +
//  for example move 2 meters within 5.0 seconds
 +
 
 +
float time = 5.0;
 +
float i;
 +
llResetTime();
 +
do
 +
{
 +
    i = llGetTime()/time;
 +
    // move2meters*i
 +
}
 +
while (llGetTime() < time);
 +
</source>
 
|helpers
 
|helpers
 
|also_functions={{LSL DefineRow||[[llResetTime]]}}
 
|also_functions={{LSL DefineRow||[[llResetTime]]}}
Line 31: Line 78:
 
{{LSL DefineRow||[[llGetRegionTimeDilation]]}}
 
{{LSL DefineRow||[[llGetRegionTimeDilation]]}}
 
|also
 
|also
|notes=Script time does not measure time dilation.
+
|issues
To measure elapsed calendar time, call [[llGetTimestamp]] instead, since time dilation and resets often make dilated time intervals differ from calendar time intervals.
+
|issues={{Issue|SVC-3293|llGetTime doesn't reset on admin requested sim restart|type=bug}}
+
 
|cat1=Time
 
|cat1=Time
 
|cat2=Script
 
|cat2=Script

Latest revision as of 10:51, 11 May 2019

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

  • 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.
  • Script time resets when...
  • Due to (32 bit) floating point number limitations, the accuracy of this function is 1/32sec up to ~3 days, 1/16sec up to ~6 days, etc... doubling each time, e.g. it's only 1 second at ~194 days. Use llResetTime or llGetAndResetTime whenever practical to maintain the accuracy you require.
All Issues ~ Search JIRA for related Bugs

Examples

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." );
    }
}
// Distinguish between a single click and a double click
 
float gHoldTime;
 
default
{
    touch_start(integer total_number)
    {
        float now = llGetTime();
        if (now - gHoldTime < 0.3)
        {
            llSay(PUBLIC_CHANNEL,"Double clicked");
            // Trigger one sequence of actions
        }
        else
        {
            llSetTimerEvent(0.32);
        }
        gHoldTime = now;
    }
 
    timer()
    {
        llSetTimerEvent(0.0);
        if (llGetTime()-gHoldTime > 0.3)
        {
            llSay(PUBLIC_CHANNEL,"Single clicked.");
            // Trigger a different sequence of actions
        }
    }
}
//  To do time-dependant loops of whatever:
//  for example move 2 meters within 5.0 seconds
 
float time = 5.0;
float i;
llResetTime();
do
{
    i = llGetTime()/time;
    // move2meters*i
}
while (llGetTime() < time);

See Also

Deep Notes

All Issues

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

Signature

function float llGetTime();