# ToDateString (DateTime)

| **Name**    | ***ToDate (String)***                                                                                                                       |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Syntax      | ToDate (String dateStr, String format)                                                                                                      |
| Purpose     | To convert a string into a date according to the given format.                                                                              |
| Description | Returns the resulting date time. Returns error if date cannot be converted.                                                                 |
| Return Type | DateTime                                                                                                                                    |
| Parameters  | <p>dateStr \[System.String] – String representing date value to convert.</p><p>format \[System.String] – Date format to use to convert.</p> |

<figure><img src="https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FXdsFRxAB22Xtw4jsYjtz%2F0.png?alt=media" alt=""><figcaption></figcaption></figure>

**Example**

In this example, we will pass string values to the function transformation object using a *Variables* object.

Where,

*dateStr* = 15/JUN/17

*format* = dd/MMM/yy

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FQ8xr2jg2SvIGTFFrSMwn%2F1.png?alt=media)

In the output window, you can see that the provided *dateStr* value, of the specified *format* value, has been converted into a date time value.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FXOsZiqSM5n6LB1lS4Ylf%2F2.png?alt=media)