---
title: "system.date.getDate"
description: "Creates a new Date object given a year, month and a day."
---

# system.date.getDate

> Creates a new Date object given a year, month and a day.

This function is used in **Python Scripting**.

## Description

Creates a new Date object given a year, month and a day. The time will be set to midnight of that day.

## Client Permission Restrictions

This scripting function has no [Client Permission](ignition-modules\vision\vision-project-properties\vision-project-properties.md#vision-permissions-properties) restrictions.

## Syntax

`system.date.getDate(year, month, day)`

### Parameters
Type | Parameter | Description 
------- | ------- | -------
Integer | `year` | The year for the new date.
Integer | `month` | The month of the new date. January is month 0.
Integer | `day` | The day of the month for the new date. The first day of the month is day 1.

### Returns
**Date** - A new date, set to midnight of that day.

### Scope
Gateway, Vision Client, Perspective Session

## Code Examples

```python title="Code Snippet"
# This example will create a new date object set to January 1st, 2017.
  
date = system.date.getDate(2017, 0, 1)
print date
```