UUID-zu-Ganzzahl-Umrechner
550e8400-e29b-41d4-a716-446655440000 entspricht der 128-Bit-Ganzzahl 113059749145936325402354257176981405696: Fügen Sie eine UUID, eine Dezimalzahl oder einen Hexwert ein und erhalten Sie alle drei Formen derselben Bits samt Version und Variante. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Wert
- 550e8400-e29b-41d4-a716-446655440000
- UUID
- 550e8400-e29b-41d4-a716-446655440000
- Ganzzahl
- 113059749145936325402354257176981405696
- Hex
- 550e8400e29b41d4a716446655440000
- Hexadezimal mit Präfix
- 0x550e8400e29b41d4a716446655440000
Eine UUID ist eine einhundertachtundzwanzig Bit lange Kennung, die üblicherweise als zweiunddreißig hexadezimale Ziffern in den Gruppen 8-4-4-4-12 mit Bindestrichen geschrieben wird. Datenbanken, Warteschlangen und kompakte Indizes speichern dieselben Bits oft als vorzeichenlose Ganzzahl oder als nackte Hex-Zeichenkette; diese Formen per Augenmaß zu vergleichen ist eine häufige Fehlerquelle. Dieser UUID-zu-Ganzzahl-Umrechner akzeptiert eine UUID mit Bindestrichen, eine 128-Bit-Dezimalzahl oder eine hexadezimale Darstellung und liefert alle drei aus demselben Bitmuster. Die Abbildung ist das Big-Endian-Layout nach RFC 4122: die sechzehn Bytes werden aneinandergesetzt und als vorzeichenlose 128-Bit-Ganzzahl gelesen.
Was eine UUID-Ganzzahl ist und wie die Bits liegen
RFC 4122 und ITU-T X.667 definieren eine UUID als genau sechzehn Oktette. In der vertrauten Schreibweise mit Bindestrichen erscheinen diese Oktette als zweiunddreißig Hexadezimalziffern in den Gruppen 8-4-4-4-12. Dieselben sechzehn Bytes als eine vorzeichenlose Ganzzahl in Netzreihenfolge (Big-Endian) zu lesen, ist die UUID-zu-Ganzzahl-Abbildung, die dieser Umrechner und gängige Bibliotheken wie der integer-Konstruktor von uuid.UUID in Python verwenden.
Die ersten acht Hex-Ziffern sind die höchstwertigen zweiunddreißig Bits; die letzten zwölf Hex-Ziffern sind die niederwertigsten achtundvierzig Bits. Das ist nicht das gemischt-endianige GUID-Speicherlayout einiger Microsoft-APIs, bei dem die ersten drei Felder Little-Endian abgelegt werden: dieses Werkzeug vertauscht jene Felder nie, sodass eine Zeichenkette mit Bindestrichen stets dieselbe Ganzzahl liefert, die Sie durch Aneinanderhängen des Hex und Parsen zur Basis sechzehn erhielten. Die Version sitzt im hohen Nibble des siebten Bytes (das Zeichen am Hex-Index zwölf) und die Variante in den hohen Bits des neunten Bytes (Hex-Index sechzehn).
Diese Felder werden gemeldet, damit Sie sehen, ob ein Wert eine RFC-4122-UUID, eine reservierte NCS-Form, eine Microsoft-Variante oder ein anderes reserviertes Muster ist, ohne die Ganzzahl zu ändern. Die Nil-UUID ist die Ganzzahl null. Die maximale UUID, zweiunddreißig f-Zeichen, ist zwei hoch einhundertachtundzwanzig minus eins.
Wo ein UUID-zu-Ganzzahl-Umrechner seinen Nutzen zeigt
Relationale Schemata, die Kennungen als vorzeichenlose 128-Bit-Ganzzahlen oder als BINARY(16) speichern, brauchen einen deterministischen Hin- und Rückweg von der Bindestrichform, die Entwickler aus Protokollen kopieren. Lehrende, die die Kennungsanordnung erklären, können die Bits festhalten und zeigen, wie version und variant im selben 128-Bit-Wort sitzen. Fehlgeschlagene Validierung wird nicht abgerechnet.
Halten Sie Anfragen auf eine einzige Kennung, verankern Sie uuid, integer und hex in Ihren Tests, und Sie erhalten reproduzierbare Umrechnungen für Migrationen, kompakte Speicherung und formatübergreifenden Vergleich, ohne in jedem ausgelieferten Dienst eine UUID-Bibliothek aufzustellen.
Anwendungsfälle
Kompakte Datenbank- und BINARY(16)-Speicherung
Wandeln Sie eine UUID mit Bindestrichen aus Anwendungsprotokollen in die exakte 128-Bit-Ganzzahl oder das 32-stellige Hex, das Ihre Tabelle oder BINARY(16)-Spalte speichert.
Häufige Fragen
Kann ich umgekehrt von Ganzzahl oder Hex zurück zu einer UUID wandeln?
Ja. Übergeben Sie eine Dezimalganzzahl-Zeichenkette oder Hex (optional 0x, höchstens 32 Ziffern). Dasselbe Bitmuster kommt als UUID mit Bindestrichen, Dezimal und Hex zurück.
Ist das das gemischt-endianige GUID-Speicherlayout von Microsoft?
Nein. Die Ganzzahl ist die Big-Endian-Lesung der sechzehn Bytes nach RFC 4122 / ITU-T X.667. Die ersten drei Felder mit Bindestrichen werden nicht byteweise vertauscht.
Welcher Ganzzahl entspricht 550e8400-e29b-41d4-a716-446655440000?
Sie entspricht 113059749145936325402354257176981405696, die kompakte Hexform ist 550e8400e29b41d4a716446655440000. Das Werkzeug meldet außerdem, dass es sich um eine UUID der Version 4 mit der Variante nach RFC 4122 handelt.
Warum wird das Dezimalergebnis als Text statt als Zahl ausgegeben?
Weil JavaScript-Zahlen oberhalb von zwei hoch 53 minus eins ungenau werden, eine UUID aber bis zwei hoch 128 minus eins reicht. Als Text bleibt jede Ziffer exakt, und kein Bit geht verloren.
Was sind der kleinste und der größte mögliche Wert?
Die Nil-UUID aus lauter Nullen ist die Ganzzahl 0. Die größte, 32 Zeichen f, entspricht zwei hoch 128 minus eins. Jede Dezimalzahl, die Sie eingeben, muss zwischen diesen beiden Grenzen liegen.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/dev/uuid-to-integer \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"value":"550e8400-e29b-41d4-a716-446655440000"}'const res = await fetch("https://api.kit.forhosting.com/dev/uuid-to-integer", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"value": "550e8400-e29b-41d4-a716-446655440000"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev/uuid-to-integer",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"value": "550e8400-e29b-41d4-a716-446655440000"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/uuid-to-integer", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"value":"550e8400-e29b-41d4-a716-446655440000"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"value":"550e8400-e29b-41d4-a716-446655440000"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/uuid-to-integer", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"value": "550e8400-e29b-41d4-a716-446655440000"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.uuid_to_integer",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
Was eine UUID-Ganzzahl ist und wie die Bits liegen
Weil JavaScript-Zahlen Ganzzahlen oberhalb von zwei hoch dreiundfünfzig minus eins verlieren, wird die Dezimalform stets als exakte Zeichenkette zurückgegeben; das numerische Feld decimal_number erscheint nur, wenn der Wert eine sichere Ganzzahl ist.
Eingabevertrag, akzeptierte Formate und die Antwortform
Die Eingabe mit Bindestrichen ist unabhängig von Groß- und Kleinschreibung und wird stets in kanonischer Kleinschreibung zurückgegeben. Dezimalganzzahlen dürfen ein führendes Plus tragen und müssen zwischen null und zwei hoch einhundertachtundzwanzig minus eins liegen, Grenzen eingeschlossen. Beispiel: value 550e8400-e29b-41d4-a716-446655440000 ist eine RFC-4122-UUID der Version 4, deren Hex 550e8400e29b41d4a716446655440000 ist. Senden Sie einen JSON-Body mit dem Pflichtfeld value: der Kennung in jeder unterstützten Schreibweise. Das optionale from ist standardmäßig auto und darf uuid, integer oder hex sein, wenn Sie eine Analyse erzwingen müssen. Die automatische Erkennung bevorzugt eine UUID mit Bindestrichen, einschließlich eines optionalen Präfixes urn:uuid: oder umschließender geschweifter Klammern; danach eine 0x-präfixierte Hex-Zeichenkette; dann eine kompakte zweiunddreißigstellige Hex-Zeichenkette (die UUID ohne Bindestriche); anschließend eine Dezimalganzzahl; zuletzt einen kürzeren Hex-Lauf, links auf zweiunddreißig Stellen aufgefüllt. Aliase uuid, text, input und id werden für value akzeptiert, format oder mode für from. JSON-Zahlen werden nur akzeptiert, wenn sie sichere Ganzzahlen sind; breitere 128-Bit-Werte müssen als Zeichenketten eintreffen, damit keine Bits verloren gehen. Fehlendes value, leere Zeichenketten, negative Ganzzahlen, mehr als zweiunddreißig Hex-Ziffern und Text, der keiner der drei Formen entspricht, scheitern mit invalid_input unter Nennung des Problems; diese Fehler werden nicht abgerechnet. Bei Erfolg enthält der Body uuid (kanonische Kleinschreibung mit Bindestrichen), integer (exakte Dezimalzeichenkette), hex (zweiunddreißig Kleinbuchstaben-Ziffern), hex_prefixed (dieselben Ziffern mit 0x-Präfix), input_format (uuid, integer oder hex), version (0–15), variant (ncs, rfc4122, microsoft oder reserved) und bit_width 128.
Wo ein UUID-zu-Ganzzahl-Umrechner seinen Nutzen zeigt
Nachrichtenbusse und Warehouse-Schlüssel vergleichen oft eine kompakte Hex-Spalte mit einer UUID mit Bindestrichen einer vorgelagerten API; beide in dieselbe Ganzzahl (oder dasselbe zweiunddreißigstellige Hex) zu wandeln, vermeidet Scheinabweichungen durch Großschreibung, Klammern oder ein Präfix urn:uuid:. Weil die Implementierung reines Parse der Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Grundpreis $0.002 ohne Modell-Tokens und ohne ausgehendes Netz.
Integrationsbeispiele
Kennungsvergleich über Formate hinweg
Normieren Sie UUIDs mit Bindestrichen, 0x-Hex-Literale und Dezimalschlüssel auf eine Ganzzahl, damit Warehouse-Joins und API-Diffs nicht an der Schreibweise scheitern.
Fixtures und mehrsprachige Testorakel
Erzeugen Sie ein kanonisches Tripel uuid / integer / hex und prüfen Sie, dass jede Clientbibliothek dieselben RFC-4122-Big-Endian-Bits kodiert.
Technische Fragen
Wie wandle ich eine UUID in eine 128-Bit-Ganzzahl um?
Senden Sie value als UUID mit Bindestrichen (optional urn:uuid: oder Klammern). Die API liefert integer als exakte Dezimalzeichenkette sowie Hex und die kanonische Kleinbuchstaben-UUID.
Warum ist die Ganzzahl eine Zeichenkette statt einer JSON-Zahl?
Die meisten UUIDs überschreiten den sicheren Ganzzahlbereich von JavaScript (2^53−1). Die Dezimalzeichenkette ist stets exakt. decimal_number erscheint nur, wenn der Wert eine sichere Ganzzahl ist.
Was kostet der UUID-zu-Ganzzahl-Umrechner?
Das Browser-Werkzeug ist kostenlos. API-Anfragen nutzen das vorausbezahlte KIT-Guthaben zu $0.002 je erfolgreichem Aufruf; ungültige Eingabe wird nicht abgerechnet.