---
title: "setTime"
canonical: "https://help.vicon.com/space/ShogunPost121/1253737046/setTime"
format: markdown
---
# Description

Use setTime to explicitly set the current frame of the animation.

No argument sets the time to the beginning of the play range.

SMPTE times must be surrounded by quotes.

## Functional area

Playback control

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `setTime timeVal` |

### Arguments

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `frameNumber` | integer | yes | Float value representing frame number or time |

### Flags

None

## Return value

void

## Examples

```plaintext
setTime -s 2;
// Assuming a 60 fps scene, this command will set the current 
// time to frame 120
```

> Macro (scroll-pagebreak)

# Additional information

## Related commands

- [animRange](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737864)
- [fastForward](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736984)
- [getAnimEnd](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738102)
- [getPlayEnd](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738077)
- [getPlayStart](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737434)
- [getTime](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736823)
- [play](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737029)
- [playOptions](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736691)
- [playRange](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737114)
- [setRangesFollowActiveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736779)
- [step](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737636)
- [stepKey](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737885)
- [stop](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737596)