---
title: "timeSample(at:time:)"
framework: usdkit
role: symbol
role_heading: Instance Method
path: "usdkit/usdlayer/timesample(at:time:)"
---

# timeSample(at:time:)

Returns the time-sampled value for the attribute at the given path at the specified time, or nil if none is authored at that time.

## Declaration

```swift
func timeSample(at path: USDLayer.Path, time: USDLayer.TimeCode) -> USDValue?
```

## Parameters

- `path`: The attribute path.
- `time`: The time to query.

## Return Value

Return Value The authored sample, or nil if none exists at time.

## See Also

### Working with time samples

- [timeSamples(at:)](usdkit/usdlayer/timesamples(at:).md)
- [allTimeSamples](usdkit/usdlayer/alltimesamples.md)
- [setTimeSample(at:time:value:)](usdkit/usdlayer/settimesample(at:time:value:)-6t3qd.md)
- [setTimeSample(at:time:value:)](usdkit/usdlayer/settimesample(at:time:value:)-3ot1j.md)
- [eraseTimeSample(at:time:)](usdkit/usdlayer/erasetimesample(at:time:).md)