> For the complete documentation index, see [llms.txt](https://www.rxjs.es/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.rxjs.es/operadores/utility/delay.md).

# delay

<details>

<summary>Signatura</summary>

#### Firma

`delay<T>(delay: number | Date, scheduler: SchedulerLike = async): MonoTypeOperatorFunction<T>`

#### Parámetros

#### Retorna

`MonoTypeOperatorFunction<T>`: Un Observable que retrasa las emisiones del Observable fuente por el `timeout` o `Date` especificado.

</details>

## Descripción

Retrasa las emisiones del Observable durante un tiempo o hasta una fecha determinados.

![Diagrama de canicas del operador delay](https://github.com/puntotech/rxjs-docu/blob/master/doc/operators/utility/assets/images/marble-diagrams/utility/delay.png)

Si el argumento `delay` es de tipo `Number`, el operador retrasa el Observable fuente durante esa cantidad de tiempo, expresada en milisegundos. Los intervalos de tiempo relativos entre valores se mantienen.

Si el argumento `delay` es de tipo `Date`, el oeprador retrasa el comienzo de la ejecución Observable hasta que no llegue la fecha proporcionada.

## Ejemplos

**Retrasa la emisión de cada tecla pulsada durante dos segundos**

[StackBlitz](https://stackblitz.com/edit/rxjs-delay-1?file=index.ts)

```typescript
import { delay, map } from "rxjs/operators";
import { fromEvent } from "rxjs";

const key$ = fromEvent<KeyboardEvent>(document, "keydown").pipe(
  map(({ code }) => code)
);

key$.pipe(delay(2000)).subscribe(console.log);
// Salida: (2s) KeyR (2s) KeyX (2s) KeyJ (2s) (KeyS)
```

**Retrasa la emisión de cada tecla pulsada hasta una fecha determinada**

[StackBlitz](https://stackblitz.com/edit/rxjs-delay-2?file=index.ts)

```typescript
import { delay, map } from "rxjs/operators";
import { fromEvent } from "rxjs";

const key$ = fromEvent<KeyboardEvent>(document, "keydown").pipe(
  map(({ code }) => code)
);

key$.pipe(delay(new Date("February 10, 2025")));
// Salida: Tendremos que esperar unos años para ver el resultado
```

### Ejemplos de la documentación oficial

**Retrasa la emisión de cada click durante un segundo**

```javascript
import { fromEvent } from "rxjs";
import { delay } from "rxjs/operators";

const clicks = fromEvent(document, "click");
const delayedClicks = clicks.pipe(delay(1000)); // each click emitted after 1 second
delayedClicks.subscribe((x) => console.log(x));
```

**Retrasa todos los clicks hasta que sea una fecha determinada**

```javascript
import { fromEvent } from "rxjs";
import { delay } from "rxjs/operators";

const clicks = fromEvent(document, "click");
const date = new Date("March 15, 2050 12:00:00"); // in the future
const delayedClicks = clicks.pipe(delay(date)); // click emitted only after that date
delayedClicks.subscribe((x) => console.log(x));
```

### Recursos adicionales

[![Source code](https://github.com/puntotech/rxjs-docu/blob/master/doc/operators/utility/assets/icons/source-code.png)](https://github.com/ReactiveX/rxjs/blob/master/src/internal/operators/delay.ts)

[Documentación oficial en inglés](https://rxjs.dev/api/operators/delay)