---
title: "system.date.setTime"
description: "Takes in a date, and returns a copy of it with the time fields set as specified."
---

# system.date.setTime

> Takes in a date, and returns a copy of it with the time fields set as specified.

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

## Description

## 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.setTime(date, hour, minute, second)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
Date | `date` | The starting date.
Integer | `hour` | The hours (0-23) to set.
Integer | `minute` | The minutes (0-59) to set.
Integer | `second` | The seconds (0-59) to set.

### Returns
**Date** - A new date, set to the appropriate time.

### Scope
Gateway, Vision Client, Perspective Session

## Code Examples

```python title="Code Snippet"
# This example will set the date object to the current date with the time set to 01:37 in the morning and 44 seconds.
  
date = system.date.getDate(2018, 6, 29) #getDate is zero based, so a month parameter of 6 will return July.
print system.date.setTime(date, 1, 37, 44) #This will print Sun July 29 01:37:44 PDT 2018
```