Gibt ein neues `Datatype.DateTime` zurück, das den aktuellen Moment in
der Zeit darstellt, unter Verwendung der lokalen Uhr des Geräts. Die meisten Betriebssysteme synchronisieren automatisch
ihre lokale Zeit mit Online-Zeitservern, sodass dies innerhalb von ein paar Hundert Millisekunden sein sollte. Benutzer können jedoch problemlos das
Synchronisationsverhalten deaktivieren und die Systemzeit auf beliebige Werte setzen; für
synchronisierte Zeit zwischen Client und Server verwenden Sie
`Class.Workspace:GetServerTimeNow()` stattdessen.

Wenn Sie die vergangene Zeit zwischen zwei Zeitpunkten genau messen müssen,
wie beim Testen der Leistung, verwenden Sie stattdessen `Library.os.clock()`.

DateTime.now

Gibt ein `Datatype.DateTime` zurück, das den aktuellen Moment in der Zeit darstellt.

Gibt ein neues `Datatype.DateTime` Objekt aus dem angegebenen Unix-Zeitstempel zurück, oder
die Anzahl der **Sekunden** seit dem 1. Januar 1970 um 00:00 (UTC).

Diese Funktion hat nur eine Granularität von 1 Sekunde. Um Unter-Sekunden-Zeitstempel darzustellen, verwenden Sie stattdessen `Datatype.DateTime.fromUnixTimestampMillis()`.

DateTime.fromUnixTimestamp

unixTimestamp

Gibt ein `Datatype.DateTime` zurück, das den angegebenen Unix-Zeitstempel darstellt.

Gibt ein neues `Datatype.DateTime` Objekt aus dem angegebenen Unix-Zeitstempel zurück, oder
die Anzahl der **Millisekunden** seit dem 1. Januar 1970 um 00:00 (UTC).

DateTime.fromUnixTimestampMillis

unixTimestampMillis

Gibt ein `Datatype.DateTime` zurück, das den angegebenen Unix-Zeitstempel in Millisekunden darstellt.

Gibt ein neues `Datatype.DateTime` zurück, das die angegebenen Einheiten von einer UTC-Zeit verwendet. Die Werte,
 die akzeptiert werden, sind ähnlich wie die in der Zeitwerttabelle, die von
`Datatype.DateTime:ToUniversalTime()|ToUniversalTime()` zurückgegeben wird.

- Datumseinheiten (Jahr, Monat, Tag), die ein ungültiges Datum erzeugen, führen zu einem Fehler. Zum Beispiel der 32. Januar oder der 29. Februar in einem Nicht-Schaltjahr.
- Zeiteinheiten (Stunde, Minute, Sekunde, Millisekunde), die außerhalb ihres normalen Bereichs sind, sind gültig. Zum Beispiel führt 90 Minuten dazu, dass die Stunde um 1 hochgezählt wird; -10 Sekunden bewirken, dass der Minutenwert um 1 zurückgezählt wird.
- Nicht-ganzzahlige Werte werden abgerundet. Beispielsweise ist 2,5 Stunden gleich 2 Stunden und nicht 2 Stunden 30 Minuten.
- Weggelassene Werte werden als ihr minimaler Wert im normalen Bereich angenommen, mit Ausnahme des Jahres, das standardmäßig auf 1970 gesetzt wird.

DateTime.fromUniversalTime

year

month

hour

minute

second

millisecond

Gibt ein neues `Datatype.DateTime` zurück, das die angegebenen Einheiten von einer UTC-Zeit verwendet.

Gibt ein neues `Datatype.DateTime` zurück, das die angegebenen Einheiten von einer lokalen Zeit verwendet. Die
akzeptierten Werte sind ähnlich wie die in der Zeitwerttabelle
, die von `Datatype.DateTime:ToLocalTime()|ToLocalTime()` zurückgegeben wird.

- Datumseinheiten (Jahr, Monat, Tag), die ein ungültiges Datum erzeugen, führen zu einem Fehler. Zum Beispiel der 32. Januar oder der 29. Februar in einem Nicht-Schaltjahr.
- Zeiteinheiten (Stunde, Minute, Sekunde, Millisekunde), die außerhalb ihres normalen Bereichs sind, sind gültig. Zum Beispiel führt 90 Minuten dazu, dass die Stunde um 1 hochgezählt wird; -10 Sekunden bewirken, dass der Minutenwert um 1 zurückgezählt wird.
- Nicht-ganzzahlige Werte werden abgerundet. Beispielsweise ist 2,5 Stunden gleich 2 Stunden und nicht 2 Stunden 30 Minuten.
- Weggelassene Werte werden als ihr minimaler Wert im normalen Bereich angenommen, mit Ausnahme des Jahres, das standardmäßig auf 1970 gesetzt wird.

DateTime.fromLocalTime

Gibt ein neues `Datatype.DateTime` zurück, das die angegebenen Einheiten von einer lokalen Zeit verwendet.

Gibt ein `Datatype.DateTime` aus einem ISO 8601 Datum-Zeit-String in UTC
 zurück, wie sie von `Datatype.DateTime:ToIsoDate()|ToIsoDate()` zurückgegeben werden. Wenn das Parsen des Strings fehlschlägt,
 gibt die Funktion `nil` zurück.

