{
"id": "fn-sys-timestamp_micro",
"dataComponent": "sys",
"heading": {
"title": "timestamp_micro",
"badges": [
"System"
]
},
"synopsis": "Returns the current epoch time in microseconds (as a 64-bit integer).",
"codeBlocks": [
"############################################################\n# Example usage:\n############################################################\n\n# 1) Call sys:timestamp_micro() with no arguments.\nus = sys:timestamp_micro()\n\n# 2) Print or store the integer result.\nsput(us)\n\n# This returns the current Unix timestamp in microseconds as a 64-bit integer.\n# For example, 1,684,413,825,123,456 means ~1.684 trillion microseconds.\n"
],
"notes": [
"sys:timestamp_micro() calls the system clock and returns a 64-bit integer (i64) measuring microseconds since the Unix epoch (1970-01-01).",
"No arguments are taken; if any arguments are passed, it raises an error.",
"If you need millisecond precision, see sys:timestamp_ms(). For microseconds, use this function."
]
}