UUID v7 Guide

import uuid

# Python 3.12+
uid = uuid.uuid7()
print(uid)
# → 01956399-e5c4-7a3b-b7f2-4c9d08e1a2f3

# Install
pip install uuid6

import uuid6

uid = uuid6.uuid7()
print(uid)
print(uid.version)  # 7

import uuid
from datetime import datetime, timezone

uid = uuid.uuid7()
# First 48 bits are the Unix timestamp in milliseconds
ms  = uid.int >> 80
dt  = datetime.fromtimestamp(ms / 1000, tz=timezone.utc)
print(dt)  # e.g. 2026-04-07 14:23:11.456+00:00

# Install
go get github.com/google/uuid

package main

import (
    "fmt"
    "github.com/google/uuid"
)

func main() {
    id, err := uuid.NewV7()
    if err != nil {
        panic(err)
    }
    fmt.Println(id)
}

import "github.com/google/uuid"

type Event struct {
    ID        uuid.UUID  `gorm:"type:uuid;primaryKey"`
    Name      string
    CreatedAt time.Time
}

func (e *Event) BeforeCreate(tx *gorm.DB) error {
    id, err := uuid.NewV7()
    if err != nil {
        return err
    }
    e.ID = id
    return nil
}

<!-- Maven -->
<dependency>
    <groupId>com.fasterxml.uuid</groupId>
    <artifactId>java-uuid-generator</artifactId>
    <version>5.1.0</version>
</dependency>

import com.fasterxml.uuid.Generators;
import java.util.UUID;

UUID id = Generators.timeBasedEpochGenerator().generate();
System.out.println(id);
// → 01956399-e5c4-7a3b-b7f2-4c9d08e1a2f3

import com.fasterxml.uuid.Generators;
import jakarta.persistence.*;
import java.util.UUID;

@Entity
public class Order {

    @Id
    private UUID id = Generators.timeBasedEpochGenerator().generate();

    private String customerName;
    private double total;
}

// Requires .NET 9+
var id = Guid.CreateVersion7();
Console.WriteLine(id);

// With an explicit timestamp
var id2 = Guid.CreateVersion7(DateTimeOffset.UtcNow);

# Install
dotnet add package UUIDNext

using UUIDNext;

var id = Uuid.NewSequential();  // generates a UUID v7
Console.WriteLine(id);

public class Product
{
    // .NET 9+: time-ordered primary key, no fragmentation
    public Guid Id { get; init; } = Guid.CreateVersion7();
    public string Name { get; set; }
}

# Install
composer require ramsey/uuid

use Ramsey\Uuid\Uuid;

$id = Uuid::uuid7()->toString();
echo $id;
// → 01956399-e5c4-7a3b-b7f2-4c9d08e1a2f3

use Illuminate\Database\Eloquent\Concerns\HasUlids;
use Illuminate\Database\Eloquent\Model;
use Ramsey\Uuid\Uuid;

class Event extends Model
{
    public static function boot(): void
    {
        parent::boot();
        static::creating(function ($model) {
            $model->id = Uuid::uuid7()->toString();
        });
    }
}

# Install
gem install uuidtools

require 'uuidtools'

puts UUIDTools::UUID.uuid_v7

# config/initializers/generators.rb
Rails.application.config.generators do |g|
  g.orm :active_record, primary_key_type: :uuid
end

# app/models/event.rb
class Event < ApplicationRecord
  before_create { self.id = UUIDTools::UUID.uuid_v7.to_s }
end

# Cargo.toml
[dependencies]
uuid = { version = "1", features = ["v7"] }

use uuid::Uuid;

fn main() {
    let id = Uuid::now_v7();
    println!("{}", id);
}

use uuid::Uuid;

#[derive(Insertable)]
#[diesel(table_name = events)]
struct NewEvent {
    id:    Uuid,
    title: String,
}

impl NewEvent {
    fn new(title: String) -> Self {
        NewEvent { id: Uuid::now_v7(), title }
    }
}

# mix.exs dependencies
{:uuid, "~> 2.0"}

UUID = Elixir.UUID

id = UUID.uuid7()
IO.puts(id)

% rebar.config
{deps, [{uuid, "*"}]}

UUID = uuid:uuid7().
io:format("~s~n", [UUID]).

-- Generate a UUID v7 (PostgreSQL 17+)
SELECT uuidv7();

-- Table with UUID v7 default primary key
CREATE TABLE events (
    id         UUID PRIMARY KEY DEFAULT uuidv7(),
    name       TEXT NOT NULL,
    created_at TIMESTAMPTZ DEFAULT now()
);

-- Extract the timestamp from a UUID v7
SELECT to_timestamp(
    (get_byte(id::bytea, 0)::bigint << 40 |
     get_byte(id::bytea, 1)::bigint << 32 |
     get_byte(id::bytea, 2)::bigint << 24 |
     get_byte(id::bytea, 3)::bigint << 16 |
     get_byte(id::bytea, 4)::bigint <<  8 |
     get_byte(id::bytea, 5)::bigint) / 1000.0
) FROM events LIMIT 1;

-- Works on PostgreSQL 13–16
CREATE OR REPLACE FUNCTION uuidv7() RETURNS uuid
LANGUAGE plpgsql AS $$
DECLARE
    v_time    NUMERIC := NULL;
    v_hex     TEXT    := NULL;
BEGIN
    v_time := (EXTRACT(EPOCH FROM clock_timestamp()) * 1000)::BIGINT;
    v_hex  := lpad(to_hex(v_time), 12, '0')
           || '7'
           || lpad(to_hex(floor(random() * 4096)::int), 3, '0')
           || lpad(to_hex(floor(random() * 16384)::int | 32768), 4, '0')
           || lpad(to_hex(floor(random() * 281474976710656)::bigint), 12, '0');
    RETURN (
        substring(v_hex, 1, 8) || '-' ||
        substring(v_hex, 9, 4) || '-' ||
        substring(v_hex, 13, 4) || '-' ||
        substring(v_hex, 17, 4) || '-' ||
        substring(v_hex, 21, 12)
    )::uuid;
END;
$$;

-- Store as BINARY(16) for optimal index performance
CREATE TABLE events (
    id   BINARY(16) PRIMARY KEY,
    name VARCHAR(200)
);

-- Insert from application (Python example)
-- cursor.execute("INSERT INTO events VALUES (%s, %s)",
--     (uuid.uuid7().bytes, "signup"))

CREATE TABLE Events (
    Id    UNIQUEIDENTIFIER PRIMARY KEY DEFAULT NEWSEQUENTIALID(),
    Title NVARCHAR(200)
);
-- Or pass the UUID v7 value directly from your application.