Ein Beispiel für einen ISO 8601 Datum-Zeit-String wäre `2020-01-02T10:30:45Z`,
was den 2. Januar 2020 um 10:30 Uhr, 45 Sekunden darstellt.

DateTime.fromIsoDate

isoDate

Gibt ein `Datatype.DateTime` aus einem ISO 8601 Datum-Zeit-String (in UTC) zurück.

Der **DateTime** Datentyp stellt einen Moment in der Zeit mit einem Unix-Zeitstempel dar.
Er kann verwendet werden, um Daten und Zeiten in bestimmten Regionen leicht zu formatieren. Wenn
in einen String umgewandelt, wird die String-Konvertierung des gespeicherten Zeitstempel-Integer zurückgegeben. Sie speichern keine Zeitzonenwerte. Stattdessen werden Zeitzonen
bei der Erstellung und Verwendung von **DateTime** Objekten berücksichtigt.

**DateTime** Objekte sind nur dann gleich, wenn ihre
`Datatype.DateTime.UnixTimestampMillis|UnixTimestampMillis` Eigenschaften gleich sind.

#### Zeitwerttabelle

Die Methoden `Datatype.DateTime:ToUniversalTime()|ToUniversalTime()` und
`Datatype.DateTime:ToLocalTime()|ToLocalTime()` geben eine Tabelle von
zeitbezogenen Werten zurück, wie `Jahr`, `Monat` und `Tag`. Das Format der
von diesen Funktionen zurückgegebenen Tabelle wird unten beschrieben, mit jedem Integer-Element in absteigender Größe.

<table>
<thead>
  <tr>
    <td>Name</td>
    <td>Bereich</td>
    <td>Hinweise</td>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>Jahr</code></td><td>1400&ndash;9999</td><td>&mdash;</td>
</tr>
<tr>
  <td><code>Monat</code></td><td>1&ndash;12</td><td >&mdash;</td>
</tr>
<tr>
  <td><code>Tag</code></td><td>1&ndash;31</td><td >&mdash;</td>
</tr>
<tr>
  <td><code>Stunde</code></td><td>0&ndash;23</td><td >&mdash;</td>
</tr>
<tr>
  <td><code>Minute</code></td><td>0&ndash;59</td><td >&mdash;</td>
</tr>
<tr>
  <td><code>Sekunde</code></td><td>0&ndash;60</td><td>Normalerweise
  0&ndash;59, manchmal 60 zur Berücksichtigung von Schalttagen in bestimmten
  Systemen.</td>
</tr> <tr>
  <td><code>Millisekunde</code></td><td>0&ndash;999</td><td >&mdash;</td>
</tr>
</tbody>
</table>

#### String-Format

Das `Datatype.DateTime` Objekt unterstützt die Umwandlung von Datum/Zeit in einen String
über die Methoden `Datatype.DateTime:FormatUniversalTime()|FormatUniversalTime()`
und `Datatype.DateTime:FormatLocalTime()|FormatLocalTime()`. Beide
funktionieren gleich, außer für die Zeitzone, in der `Datatype.DateTime` interpretiert werden sollte.

Das erste Argument, das an diese Methoden übergeben wird, muss ein String sein, der einen
der unten gezeigten Tokens darstellt. Die Tokens werden dann durch einen spezifischen Wert
ersetzt, abhängig von der bereitgestellten Region.

```lua
local dt = DateTime.now()

-- Der "dddd" Token wird mit dem vollständigen Wochentag ersetzt
print("Heute ist " .. dt:FormatLocalTime("dddd", "en-us"))

-- Für die "en-us" Region ist der "LL" Token gleich "MMMM D, YYYY"
print("Das Datum ist " .. dt:FormatLocalTime("LL", "en-us"))
```

##### Zusammengesetzte Tokens

Abhängig von der Region ersetzen diese Tokens **spezifische Kombinationen** der
**elementaren Tokens**, die in der nächsten Sektion beschrieben werden. Dies erzeugt einen korrekten
Datum/Zeit-String abhängig von der Region. Zum Beispiel hat das Datum auf Englisch
"[monat]&nbsp;[tag]" wie in "Juni&nbsp;11". Auf Französisch hat das Datum das Format
"[tag]&nbsp;[monat]" wie in "11&nbsp;juin". Diese speziellen Regeln werden für Sie
automatisch durch die folgenden zusammengesetzten Tokens behandelt, verwenden Sie
sie, wenn Sie einfache Zeit- und/oder Datumsinformationen anzeigen.

