# ToDate Date (DateTime)

| **Name**    | ***ToDate***                                                                                                                               |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Syntax      | ToDate (Integer year, Integer month, Integer day)                                                                                          |
| Purpose     | To create a new date using specified year, month, and day.                                                                                 |
| Description | Returns the newly created date if the parameters evaluate to a valid date. Otherwise returns null.                                         |
| Return Type | DateTime                                                                                                                                   |
| Parameters  | <p>year \[System.Int64] – Year including the century</p><p>month \[System.Int64] – Month (1-12)</p><p>day \[System.Int64] – Day (1-31)</p> |

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

**Example**

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

Where,

*year* = 2017

*month* = 12

*day* = 25

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

In the output window, you can see that the provided values have been converted into a DateTime value.

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