Difference between revisions of "LlGetInventoryAcquireTime"

From Second Life Wiki
Jump to navigation Jump to search
m (Added caveats about missing milliseconds and its impact.)
m (Example added)
Line 13: Line 13:
*Using [[llListSort]] to sort a list of timestamps that both include and exclude milliseconds will have undesired results. ".000000" will first have to be inserted into timestamps missing milliseconds.
*Using [[llListSort]] to sort a list of timestamps that both include and exclude milliseconds will have undesired results. ".000000" will first have to be inserted into timestamps missing milliseconds.
|constants
|constants
|examples=
|examples=If there is no other item in the inventory, you get the timestamp from the script itself.
<source lang="lsl2">default
{
    state_entry()
    {
        llSay(0, "Hello, Avatar!");
    }
 
    touch_start(integer total_number)
    {
        string item = llGetInventoryName(INVENTORY_ALL, 0); // 0 means the first item in prim's inventory.
        string timestamp = llGetInventoryAcquireTime(item);
       
        llSay(0, "Timestamp for: " + item + " - " + timestamp); // output
    }
}</source>
|helpers
|helpers
|also_functions=
|also_functions=

Revision as of 01:46, 22 June 2021

Summary

Function: string llGetInventoryAcquireTime( string item );
0.0 Forced Delay
10.0 Energy

Returns a string with the timestamp that the item was added to the prim's inventory.

• string item an item in the inventory of the prim this script is in

Caveats

  • If item is missing from the prim's inventory then an error is shouted on DEBUG_CHANNEL.
  • This function currently returns an ISO timestamp that is missing milliseconds. It is recommended that you code your applications in preparation of millisecond support being added at a later date.
  • Using llListSort to sort a list of timestamps that both include and exclude milliseconds will have undesired results. ".000000" will first have to be inserted into timestamps missing milliseconds.

Examples

If there is no other item in the inventory, you get the timestamp from the script itself.

default
{
    state_entry()
    {
        llSay(0, "Hello, Avatar!");
    }

    touch_start(integer total_number)
    {
        string item = llGetInventoryName(INVENTORY_ALL, 0); // 0 means the first item in prim's inventory.
        string timestamp = llGetInventoryAcquireTime(item);
        
        llSay(0, "Timestamp for: " + item + " - " + timestamp); // output
    }
}

See Also

Functions

•  llGetInventoryCreator Returns the inventory item's creator
•  llGetInventoryName Returns the inventory item's name
•  llGetInventoryType Tests to see if an inventory item exists and returns its type
•  llGetInventoryNumber Returns the number of items of a specific type in inventory
•  llGetInventoryPermMask Returns the inventory item's permissions
•  llGetInventoryKey Returns the inventory item's UUID (if full perm)

Deep Notes

Signature

function string llGetInventoryAcquireTime( string item );