<table>
  <thead>
    <tr>
      <th>Token(s)</th>
      <th>Regionale Beispiele (Format)</th>
    </tr>
  </thead>
    <thead>
    <tr>
      <th colspan=2>Zeit</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LT</code></td>
      <td>
        <div><code>en-us</code> : <code>8:30 PM</code> (<code>h:mm A</code>)</div>
        <div><code>zh-cn</code> : <code>20:30</code> (<code>HH:mm</code>)</div>
      </td>
    </tr>
  </tbody>
    <thead>
    <tr>
      <th colspan=2>Zeit mit Sekunden</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LTS</code></td>
      <td>
        <div><code>en-us</code> : <code>8:30:25 PM</code> (<code>h:mm:ss A</code>)</div>
        <div><code>zh-cn</code> : <code>20:30:25</code> (<code>HH:mm:ss</code>)</div>
      </td>
    </tr>
  </tbody>
    <thead>
    <tr>
      <th colspan=2>Monat (Nummer), Tag, Jahr</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>L</code></td>
      <td>
        <div><code>en-us</code> : <code>09/04/1986</code> (<code>MM/DD/YYYY</code>)</div>
        <div><code>zh-cn</code> : <code>1986/09/04</code> (<code>YYYY/MM/DD</code>)</div>
      </td>
    </tr>
    <tr>
      <td><code>l</code></td>
      <td>
        <div><code>en-us</code> : <code>9/4/1986</code> (<code>M/D/YYYY</code>)</div>
        <div><code>zh-cn</code> : <code>1986/9/4</code> (<code>YYYY/M/D</code>)</div>
      </td>
    </tr>
  </tbody>
    <thead>
    <tr>
      <th colspan=2>Monat (Name), Tag, Jahr</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LL</code></td>
      <td>
        <div><code>en-us</code> : <code>September 4, 1986</code> (<code>MMMM D, YYYY</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日</code> (<code>YYYY年M月D日</code>)</div>
      </td>
    </tr>
    <tr>
      <td><code>ll</code></td>
      <td>
        <div><code>en-us</code> : <code>Sep 4, 1986</code> (<code>MMM D, YYYY</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日</code> (<code>YYYY年M月D日</code>)</div>
      </td>
    </tr>
  </tbody>
    <thead>
    <tr>
      <th colspan=2>Monat (Name), Tag, Jahr, Zeit</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LLL</code></td>
      <td>
        <div><code>en-us</code> : <code>September 4, 1986 8:30 PM</code> (<code>MMMM D, YYYY h:mm A</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日晚上8点30分</code> (<code>YYYY年M月D日Ah点mm分</code>)</div>
      </td>
    </tr>
    <tr>
      <td><code>lll</code></td>
      <td>
        <div><code>en-us</code> : <code>Sep 4, 1986 8:30 PM</code> (<code>MMM D, YYYY h:mm A</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日 20:30</code> (<code>YYYY年M月D日 HH:mm</code>)</div>
      </td>
    </tr>
  </tbody>
    <thead>
    <tr>
      <th colspan=2>Wochentag, Monat (Name), Tag, Jahr, Zeit</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LLLL</code></td>
      <td>
        <div><code>en-us</code> : <code>Thursday, September 4, 1986 8:30 PM</code> (<code>dddd, MMMM D, YYYY h:mm A</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日星期四晚上8点30分</code> (<code>YYYY年M月D日ddddAh点mm分</code>)</div>
      </td>
    </tr>
    <tr>
      <td><code>llll</code></td>
      <td>
        <div><code>en-us</code> : <code>Thu, Sep 4, 1986 8:30 PM</code> (<code>ddd, MMM D, YYYY h:mm A</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日星期四 20:30</code> (<code>YYYY年M月D日dddd HH:mm</code>)</div>
      </td>
    </tr>
  </tbody>
</table>

##### Elementare Tokens

Jeder dieser Tokens ersetzt einen **einzelnen Wert** und kann als Elemente
eines größeren Zeitstrings verwendet werden. Vermeiden Sie die Verwendung dieser, wenn Sie nur einfache Datum- und
Zeitinformationen benötigen, da die **zusammengesetzten Tokens** für diese Zwecke geeigneter sind.

<table>
<thead>
  <tr>
    <th>Token(s)</th>
    <th>Beispiele</th>
  </tr>
</thead>
  <thead>
  <tr>
    <th colspan=2>Jahr</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>YY</code></td>
  <td><code>70</code>, <code>71</code>, &hellip;, <code>29</code>, <code>30</code></td>
</tr>
<tr>
  <td><code>YYYY</code></td>
  <td><code>1970</code>, <code>1971</code>, &hellip;, <code>2029</code>, <code>2030</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Monat</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>M</code></td>
  <td><code>1</code>, <code>2</code>, &hellip;, <code>11</code>, <code>12</code></td>
</tr>
<tr>
  <td><code>MM</code></td>
  <td><code>01</code>, <code>02</code>, &hellip;, <code>11</code>, <code>12</code></td>
</tr>
<tr>
  <td><code>MMM</code></td>
  <td><code>Jan</code>, <code>Feb</code>, &hellip;, <code>Nov</code>, <code>Dez</code></td>
</tr>
<tr>
  <td><code>MMMM</code></td>
  <td><code>Januar</code>, <code>Februar</code>, &hellip;, <code>November</code>, <code>Dezember</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Tag des Monats</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>D</code></td>
  <td><code>1</code>, <code>2</code>, &hellip;, <code>30</code>, <code>31</code></td>
</tr>
<tr>
  <td><code>DD</code></td>
  <td><code>01</code>, <code>02</code>, &hellip;, <code>30</code>, <code>31</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Tag des Jahres</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>DDD</code></td>
  <td><code>1</code>, <code>2</code>, &hellip;, <code>364</code>, <code>365</code></td>
</tr>
<tr>
  <td><code>DDDD</code></td>
  <td><code>001</code>, <code>002</code>, &hellip;, <code>364</code>, <code>365</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Wochentag</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>d</code></td>
  <td><code>0</code>, <code>1</code>, &hellip;, <code>5</code>, <code>6</code></td>
</tr>
<tr>
  <td><code>dd</code></td>
  <td><code>So</code>, <code>Mo</code>, &hellip;, <code>Fr</code>, <code>Sa</code></td>
</tr>
<tr>
  <td><code>ddd</code></td>
  <td><code>So</code>, <code>Mo</code>, &hellip;, <code>Fr</code>, <code>Sa</code></td>
</tr>
<tr>
  <td><code>dddd</code></td>
  <td><code>Sonntag</code>, <code>Montag</code>, &hellip;, <code>Freitag</code>, <code>Samstag</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Stunde</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>H</code></td>
  <td><code>0</code>, <code>1</code>, &hellip;, <code>22</code>, <code>23</code></td>
</tr>
<tr>
  <td><code>HH</code></td>
  <td><code>00</code>, <code>01</code>, &hellip;, <code>22</code>, <code>23</code></td>
</tr>
<tr>
  <td><code>h</code></td>
  <td><code>1</code>, <code>2</code>, &hellip;, <code>11</code>, <code>12</code></td>
</tr>
<tr>
  <td><code>hh</code></td>
  <td><code>01</code>, <code>02</code>, &hellip;, <code>11</code>, <code>12</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Minute</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>m</code></td>
  <td><code>0</code>, <code>1</code>, &hellip;, <code>58</code>, <code>59</code></td>
</tr>
<tr>
  <td><code>mm</code></td>
  <td><code>00</code>, <code>01</code>, &hellip;, <code>58</code>, <code>59</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Sekunde</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>s</code></td>
  <td><code>0</code>, <code>1</code>, &hellip;, <code>58</code>, <code>59</code></td>
</tr>
<tr>
  <td><code>ss</code></td>
  <td><code>00</code>, <code>01</code>, &hellip;, <code>58</code>, <code>59</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Bruchteil einer Sekunde</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>S</code></td>
  <td><code>0</code>, <code>1</code>, &hellip;, <code>8</code>, <code>9</code></td>
</tr>
<tr>
  <td><code>SS</code></td>
  <td><code>00</code>, <code>01</code>, &hellip;, <code>98</code>, <code>99</code></td>
</tr>
<tr>
  <td><code>SSS</code></td>
  <td><code>000</code>, <code>001</code>, &hellip;, <code>998</code>, <code>999</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>AM/PM</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>A</code></td>
  <td><div><code>en-us</code> : <code>AM</code>, <code>PM</code></div>
        <div><code>zh-cn</code> : <code>凌晨|早上|上午|中午|下午|晚上</code></div></td>
</tr>
<tr>
  <td><code>a</code></td>
  <td><div><code>en-us</code> : <code>am</code>, <code>pm</code></div>
        <div><code>zh-cn</code> : <code>凌晨|早上|上午|中午|下午|晚上</code></div></td>
</tr>
</tbody>
</table>


Konvertiert den Wert dieses `Datatype.DateTime` Objekts in die Universelle
Koordinierte Zeit (UTC). Die zurückgegebene Tabelle enthält die folgenden Schlüssel:
`Jahr`, `Monat`, `Tag`, `Stunde`, `Minute`, `Sekunde`, `Millisekunde`. Für
weitere Details siehe die Zeitwerttabelle in der Beschreibung dieses Datentyps.
Die Werte innerhalb dieser Tabelle können an
`Datatype.DateTime.fromUniversalTime()|fromUniversalTime()` übergeben werden, um das
ursprüngliche `Datatype.DateTime` Objekt zu erzeugen.


DateTime:ToUniversalTime

Gibt die Komponenten des `Datatype.DateTime` in UTC zurück.


Konvertiert den Wert dieses `Datatype.DateTime` Objekts in die lokale Zeit. Die
zurückgegebene Tabelle enthält die folgenden Schlüssel: `Jahr`, `Monat`, `Tag`,
`Stunde`, `Minute`, `Sekunde`, `Millisekunde`. Für weitere Details siehe die Zeit
werttabelle in der Beschreibung dieses Datentyps. Die Werte innerhalb dieser Tabelle
können an `Datatype.DateTime.fromLocalTime()|fromLocalTime()` übergeben werden, um
 das ursprüngliche `Datatype.DateTime` Objekt zu erzeugen.


DateTime:ToLocalTime

Gibt die Komponenten des `Datatype.DateTime` in lokaler Zeit zurück.


Formatiert ein Datum als ISO 8601 Datum-Zeit-String. Der von dieser Funktion zurückgegebene Wert könnte an
`Datatype.DateTime.fromIsoDate()|fromIsoDate()` übergeben werden, um das ursprüngliche
`Datatype.DateTime` Objekt zu erzeugen.

Ein Beispiel für einen ISO 8601 Datum-Zeit-String wäre `2020-01-02T10:30:45Z`,
was den 2. Januar 2020 um 10:30 Uhr, 45 Sekunden darstellt.


DateTime:ToIsoDate

Gibt den `Datatype.DateTime` als ISO 8601 Datum-Zeit-String zurück.


Generiert einen String aus dem `Datatype.DateTime` Wert, der als
Universelle Koordinierte Zeit (UTC) interpretiert wird, sowie einem Format-String. Der Format-String
sollte Tokens enthalten, die bestimmten Datum/Zeitwerten entsprechen,
die im `Datatype.DateTime` Objekt beschrieben sind. Für weitere Details siehe die
**String-Format** Sektion in der Beschreibung dieses Datentyps.

```lua
local dt = DateTime.now()
-- Für en-us ist der "LL" Token gleich "MMM D, YYYY", was "Juni 11, 2020" gibt
print("Das Datum ist " .. dt:FormatUniversalTime("LL", "en-us"))
--> "Das Datum ist Juni 11, 2020"
```


DateTime:FormatUniversalTime

format

locale

Gibt den Wert des DateTime in UTC in einen String formatiert zurück.


Generiert einen String aus dem `Datatype.DateTime` Wert, der als
**lokale Zeit** interpretiert wird, sowie einem Format-String. Der Format-String sollte Tokens enthalten,
 welche bestimmten Datum/Zeitwerten entsprechen, die im `Datatype.DateTime` Objekt beschrieben sind. Für weitere Details siehe die **String-Format**
Sektion in der Beschreibung dieses Datentyps.

```lua
local dt = DateTime.now()
-- Für en-us ist der "LL" Token gleich "MMM D, YYYY", was "Juni 11, 2020" gibt
print("Das Datum ist " .. dt:FormatLocalTime("LL", "en-us"))
--> "Das Datum ist Juni 11, 2020"
```


DateTime:FormatLocalTime

Gibt den Wert des `Datatype.DateTime` Objekts in lokaler Zeit in einen String formatiert zurück.


DateTime

Die Anzahl der **Sekunden** seit dem 1. Januar 1970 um 00:00 UTC (der Unix-
epoch). Der Bereich ist -17.987.443.200 bis 253.402.300.799, etwa Jahre
1400&ndash;9999.


DateTime.UnixTimestamp

Die Anzahl der **Sekunden** zwischen dem 1. Januar 1970 um 00:00 UTC (der Unix-
epoch).


Die Anzahl der **Millisekunden** seit dem 1. Januar 1970 um 00:00 UTC (der
Unix epoch). Der Bereich ist -17.987.443.200.000 bis 253.402.300.799.999,
approximately Jahre 1400&ndash;9999.


DateTime.UnixTimestampMillis

Die Anzahl der **Millisekunden** zwischen dem 1. Januar 1970 um 00:00 UTC (der
Unix epoch).


Ein Datentyp, der einen Moment in der Zeit darstellt.


/reference/engine/datatypes/DateTime.yaml

Luau

Dictionary

Ein Objekt, das verbundene Funktionen bei einem bestimmten Ereignis ausführt.

Data Type

RBXScriptSignal

Eine Gleitkommazahl mit doppelter Präzision.

number

Eine Folge von Zeichen wie Buchstaben, Zahlen und Symbolen.

string

Experiences

Avatar

Objekte

Beispiele und Projekte

Engine-API

Open-Cloud-API

Studio

Analytics

Plattform

Tutorials

Creator-Programme

Bildung

Kurse

Lernen

Diese Methode ist asynchron und gibt eine `Operation` zurück, die den aktuellen Status der Operation darstellt. Sie enthält einen Endpunktpfad, den du abfragen kannst, um die tatsächliche Antwort und die entsprechenden Metadaten zu erhalten. Weitere Informationen findest du in der [Dokumentation]({longRunningOperationsLink}).

Die folgenden Abschnitte beschreiben die Antwort- und Metadatenobjekte, die bereitgestellt werden, wenn eine Operation abgeschlossen ist.

Beta-Endpunkte sind bereit für die öffentliche Nutzung. Bahnbrechende Änderungen sind möglich, aber selten.

Diese Open-Cloud-Dokumentationsseiten werden am 31. März 2026 entfernt. Du wirst zu diesem Zeitpunkt automatisch zur neuen Open-Cloud-Dokumentation weitergeleitet. {linkStart}Mehr erfahren{linkEnd}

Diese alten Open-Cloud-Seiten werden am 31. März 2026 entfernt und umgeleitet. {linkStart}Mehr erfahren{linkEnd}

Experimentelle Endpunkte sind für die öffentliche Nutzung bereit, können jedoch gelegentlich Änderungen unterliegen, wenn der API-Vertrag abgeschlossen ist.

Dieser Endpunkt kann innerhalb der Experience über {httpServiceLinkStart}HTTPService{httpServiceLinkEnd} mit einem API-Schlüssel aufgerufen werden.

Dieses Feld kann beim Erstellen einer Ressource festgelegt werden, kann jedoch durch spätere Anfragen nicht geändert werden.

Diese Felder können beim Erstellen einer Ressource festgelegt werden, kann jedoch durch spätere Anfragen nicht geändert werden.

Dieses Feld kann in Anfragen zur Verfügung gestellt werden, wird aber niemals in Antworten enthalten sein.

Legacy-Authentifizierungsmethode. Verwende immer den API-Schlüssel oder OAuth 2.0, wenn verfügbar.

Pro API-Schlüssel: {maxInPeriod} Anfoderungen pro {periodInSeconds} Sekunden pro IP-Adresse

Erfordert keine Authentifizierung zum Aufrufen. Hat in der Regel deutlich niedrigere Ratenbegrenzungen. Verwende immer den API-Schlüssel oder OAuth 2.0, wenn verfügbar.

Für jede Gruppierung muss nur eines der folgenden Felder im Schema angegeben werden, die übrigen können ausgeschlossen werden.

Du kannst dich jederzeit wieder anmelden. {linkStart}Feedback geben.{linkEnd}

Du siehst gerade die alten Dokumente an. {linkStart}Feedback geben.{linkEnd}

Du kannst dich jederzeit wieder abmelden und wirst dann zu den alten Referenzseiten weitergeleitet. {linkStart}Gib uns Feedback.{linkEnd}

Du siehst gerade die überarbeiteten Dokumente an. {linkStart}Feedback geben.{linkEnd}

Dieses Feld kann in Antworten zur Verfügung gestellt werden, wird aber bei Anfragen ignoriert.

Hinweis: In Zeiten mit viel Datenverkehr können die Ratenbegrenzungen niedriger sein. Für bestimmte Endpunkte gelten zusätzliche Ratenbegrenzungen. [Erfahre mehr über Ratenbegrenzungen]({link}).

{limit} Anfragen pro Tag über alle API-Schlüssel hinweg für einen Benutzer oder eine Gruppe

{limit} Anfragen pro Stunde über alle API-Schlüssel hinweg für einen Benutzer oder eine Gruppe

{limit} Anfragen pro Minute über alle API-Schlüssel hinweg für einen Benutzer oder eine Gruppe

{limit} Anfragen pro Sekunde über alle API-Schlüssel hinweg für einen Benutzer oder eine Gruppe

{limit} Anfragen pro Minute pro API-Schlüsselbesitzer

{limit} Anfragen pro Tag pro App-Benutzer

{limit} Anfragen pro Stunde pro App-Benutzer

{limit} Anfragen pro Minute pro App-Benutzer

{limit} Anfragen pro Sekunde pro App-Benutzer

{limit} Anfrage(n) pro Sekunde pro API-Schlüsselbesitzer

Mit Bereichen wird festgelegt, welche Berechtigungen du mit deinen Anmeldeinformationen hast. Über deine Anmeldeinformationen kannst du nur auf die Endpunkte zugreifen, die von den ausgewählten Bereichen unterstützt werden.

Stabile Endpunkte sind produktionsbereit und unterliegen während ihrer Lebensdauer fast nie Änderungen.

Mit diesem Ziel kannst du den Zugriff deines Schlüssels auf ausgewählte {requiredParts} festlegen.

Mit diesem Ziel kannst du den Zugriff deines Schlüssels auf ausgewählte {requiredParts} und {optionalParts} festlegen.

Mit Zielarten kannst du die Ressourcen einschränken, für die deine Anmeldeinformationen verwendet werden können. Auch wenn dein Konto über Berechtigungen für weitere Ressourcen verfügt, kannst du nur auf die ausgewählten Ressourcen zugreifen. Einige Bereiche haben keine Zielelemente. In diesen Fällen kannst du auf alle relevanten Ressourcen zugreifen.

Das universale Top-Level-Teil muss nicht für benutzerdefinierte API-Schlüssel ausgewählt werden. In diesem Fall hat dein API-Schlüssel Zugriff auf alle deine benutzerdefinierten Experiences und gruppenbasierten Experiences, für die du die richtigen Gruppenberechtigungen hast.

Probier’s aus wird noch nicht für Endpunkte unterstützt, die einen API-Schlüssel oder eine OAuth 2.0-Authentifizierung erfordern

Die Cookie-Authentifizierung ist aus Sicherheitsgründen für Vorgänge mit hohem Risiko deaktiviert.

Kritische Risiko-Endpunkte sind extrem sensibel und „Probier’s aus“ ist aus Sicherheitsgründen deaktiviert.

Hinweis: Authentifizierungs-Header sind in diesem Codebeispiel nicht enthalten. Möglicherweise musst du einen Authentifizierungs-Header hinzufügen, damit dieser Befehl funktioniert.

Dies ist ein Endpunkt mit hohem Risiko, der kritische Daten ändern oder löschen kann. Sei beim Testen äußerst vorsichtig.

Dieser API-Endpunkt wurde als HOCHRISIKO eingestuft und kann Live-Daten oder Benutzerkonten beeinträchtigen.

Authentifizierte Anfragen an risikoreiche APIs können Änderungen vornehmen, die nicht rückgängig gemacht werden können. Bitte überprüfe deine Anfrageparameter sorgfältig, bevor du fortfährst.

Bitte melde dich an, um die Cookie-Authentifizierung zu verwenden

Dies ist ein Endpunkt mit geringem Risiko, der Daten abruft. Dies ist im Allgemeinen sicher zu testen.

Dies ist ein Endpunkt mit mittlerem Risiko, der Daten ändert. Teste ihn sorgfältig mit nicht kritischen Konten, da Änderungen dauerhaft sein können.

Um dein Konto zu schützen, solltest du hier niemals Text aus anderen Quellen einfügen oder Informationen von dieser Seite an andere senden.

Du bist im Begriff, Live-API-Endpunkte mit deinen tatsächlichen Kontoanmeldeinformationen zu testen.

Fahre nur fort, wenn du die Auswirkungen der API-Aufrufe, die du durchführen möchtest, verstehst. Lies die API-Dokumentation sorgfältig durch, bevor du sie testest.

API-Aufrufe werden über deine authentifizierte Sitzung durchgeführt.

Dies sind echte API-Aufrufe, die sich auf dein Konto oder deine Daten auswirken können.

Es gelten Ratenbegrenzungen und andere API-Einschränkungen.

Bei einigen Vorgängen können Daten geändert oder gelöscht werden.

Dieser Endpunkt wurde durch diese empfohlenen alternativen Endpunkte ersetzt:

Die folgenden Bereiche sind erforderlich, um diesen Endpunkt aufzurufen. Weitere
Informationen zum Generieren der richtigen Schlüssel findest du unter [API-Schlüssel verwalten]({apiKeyReferenceDocLink}).

Weitere Informationen zum Generieren von Schlüsseln findest du unter [API-Schlüssel verwalten]({apiKeyReferenceDocLink}).

Die folgenden Endpunkte sind bei Pfaden relativ zur Basis-URL verfügbar.

Dieser String ist als [FieldMask](/cloud/reference/types#fieldmask) formatiert.

Ein JSON-Wert kann `null`, `boolean`, `string`, `number`, `array` oder `object` sein.

Um diesen Endpunkt nutzen zu können, werden folgende Anwendungsbereiche für deine OAuth 2.0 App benötigt. Weitere Informationen zur Registrierung einer OAuth 2.0-App findest du unter [App Registration and Review]({oauth2ReferenceDocLink}).

Weitere Informationen zur Registrierung einer OAuth 2.0-Anwendung findest du unter [App-Registrierung und Überprüfung]({oauth2ReferenceDocLink}).

Die folgenden Objekte beschreiben Nutzlasten, die akzeptiert oder zurückgegeben werden. Die einzelnen Endpunkte zeigen weitere Informationen darüber an, wann diese Objekte verwendet werden.

Die folgenden Bereiche sind erforderlich, um diesen Endpunkt aufzurufen.

Ressourcen-Pfade

Dieser String ist als [Zeitstempel](/cloud/reference/types#timestamp) formatiert.

Nicht empfohlen

Dir wird die überarbeitete Open-Cloud-Referenz angezeigt.

Du hast dich von der neuen Open-Cloud-Referenz abgemeldet.

Sieh dir deine Werbe-Abrechnungskonten an.

Sieh dir deine Werbekampagnen und deren Leistung an.

Erstelle, aktualisiere und verwalte deine Werbekampagnen.

Dies ermöglicht das Anzeigen von Informationen über deine Objekte.

Dies ermöglicht das Hochladen und Aktualisieren von Objekten auf Roblox.

Damit kannst du Objektberechtigungen für Subjekte (einschließlich Gruppen und Experiences) sowie für Objekte anzeigen, auf die dein Konto Zugriff hat.

Damit kannst du Objektberechtigungen an beliebige Subjekte (einschließlich Gruppen und Experiences) sowie an Objekte vergeben, auf die dein Konto Zugriff hat.

Damit kannst du den Status und die Ergebnisse von Jobs zur automatischen Avatareinrichtung in deinem Namen anzeigen.

Damit kannst du Jobs zur automatischen Avatareinrichtung in deinem Namen erstellen und verwalten.

Bietet die Möglichkeit, die Abzeichen des Nutzers zu aktualisieren.

Dies ermöglicht das Anzeigen von Informationen über deine Handelsartikel.

So kannst du Änderungen an deinen synchronisierten Handelsartikeln vornehmen.

Damit kannst du Informationen zu deinen Händlerverbindungen anzeigen.

Dies ermöglicht das Bearbeiten deiner Kommerzhändlerverbindungen.

Hiermit kannst du Informationen zu deinen Creator-Store-Produkten ansehen.

Hiermit kannst du Informationen zu deinen Creator-Store-Produkten ändern.

Damit kannst du Informationen über deine Creator-Store-Speichervorgänge anzeigen.

Damit kannst du Informationen zu deinen Creator-Store-Speichervorgängen ändern.

Dies gewährt Zugriff zum Erstellen von Datenspeichern in deinem Namen.

Dies gewährt Zugriff zum Löschen von Datenspeichern in deinem Namen.

Dies gewährt Zugriff zum Lesen einer Liste von Datenspeichern.

Dies gewährt Zugriff zum Erstellen eines Snapshots deiner Datenspeicher.

Dies gewährt Zugriff zum Erstellen von Einträgen in deinen Datenspeichern.

Dies gewährt Zugriff zum Markieren bestimmter Einträge zum Löschen.

Dies gewährt Zugriff zum Auflisten deiner Datenspeichereinträge.

Dies gewährt Zugriff zum Lesen bestimmter Einträge in deinen Datenspeichern.

Dies gewährt Zugriff zum Aktualisieren des Werts, der Attribute und der Benutzer eines Eintrags.

Dies gewährt Zugriff zum Löschen von Überprüfungen deiner Datenspeichereinträge.

Dies gewährt Zugriff zum Auflisten von Überprüfungen deiner Datenspeichereinträge.

Gewährt Zugriff auf die Ansicht von Konfigurationsdetails für Entwicklerprodukte des autorisierten Benutzers.

Gewährt Zugriff zum Bearbeiten der Entwicklerprodukte des autorisierten Benutzers.

Dies ermöglicht das Anzeigen von Informationen über deine Universumsumgebungen.

Dies ermöglicht das Bearbeiten deiner Universumsumgebungen.

Gewährt Zugriff auf die Ansicht von Konfigurationsdetails für die Spielpässe des autorisierten Benutzers.

Gewährt Zugriff zum Bearbeiten der Spielpässe des autorisierten Benutzers.

Gewährt Zugriff auf die Ansicht von Informationen über Community-Foren für dein Konto.

Gewährt Zugriff auf die Verwaltung von Informationen über Community-Foren für dein Konto.

Dies ermöglicht das Anzeigen von Informationen über deine Communitys.

Damit kannst du Community-Beitrittsanfragen und Rollenänderungen von Community-Mitgliedern mit niedrigerem Rang für dein Konto verwalten.

Damit kannst du die Eigenschaftsdaten einer Instanz anzeigen.

Damit kannst du die Eigenschaftsdaten von Instanzen ändern (unterstützt derzeit nur Skripts).

Dies ermöglicht das Anzeigen von Informationen über dein Inventar.

Gewährt Zugriff auf die Verwaltung von Benutzer-Objekten.

Gewährt Zugriff auf die Verwaltung deiner Abzeichen.

Gewährt Zugriff auf die Verwaltung deiner Abzeichen und das Ausgeben von Robux.

Gewährt Zugriff zum Aktualisieren der Abzeichen des autorisierten Benutzers.

Gewährt Zugriff auf die Verwaltung deiner Entwicklerprodukte.

Ermöglicht den Lesezugriff auf Informationen über die Experiences, für die du Benachrichtigungen aktiviert hast.

Ermöglicht es, Benachrichtigungen für Experiences in deinem Namen ein- oder auszuschalten.

Gewährt Zugriff auf die Verwaltung deiner Pässe.

Gewährt Zugriff auf die Verwaltung deiner Communitys.

Gewährt die Erlaubnis, Community-Informationen zu lesen.

Gewährt Community-Verwaltungsberechtigungen.

Gewährt Zugriff zum Lesen und Schreiben deiner Lokalisierungstabellen

Gewährt Zugriff auf die Verwaltung der Teamzusammenarbeit für alle deine Experiences.

Gewährt Zugriff auf die Verwaltung deiner Experiences und bestimmte Informationen, die mit deiner Experience verbunden sind (z.B. Lokalisierungsinformationen).

Gewährt Zugriff zum Lesen der Lokalisierungsinformationen deiner Experiences.

Gewährt Zugriff zum Ändern der Lokalisierungspräferenzen deiner Experiences.

Gewährt Zugriff auf die Verwaltung deines Nutzerkontos.

Gewährt Zugriff zum Ändern der Lokalisierungspräferenzen des Nutzers.

Damit kannst du den Status, die Protokolle und die Ergebnisse der Luau-Ausführungsaufgaben für den zugehörigen Ort anzeigen.

Damit kannst du neue Luau-Ausführungsaufgaben für den zugehörigen Ort erstellen.

Dies gewährt Zugriff zum asynchronen Leeren aller Datenstrukturen im Universum.

Dies gewährt Zugriff zum Erstellen neuer Warteschlangenelemente.

Dies gewährt Zugriff zum Entfernen ausgelesener Elemente vom Anfang der Warteschlange.

Dies gewährt Zugriff zum Lesen von Elementen am Anfang der Warteschlange.

Dies gewährt Zugriff zum Lesen deiner Arbeitsspeicherelemente.

Dies gewährt Zugriff zum Lesen von Kartenelementen.

Dies gewährt Zugriff zum Erstellen, Aktualisieren und Löschen von Kartenelementen.

Dies gewährt die Fähigkeit, Nachrichten im Namen von Nutzern zu veröffentlichen.

Damit können Benachrichtigungen an Nutzer von deiner Experience aus gesendet werden.

(Veraltet) Dies gewährt Zugriff zum Lesen einer Liste von Einträgen in einem geordneten Datenspeicher.

(Veraltet) Dies gewährt Zugriff zum Erstellen eines neuen Eintrags in einem geordneten Datenspeicher.

Dies gewährt Zugriff auf Listeneinträge aus einem geordneten Datenspeicher.

Dies gewährt Zugriff zum Erstellen von Einträgen in einem geordneten Datenspeicher.

Dies ermöglicht es, Geheimnisse im Zusammenhang mit deiner Experience aufzulisten.

Damit kannst du Geheimnisse erstellen und aktualisieren, die mit deiner Experience verbunden sind.

Mit dieser Berechtigung kannst du einen Bewertungsauftrag einreichen und das Auftragsergebnis anzeigen.

Ermöglicht den Zugriff auf deine Abonnementprodukte.

Damit kannst du Informationen zu Vorschaubildern in deinem Namen lesen.

Gewährt die Fähigkeit, Spielanalysen zu lesen.

Gewährt die Fähigkeit, Ortsinformationen zu lesen.

Gewährt die Fähigkeit, Ortsinformationen zu bearbeiten.

Gewährt Zugriff für die Veröffentlichung neuer Versionen von Experiences auf Roblox.

Gewährt die Fähigkeit,Experience-Informationen zu lesen.

Gewährt Zugriff zum Bearbeiten der Experiences des autorisierten Benutzers.

Ermöglicht es dir, Benutzerbeschränkungen in der Experience zu sehen.

Ermöglicht es dir, Benutzerbeschränkungen in der Experience zu bearbeiten.

Damit kannst du Benachrichtigungen anzeigen, die an dein Konto gesendet wurden.

Erlaubt das Lesen des Premium- und Verifizierungs-Status des berechtigten Benutzers.

Damit kannst du die Social-Media-Konten des autorisierten Benutzers anzeigen.

Dies aktiviert Single Sign-On-Funktionalität.

Dies gewährt Zugriff auf das Lesen deiner Profilinformationen.