<!--
{
  "availability" : [
    "iOS: 4.0.0 -",
    "iPadOS: 4.0.0 -",
    "macCatalyst: 13.0.0 -",
    "macOS: 10.4.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 4.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreVideo",
  "identifier" : "/documentation/CoreVideo/CVTimeStamp",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Core Video"
    ],
    "preciseIdentifier" : "c:@SA@CVTimeStamp"
  },
  "title" : "CVTimeStamp"
}
-->

# CVTimeStamp

A structure for defining a display timestamp.

```
struct CVTimeStamp
```

## Overview

This structure is designed to be very similar to the audio timestamp defined in the Core Audio framework except that, in CVTimeStamp, floating-point values are not used to represent the video equivalent of sample times.

## Topics

### Initializers

[`init()`](/documentation/CoreVideo/CVTimeStamp/init())

[`init(version:videoTimeScale:videoTime:hostTime:rateScalar:videoRefreshPeriod:smpteTime:flags:reserved:)`](/documentation/CoreVideo/CVTimeStamp/init(version:videoTimeScale:videoTime:hostTime:rateScalar:videoRefreshPeriod:smpteTime:flags:reserved:))

### Properties

[`flags`](/documentation/CoreVideo/CVTimeStamp/flags)

A bit field containing additional information about the timestamp.

[`hostTime`](/documentation/CoreVideo/CVTimeStamp/hostTime)

The system time measured by the timestamp.

[`rateScalar`](/documentation/CoreVideo/CVTimeStamp/rateScalar)

The current rate of the device as measured by the timestamps, divided by the nominal rate.

[`reserved`](/documentation/CoreVideo/CVTimeStamp/reserved)

Reserved. Do not use.

[`smpteTime`](/documentation/CoreVideo/CVTimeStamp/smpteTime)

The SMPTE time representation of the timestamp.

[`version`](/documentation/CoreVideo/CVTimeStamp/version)

The current `CVTimeStamp` structure is version 0. Some functions require you to specify a version when passing in a timestamp structure to be filled.

[`videoRefreshPeriod`](/documentation/CoreVideo/CVTimeStamp/videoRefreshPeriod)

[`videoTime`](/documentation/CoreVideo/CVTimeStamp/videoTime)

The start of a frame (or field for interlaced video).

[`videoTimeScale`](/documentation/CoreVideo/CVTimeStamp/videoTimeScale)

The scale (in units per second) of the `videoTimeScale` and `videoRefreshPeriod` fields.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)