# Timestamp

## `this.package.timestamp` Variable

The `this.package.timestamp` variable provides the **exact timestamp (in milliseconds)** representing when the data was sent from the **client environment** to the **JENTIS Environment**.

***

### Purpose

This variable captures the **client-side moment** of event dispatch, allowing for:

* Accurate **time-based segmentation**
* **Latency measurements**
* Event ordering and **synchronization across systems**

***

### Variable Definition

| Property          | Description                                |
| ----------------- | ------------------------------------------ |
| **Variable Name** | `this.package.timestamp`                   |
| **Type**          | `integer` (Unix timestamp in milliseconds) |
| **Scope**         | Available in **server-side variables**     |
| **Timezone**      | UTC                                        |
| **Format**        | Milliseconds since epoch (Unix time)       |

***

### Example Usage

```js
async function() {
    var x = this.package.timestamp; // e.g., 1668157352000
    return x;
}
```

This example returns the exact timestamp of when the event was dispatched from the client to the JENTIS Environment.

***

### Notes

* This is **not the time of processing on the server** — it reflects the **client’s send time**.
* The timestamp is recorded **in milliseconds** for high precision.
* Useful for calculating **delays** between client send and server receipt times.

***

### Use Cases

* Aligning events with external systems based on client timing
* Comparing server receipt time vs. client send time
* Filtering or grouping events by specific time windows

***

### Summary

`this.package.timestamp` is a reliable way to access the original **client-side event time** in milliseconds. It enables precise event ordering, temporal analysis, and accurate data alignment for server-side logic in JENTIS.
