## getTimeStamp()

The  `getTimeStamp()`  command converts a date and time string, given in a specific format, to a timestamp value. Additionally, it allows for an optional time adjustment before storing the result in a target variable. This command is useful for converting human-readable date and time representations to a numeric timestamp format, which can be used in calculations or time comparisons.

### Parameters

* DateString Type: `var` Description: A string representing a date and time. This string must follow the format specified in the Format parameter. It can be a direct value or a variable containing the date string.
* Format Type: `var` Description: A format string that defines how to interpret the date and time string ( `DateString` ). This string follows Python's conventions for formatting and parsing dates and times. Some common symbols include: `%Y` : Year with four digits (e.g., 2024) `%m` : Month with two digits (01 to 12) `%d` : Day of the month with two digits (01 to 31) `%H` : Hour in 24-hour format (00 to 23) `%M` : Minutes (00 to 59) `%S` : Seconds (00 to 59) For example, to interpret the string `"2024-08-25 14:30:00"` , the format `%Y-%m-%d %H:%M:%S` would be used. It can be a direct value or a variable containing the format.
* `%Y` : Year with four digits (e.g., 2024)
* `%m` : Month with two digits (01 to 12)
* `%d` : Day of the month with two digits (01 to 31)
* `%H` : Hour in 24-hour format (00 to 23)
* `%M` : Minutes (00 to 59)
* `%S` : Seconds (00 to 59)
* TimeDelta Type: `var` Description: An optional value representing a time adjustment (positive or negative) applied to the timestamp after conversion. This value can be provided directly or through a variable and is expressed in seconds.
* TargetVariable Type: `var` Description: The variable where the resulting timestamp from the conversion will be stored. Unlike the other parameters, this must be a variable and not a direct value.

### Usage Example

```javascript
// Direct call with values:
            getTimeStamp('2024-08-25 14:30:00', '%Y-%m-%d %H:%M:%S', 3600, generatedTimestamp)

            // Call using variables:
            date = '2024-08-25 14:30:00'
            format = '%Y-%m-%d %H:%M:%S'
            adjustment = 3600
            getTimeStamp(date, format, adjustment, generatedTimestamp)
```

In the first example, the date and time string  `"2024-08-25 14:30:00"`  is converted to a timestamp, applying a 3600-second (1-hour) adjustment, and the result is stored in the variable  `generatedTimestamp` . In the second example, variables are used to define the date, format, and adjustment.
