# addSeconds

Source: https://taxilang.org/docs/language/stdlib/addSeconds

**Full name:** `taxi.stdlib.dates.addSeconds`

## Signature

```taxi
declare function <T> addSeconds(T, Int):T
```

## Description

Adds the specified number of seconds to a datetime or instant. Use a negative value to subtract seconds.

```taxi
// Expire a token 3600 seconds (1 hour) from now
find {
   expiresAt: Instant = addSeconds(Instant, 3600)
}
```

## Examples

Adds seconds to an instant — positive to advance, negative to go back.

Query:

```taxi
given {
   start: Instant = parseDate("2024-01-15T10:30:00Z")
}
find {
   @Format("yyyy-MM-dd HH:mm:ss")
   plusThirty: Instant = addSeconds(Instant, 30)
   @Format("yyyy-MM-dd HH:mm:ss")
   minusTen: Instant = addSeconds(Instant, -10)
}
```

Result:

```json
{
  "plusThirty": "2024-01-15 10:30:30",
  "minusTen": "2024-01-15 10:29:50"
}
```
