---
title: "getTime"
canonical: "https://help.vicon.com/space/ShogunPost118/544280777/getTime"
format: markdown
---
# Description

Returns the current frame number or time in seconds.

The getTime command identifies the current time, in terms of frames or seconds.

## Functional area

Data retrieval

# Command syntax

## Syntax

|  |
| --- |
| `getTime [-s]` |

### Arguments

None

### Flags

> Macro (scroll-tablelayout)

| **Name** | **Flag arguments** | **Argument type** | **Exclusive to** | **Comments** |
| --- | --- | --- | --- | --- |
| `s` | 0 | — | — | Return the current time in seconds. Otherwise, time is returned as a frame number. |

## Return value

float

Returns the current scene time in seconds or frames.

> Macro (scroll-pagebreak)

## Examples

```plaintext
int $time = `getTime`;
print $time; 
// Identifies the current frame and saves the result to an
// integer variable.
  
float $time = `getTime`;
print $time; 
// Identifies the current frame and saves the result to a
// floating point variable.
```

# Additional information

## Related commands

- [animRange](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544278817)
- [fastForward](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544279629)
- [getAnimEnd](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544279852)
- [getPlayEnd](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544280531)
- [getPlayStart](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544280538)
- [play](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544281250)
- [playOptions](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544281264)
- [playRange](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544281271)
- [setRangesFollowActiveClip](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544282394)
- [setTime](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544282510)
- [step](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544282763)
- [stepKey](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544282770)
- [stop](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost118/pages/544282777)