Symbol

randomUUIDv7

function randomUUIDv7(encoding?: 'base64' | 'base64url' | 'hex', timestamp?: number | Date): string

Generate a UUIDv7, which is a sequential ID based on the current timestamp with a random component.

When the same timestamp is used multiple times, a monotonically increasing counter is appended to allow sorting. The final 8 bytes are cryptographically random. When the timestamp changes, the counter resets to a psuedo-random integer.

@param encoding

"hex" | "base64" | "base64url"

@param timestamp

Unix timestamp in milliseconds, defaults to Date.now()

import { randomUUIDv7 } from "bun";
const array = [
  randomUUIDv7(),
  randomUUIDv7(),
  randomUUIDv7(),
]
[
  "0192ce07-8c4f-7d66-afec-2482b5c9b03c",
  "0192ce07-8c4f-7d67-805f-0f71581b5622",
  "0192ce07-8c4f-7d68-8170-6816e4451a58"
]

function randomUUIDv7(encoding: 'buffer', timestamp?: number | Date): Buffer

Generate a UUIDv7 as a Buffer

@param encoding

"buffer"

@param timestamp

Unix timestamp in milliseconds, defaults to Date.now()