src/cobalt/site/docs/reference/starboard/modules/time.md

---
layout: doc
title: "Starboard Module Reference: time.h"
---

Provides access to system time and timers.

## Macros ##

### kSbTimeDay ###

One day in SbTime units (microseconds).

### kSbTimeHour ###

One hour in SbTime units (microseconds).

### kSbTimeMax ###

The maximum value of an SbTime.

### kSbTimeMillisecond ###

One millisecond in SbTime units (microseconds).

### kSbTimeMinute ###

One minute in SbTime units (microseconds).

### kSbTimeNanosecondsPerMicrosecond ###

How many nanoseconds in one SbTime unit (microseconds).

### kSbTimeSecond ###

One second in SbTime units (microseconds).

### kSbTimeToPosixDelta ###

A term that can be added to an SbTime to convert it into the number of
microseconds since the POSIX epoch.

## Typedefs ##

### SbTime ###

The number of microseconds since the epoch of January 1, 1601 UTC, or the number
of microseconds between two times. Always microseconds, ALWAYS UTC.

#### Definition ####

```
typedef int64_t SbTime
```

### SbTimeMonotonic ###

A number of microseconds from some point. The main property of this time is that
it increases monotonically. It should also be as high-resolution a timer as we
can get on a platform. So, it is good for measuring the time between two calls
without worrying about a system clock adjustment. It's not good for getting the
wall clock time.

#### Definition ####

```
typedef int64_t SbTimeMonotonic
```

## Functions ##

### SbTimeFromPosix ###

Converts microseconds from the POSIX epoch into an `SbTime`.

`time`: A time that measures the number of microseconds since January 1, 1970,
00:00:00, UTC.

#### Declaration ####

```
static SbTime SbTimeFromPosix(int64_t time)
```

### SbTimeGetMonotonicNow ###

Gets a monotonically increasing time representing right now.

#### Declaration ####

```
SbTimeMonotonic SbTimeGetMonotonicNow()
```

### SbTimeGetMonotonicThreadNow ###

Gets a monotonically increasing time representing how long the current thread
has been in the executing state (i.e. not pre-empted nor waiting on an event).
This is not necessarily total time and is intended to allow measuring thread
execution time between two timestamps. If this is not available then
SbTimeGetMonotonicNow() should be used.

#### Declaration ####

```
SbTimeMonotonic SbTimeGetMonotonicThreadNow()
```

### SbTimeGetNow ###

Gets the current system time as an `SbTime`.

#### Declaration ####

```
SbTime SbTimeGetNow()
```

### SbTimeNarrow ###

Safely narrows a number from a more precise unit to a less precise one. This
function rounds negative values toward negative infinity.

#### Declaration ####

```
static int64_t SbTimeNarrow(int64_t time, int64_t divisor)
```

### SbTimeToPosix ###

Converts `SbTime` into microseconds from the POSIX epoch.

`time`: A time that is either measured in microseconds since the epoch of
January 1, 1601, UTC, or that measures the number of microseconds between two
times.

#### Declaration ####

```
static int64_t SbTimeToPosix(SbTime time)
```