UUIDs · The Julia Language
Description: Documentation for The Julia Language.

# UUIDs

`UUIDs.uuid1` — Function

    uuid1([rng::AbstractRNG]) -> UUID

Generates a version 1 (time-based) universally unique identifier (UUID), as specified by RFC 4122. Note that the Node ID is randomly generated (does not identify the host) according to section 4.5 of the RFC.

The default rng used by `uuid1` is not `Random.default_rng()` and every invocation of `uuid1()` without an argument should be expected to return a unique identifier. Importantly, the outputs of `uuid1` do not repeat even when `Random.seed!(seed)` is called. Currently (as of Julia 1.6), `uuid1` uses `Random.RandomDevice` as the default rng. However, this is an implementation detail that may change in the future.

Julia 1.6

The output of `uuid1` does not depend on `Random.default_rng()` as of Julia 1.6.

Examples

    julia> using Random

    julia> rng = MersenneTwister(1234);

    julia> uuid1(rng)
    UUID("cfc395e8-590f-11e8-1f13-43a2532b2fa8")

source
`UUIDs.uuid4` — Function

    uuid4([rng::AbstractRNG]) -> UUID

Generates a version 4 (random or pseudo-random) universally unique identifier (UUID), as specified by RFC 4122.

The default rng used by `uuid4` is not `Random.default_rng()` and every invocation of `uuid4()` without an argument should be expected to return a unique identifier. Importantly, the outputs of `uuid4` do not repeat even when `Random.seed!(seed)` is called. Currently (as of Julia 1.6), `uuid4` uses `Random.RandomDevice` as the default rng. However, this is an implementation detail that may change in the future.

Julia 1.6

The output of `uuid4` does not depend on `Random.default_rng()` as of Julia 1.6.

Examples

    julia> using Random

    julia> rng = Xoshiro(123);

    julia> uuid4(rng)
    UUID("856e446e-0c6a-472a-9638-f7b8557cd282")

source
`UUIDs.uuid5` — Function

    uuid5(ns::UUID, name::String) -> UUID

Generates a version 5 (namespace and domain-based) universally unique identifier (UUID), as specified by RFC 4122.

Julia 1.1

This function requires at least Julia 1.1.

Examples

    julia> using Random

    julia> rng = Xoshiro(123);

    julia> u4 = uuid4(rng)
    UUID("856e446e-0c6a-472a-9638-f7b8557cd282")

    julia> u5 = uuid5(u4, "julia")
    UUID("2df91e3f-da06-5362-a6fe-03772f2e14c9")

source
`UUIDs.uuid_version` — Function

    uuid_version(u::UUID) -> Int

Inspects the given UUID and returns its version (see RFC 4122).

Examples

    julia> uuid_version(uuid4())
    4

source

Theme

This document was generated with Documenter.jl version 1.17.0 on Thursday 9 April 2026. Using Julia version 1.12.6.