--- title: "@std/ulid" description: "Generation of Universally Unique Lexicographically Sortable Identifiers (ULIDs)" jsr: jsr:@std/ulid pkg: ulid version: 1.0.0 generated: true stability: stable --- ## Overview

Utilities for generating and working with Universally Unique Lexicographically Sortable Identifiers (ULIDs).

To generate a ULID use the ulid function. This will generate a ULID based on the current time.

```js import { ulid } from "@std/ulid"; ulid(); // 01HYFKMDF3HVJ4J3JZW8KXPVTY ```

ulid does not guarantee that the ULIDs will be strictly increasing for the same current time. If you need to guarantee that the ULIDs will be strictly increasing, even for the same current time, use the monotonicUlid function.

```js import { monotonicUlid } from "@std/ulid"; monotonicUlid(); // 01HYFKHG5F8RHM2PM3D7NSTDAS monotonicUlid(); // 01HYFKHG5F8RHM2PM3D7NSTDAT ```

Because each ULID encodes the time it was generated, you can extract the timestamp from a ULID using the decodeTime function.

```js import { decodeTime, ulid } from "@std/ulid"; import { assertEquals } from "@std/assert"; const timestamp = 150_000; const ulidString = ulid(timestamp); assertEquals(decodeTime(ulidString), timestamp); ``` ### Add to your project ```sh deno add jsr:@std/ulid ``` See all symbols in @std/ulid on