llGetInventoryAcquireTime

From Second Life Wiki
Revision as of 03:55, 7 October 2023 by Wulfie Reanimator (talk | contribs) (Added information about format and precision.)
Jump to navigation Jump to search

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.

The time is in the UTC time zone in the format "YYYY-MM-DDThh:mm:ssZ"

Appears to be accurate to seconds.

• 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

•  llGetTimestamp Returns the current timestamp using the same format
•  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 );