llGetUnixTime

Summary

Function: integer llGetUnixTime( );
0.0 Forced Delay
10.0 Energy

Returns an integer that is the number of seconds elapsed since 00:00 hours, Jan 1, 1970 "Wikipedia logo"UTC from the system clock (Unix time).

Caveats

  • Time codes outside 1901-12-13 20:45:52 UTC and 2038-01-19 03:14:08 UTC cannot be represented in LSL due to its use of signed 32-bit integers for Unix times. Scripts that rely on this function after January 19, 2038 may have logical errors.
    • Consider llGetTimestamp instead, which will correctly report time through 2038.
    • Lua scripts (not including LSL scripts compiled for the Luau VM) do not have this limitation with os.time(), since it returns a 64-bit number and will correctly represent time through the likely heat death of the universe.

Examples

// Reset tracker
integer BOOT_TIME;
default
{
    state_entry()
    {
        BOOT_TIME = llGetUnixTime(); 
        llSetTimerEvent(0.1);
    }
    
    timer()
    {
        llSetText((string)(llGetUnixTime() - BOOT_TIME) + " Seconds since boot.\n\n ", <1,0,0>, 1.0);
        llSetTimerEvent(1);
    }
}

Useful Snippets

Helper Functions:

β€’  Unix2StampLst – Converts Unix Time stamp to a list. ex: 1234567890 to [2009, 2, 13, 23, 31, 30]
β€’  Stamp2UnixInt – Converts date to Unix Time stamp. ex: [2009, 2, 13, 23, 31, 30] to 1234567890
β€’  uuLinuxTime – Converts date to Unix Time stamp (from Linux kernel's sources)
β€’  Unix2WeekdayStr – Gets the weekday from a Unix Time stamp. ex: "Friday" from 1234567890
β€’  Unix2PST_PDT – Converts Unix Time stamp to an SLT date/time string with PST or PDT indication as appropriate
β€’  Unix2GMTorBST – Converts Unix Time stamp to a UK date/time string with GMT or BST indication as appropriate

See Also

Functions

β€’  llGetTimestamp – Human Readable UTC Date and time
β€’  llGetDate – Human Readable UTC Date
β€’  llGetTime – Elapsed script-time.

Deep Notes

Tests

β€’  llGetUnixTime Conformance Test

Signature

function integer llGetUnixTime();

Haiku

Ticking time bomb waits,
A few years till scripts explodeβ€”
Y2K, take two!
β€” ChatGPT 4