# Parse Datetime (DP\_PDT)

DateTime data parsing involves extracting meaningful details from datetime values and converting them into formats that computers can understand. This process includes breaking down datetime strings into individual components such as year, month, day, hour, minute, and second.

By parsing datetime data, we enable our systems to recognize and use chronological patterns. For example, in financial analysis, parsing datetime information allows us to identify trading hours, weekdays, or specific times of the day.

The parsed datetime data can then be employed to align different datasets, create time-based features, and enable sophisticated chronological analyses. Whether it's for predicting trends, analyzing patterns, or understanding user interactions, datetime data parsing empowers us to unlock valuable insights embedded within time-related data.

## Sample Request

```javascript
{
    "project_id": 1,
    "parent_id": 5,
    "block_id": 6,
    "function_code": "DP_PDT",
    "args": {
        "index": 0,
        "drop": true
    }
}
```

## Request Parameters

## Parse Datetime

<mark style="color:green;">`POST`</mark> `https://autogon.ai/api/v1/engine/start`

#### Request Body

| Name                                             | Type   | Description                                                              |
| ------------------------------------------------ | ------ | ------------------------------------------------------------------------ |
| project\_id<mark style="color:red;">\*</mark>    | int    | current project ID                                                       |
| parent\_id<mark style="color:red;">\*</mark>     | int    | parent block ID                                                          |
| block\_id<mark style="color:red;">\*</mark>      | int    | current block ID                                                         |
| function\_code<mark style="color:red;">\*</mark> | String | block's function code                                                    |
| drop<mark style="color:red;">\*</mark>           | bool   | specifies if you want to drop the column after parsing the original date |
| args                                             | object | block arguments                                                          |
| index<mark style="color:red;">\*</mark>          | int    | column index to apply time stepping function                             |

{% tabs %}
{% tab title="200: OK Data Encode Successful" %}

```javascript
{
    "status": "true",
    "message": {
        "id": 3,
        "project": 1,
        "block_id": 7,
        "parent_id": 6,
        "dataset_url": "",
        "x_value_url": "",
        "y_value_url": ""
    }
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Python" %}

```
// Some code
```

{% endtab %}

{% tab title="Node" %}

```
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.autogon.ai/autogon-engine-studio/data-processing/parse-datetime-dp_pdt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.