Skip to main content

Datum/Uhrzeit-Funktionen

Eine Datum/Uhrzeit-Funktion führt eine Aktion oder Berechnung für einen Datums- und Uhrzeitwert aus. Verwenden Sie eine Datum/Uhrzeit-Funktion zum Addieren oder Subtrahieren von Intervallen, zum Suchen des aktuellen Datums, zum Suchen des ersten oder letzten Tages des Monats, zum Extrahieren einer Komponente eines Datum/Uhrzeit-Werts oder zum Konvertieren eines Werts in ein anderes Format.

Alteryx verwendet das Format JJJJ-MM-TT HH:MM:SS zur Darstellung von Datum und Uhrzeit. Fügen Sie für zusätzliche Genauigkeit (bis zu 18 Stellen Präzision) einen Punkt und zusätzliche Ziffern nach der Sekundenposition hinzu. Zum Beispiel JJJJ-MM-TT HH:MM:SS.fff. Wenn ein Datum/Uhrzeit-Wert nicht in diesem Format ist, liest Alteryx ihn als Zeichenfolge. Um eine Spalte für die Verwendung und Bearbeitung in das Datum/Uhrzeit-Format zu konvertieren, verwenden Sie die DateTimeParse-Funktion im Ausdruckseditor oder das Datum/Uhrzeit-Tool.

Datumsformat

Bei einigen Datum/Uhrzeit-Funktionen müssen Sie das Format für das Datum einstellen. Formatzeichenfolgen bestehen aus Bezeichner und Trennzeichen.

Datum/Uhrzeit-Funktionen

Weitere Informationen finden Sie folgend in den DateTime-Funktionen.

DateTimeAdd

DateTimeAdd(dt,i,u): fügt einem Datum/Uhrzeit-Wert ein spezifisches Intervall hinzu.

Parameter

dt: Datum/Uhrzeit-Daten.

i: Positive oder negative ganze Zahl der Zeit zum Addieren oder Subtrahieren.

u: Datum/Uhrzeit-Einheit, die zwischen Anführungszeichen mit Schlüsselwörtern angegeben wird. Im Abschnitt Schlüsselwörter für Datum/Uhrzeit-Einheiten finden Sie eine Liste der Schlüsselwörter.

Beispiel

DateTimeAdd(DateTimeToday(), -1, "days") gibt das Datum von gestern zurück.

DateTimeAdd(DateTimeFirstOfMonth(), 1, "months") gibt den Ersten des nächsten Monats zurück.

DateTimeAdd("2016-01-30", 1, "month") gibt 2016-02-29 zurück (da Februar keinen 30. Tag hat, sondern der letzte Tag des Monats in dem Jahr der 29. ist).

DateTimeAdd("2016-03-30", -1, "month") gibt 2016-02-29 zurück (da Februar keinen 30. Tag hat, sondern der letzte Tag des Monats in dem Jahr der 29. ist).

DateTimeAdd("2016-03-30 01:02:03.000000", 495, "microseconds") gibt 2016-03-30 01:02:03.000495 zurück.

Mehr erfahren

  • Jeder Bruchteil in der Dauer wird abgeschnitten. Sie können beispielsweise nicht „1,5 Stunden“ hinzufügen. Fügen Sie stattdessen „90 Minuten“ hinzu.

  • Das Hinzufügen einer Einheit ändert nicht den Wert kleinerer Einheiten. Wenn Sie beispielsweise Stunden hinzufügen, wird der Minuten- oder Sekundenwert dadurch nicht geändert. Durch das Hinzufügen von Monaten wird der Tag oder die Uhrzeit nicht geändert, es sei denn, der resultierende Monat enthält diesen Tag nicht. In diesem Fall geht es bis zum letzten Tag dieses Monats.

  • Diese Funktion führt Berechnungen so aus, als ob die Zeitzone keine Zeitänderungen in Bezug auf Sommerzeit und Standardzeit aufweist. Dies kann zu unerwarteten Ergebnissen führen, wenn Ihre Berechnung Datum und Uhrzeit umfasst und die Zeit von Sommerzeit auf Standardzeit oder umgekehrt wechselt. Wenn die Genauigkeit der tatsächlich verstrichenen Zeit wichtig ist, sollten Sie Ihre Daten zunächst in UTC konvertieren.

DateTimeDay

DateTimeDay(dt): gibt den numerischen Wert für den Tag des Monats in einem Datum/Uhrzeit-Wert zurück.

Parameter

dt: Datum/Uhrzeit-Daten.

Beispiel

DateTimeDay("2017-03-24 11:43:23") gibt „24“ zurück.

DateTimeDiff

DateTimeDiff(dt1,dt2,u): subtrahiert das zweite Argument vom ersten (dt1 – dt 2) und gibt die Differenz als Ganzzahl zurück. Die Dauer wird als Zahl, nicht als eine Zeichenfolge, in den angegebenen Zeiteinheiten zurückgegeben.

Parameter

dt: Datum/Uhrzeit-Daten.

u: Datum/Uhrzeit-Einheit, die zwischen Anführungszeichen mithilfe von Schlüsselwörtern aus dem Abschnitt Schlüsselwörter für Datum/Uhrzeit-Einheiten angegeben wird.

Beispiel

DateTimeDiff("2024-01-18", "2024-01-15", "days") gibt „3“ zurück.

DateTimeDiff("2016-02-15 00:00:00", "2016-01-15 00:00:01", "Months") gibt 1 zurück (weil Anfang und Ende am selben Tag des Monats liegen).

DateTimeDiff("2012-02-29","2011-03-01","years") gibt 0 zurück (obwohl der 29.02.2012 365 Tage nach dem 01.03.2011 liegt, liegt der 29. Februar vor dem 1. März, sodass „ein Jahr“ noch nicht abgeschlossen ist).

DateTimeDiff("2016-02-14", "2016-01-15", "Months") gibt 0 zurück (weil der Tag im Februar kleiner als der Tag im Januar ist).

DateTimeDiff("2016-02-14 23:59:59", "2016-01-15 00:00:00", "Months") gibt 0 zurück (auch wenn es nur eine Sekunde zu kurz ist, um den gewünschten Tag zu erreichen).

DateTimeDiff('2017-02-28', '2016-02-29', 'Months') gibt 11 zurück (auch wenn der 28. Februar 2017 der letzte Tag des Monats Februar ist, ist der 28. weniger als 29).

DateTimeDiff('2017-02-28 00:59:59.28139502', '2017-02-28 00:59:59.12383125', 'msecs') Gibt 157 zurück (für Millisekunden zwischen Datum/Uhrzeit-Werten).

Mehr erfahren

  • Bei unterschiedlichen Monaten und Jahren wird ein Monat nur dann gezählt, wenn der Endtag den Starttag erreicht. Die Tageszeit wird dabei ignoriert.

  • Aus Gründen der Präzision bezüglich Tag, Stunde, Minute und Sekunde wird das Ergebnis genau berechnet. Bruchteile werden anschließend nicht gerundet, sondern abgeschnitten. Daher:

    • DateTimeDiff(‘2016-01-01 00:59:59’, ‘2016-01-01 00:00:00’, ‘Hours’) ist Null.

    • DateTimeDiff(‘2016-01-01 23:59:59’, ‘2016-01-01 00:00:00’, ‘Days’) ist Null.

  • Präzisionsnamen können auf die ersten drei Zeichen gekürzt werden (z. B. „Sek“ und „Min“). Groß- und Kleinschreibung wird nicht berücksichtigt.

  • Gehen Sie beim Speichern von Zeitunterschieden vorsichtig vor. Ein Int32 kann nur eine Differenz von 68 Jahren in Sekunden oder 4082 Jahren in Minuten halten. Mithilfe eines Double- oder Int64-Werts können Sie Intervalle zwischen allen unterstützten Datumsangaben aufnehmen.

  • Diese Funktion führt Berechnungen so aus, als ob die Zeitzone keine Zeitänderungen in Bezug auf Sommerzeit und Standardzeit aufweist. Dies kann zu unerwarteten Ergebnissen führen, wenn Ihre Berechnung Datum und Uhrzeit umfasst und die Zeit von Sommerzeit auf Standardzeit oder umgekehrt wechselt. Wenn die Genauigkeit der tatsächlich verstrichenen Zeit wichtig ist, sollten Sie Ihre Daten zunächst in UTC konvertieren.

DateTimeFirstOfMonth

DateTimeFirstOfMonth(): gibt den ersten Tag des Monats um Mitternacht zurück.

DateTimeFormat

DateTimeFormat(dt,f,[l],[tz]): konvertiert Datum/Uhrzeit-Daten vom ISO-Format in ein anderes angegebenes Format (f), in einer angegebenen Sprache (l) mit dem Zeitzonennamen (tz) zur Verwendung durch eine andere Anwendung. Ausgabe in einen Zeichenfolgen-Datentyp. Wenn das angegebene Format nicht so genau ist wie die eingehenden Daten, wird die Ausgabe abgeschnitten und nicht gerundet. Beispiel: Wenn Sie eine Zeit auf Mikrosekunden (.012789) übergeben und das Format die Zeit auf Millisekunden angibt, wird das Ergebnis auf .012 abgeschnitten und nicht auf 013 gerundet. Mit dem optionalen Zeitzonenparameter können Sie den Stil des Textes festlegen, der der Zeichenfolge hinzugefügt wird (z. B. „EDT“).

Parameter

dt: Datum/Uhrzeit-Daten.

f: Das Format, in das die Daten konvertiert werden sollen, ausgedrückt in einer Formatzeichenfolge. Weitere Informationen finden Sie unten im Abschnitt Bezeichner.

l: Dies ist ein optionaler Sprachparameter. Standardmäßig wird die Sprache verwendet, die in Designer ausgewählt ist. Wenn Designer beispielsweise auf Französisch eingestellt ist, lautet die Funktion standardmäßig DateTimeParse(dt,f,"Français"). Wenn Sie diesen Parameter weglassen, verwendet die Funktion unabhängig von der Sprache der Designer-Schnittstelle Englisch. Unter Sprachparameter finden Sie eine Liste der akzeptierten Sprachwerte.

tz: Dies ist ein optionaler Zeitzonenparameter. Beachten Sie, dass die Daten nicht konvertiert werden. Dies dient lediglich dazu, den Stil des Textes anzugeben, welcher der Zeichenfolge hinzugefügt wird.

  • Die Zeitzonen-Kennung bestimmt, welcher Versatz angezeigt werden soll, wenn Sie die Versatz-Formatanweisung (%z) verwenden, oder um einen Namen für die anzuzeigende Zeitzone abzurufen, wenn Sie die Anweisung für das Format des Zeitzonennamens (%Z) verwenden.

  • Der Zeitzonenname behält den Stil des Arguments bei: Kurz (wie EST), lang (wie Eastern Standard Time), allgemein (wie ET) oder spezifisch (wie EST/EDT).

    Der Name wird so geändert, dass er der richtigen Jahreszeit für die Daten entspricht. Wenn z. B. das „tz“ als EST für den 15.08.2024 bereitgestellt wird, erfolgt eine Korrektur in EDT. Ähnlich bei 2024-01-15, wenn das „tz“ als EDT bereitgestellt wird, erfolgt eine Korrektur in EST. Für beide Beispiele gilt: Wenn „tz“ als generisches ET bereitgestellt wird, erfolgt keine Korrektur, um anzuzeigen, ob es sich um Sommerzeit oder Standardzeit handelt.

  • Wenn „tz“ im Funktionsaufruf nicht angegeben ist, wird die Systemzeitzone verwendet.

Beispiel

DateTimeFormat('2008-04-22',"%d-%m-%Y") gibt 22-04-2008 für das Datum 22. April 2008 aus (ISO-Format: 2008-04-22).

DateTimeFormat([DateTime_Out],"%A","Spanish") gibt „martes“ für das ISO-Datum 2020-07-14 zurück (wobei der 14. Juli ein Dienstag ist).

DateTimeFormat('11:59:57.890994389','%H:%M:%S.%5') Gibt '11:59:57.89099' zurück (wird basierend auf den angegebenen Ziffern auf fünf Stellen abgeschnitten).

DateTimeFormat('11:59:57.99','%H:%M:%S,%3') gibt „11:59:57,990“ zurück (Sie können das Dezimaltrennzeichen Ihres Gebietsschemas abrufen. In diesem Beispiel wird ein Komma anstelle eines Dezimalpunkts verwendet).

DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %Z', '', 'ET') Gibt „Mar 10, 24 01:00:00 ET“ zurück. Der Stil des Zeitzonenarguments ist kurz und allgemein, so dass er im Ergebnis verwendet wird.

DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %Z', '', 'EDT') Gibt „Mar 10, 24 01:00:00 EST“ zurück. Der Stil des Zeitzonenarguments ist kurz und spezifisch. Er ist falsch für die Zeit der Daten. Das Ergebnis wird mit dem spezifischen Zeitzonenversatz korrigiert.

DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %Z', '', 'Eastern Time') Gibt „Mar 10, 24 01:00:00 Eastern Time“ zurück. Der Stil wird beibehalten und es muss keine Verschiebung korrigiert werden.

DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %Z', '', 'Eastern Daylight Time') Gibt „Mar 10, 24 01:00:00 Eastern Standard Time“ zurück. Die Zeitzonenverschiebung wird korrigiert.

DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %z', '', 'ET') Gibt „Mar 10, 24 01:00:00 -0400“ zurück.

DateTimeHour

DateTimeHour(dt): gibt die Stundenzahl der Uhrzeit in einem Datum/Uhrzeit-Wert zurück.

Parameter

dt: Datum/Uhrzeit-Daten.

Beispiel

DateTimeHour("2017-03-24 11:43:23") gibt „11“ zurück.

DateTimeHour("2017-03-24") gibt zurück 0, da Mitternacht der angenommene Zeitpunkt ist, an dem die Zeit nicht mit einem Datum spezifiziert wird.

DateTimeLastOfMonth

DateTimeLastOfMonth(): gibt den letzten Tag des aktuellen Monats zurück, wobei die Uhrzeit auf eine Sekunde vor dem Ende des Tages festgelegt wird (23:59:59).

Designer gibt das Datum und die Uhrzeit zurück, zu der der aktuelle Workflow gestartet wurde. In einem Batch-Prozess wird diese Uhrzeit mit jedem neuen Datenset verwendet. Dadurch wird die Konsistenz sichergestellt, wenn der Prozess lange dauert.

DateTimeMinutes

DateTimeMinutes(dt): gibt die Minutenzahl der Uhrzeit in einem Datum/Uhrzeit-Wert zurück.

Parameter

dt: Datum/Uhrzeit-Daten.

Beispiel

DateTimeMinutes("2017-03-24 11:43:23") gibt „43“ zurück.

DateTimeMonth

DateTimeMonth(dt): gibt den numerischen Wert für den Monat in einem Datum/Uhrzeit-Wert zurück.

Parameter

dt: Datum/Uhrzeit-Daten.

Beispiel

DateTimeMonth("2017-03-24 11:43:23") gibt „3“ zurück.

DateTimeMonth("11:43:23") gibt [Null] zurück, da die eingehenden Daten nicht gültig sind.

Zeitstempeltool

DateTimeNow([tz]): gibt das aktuelle Datum und die aktuelle Uhrzeit einschließlich Sekunden zurück. Wenn Sie den optionalen Zeitzonenparameter (tz) angeben, liegt die zurückgegebene Zeit in dieser Zeitzone. Wenn Sie keine Zeitzone angeben, liegt die zurückgegebene Zeit in Ihrer Systemzeitzone.

Parameter

tz: (Optional) Geben Sie eine Zeitzone für die zurückgegebene Zeit an. Sofern angegeben, verwendet die zurückgegebene Zeit diese Zeitzone. Wenn diese Option ausgelassen wird, verwendet die zurückgegebene Zeit Ihre Systemzeitzone.

DateTimeNowPrecise

DateTimeNowPrecise(digits,[tz]): gibt das aktuelle Systemdatum und die aktuelle Systemuhrzeit mit Sekundenbruchteilen zurück (bis zu einer Präzision von 18 Stellen). Wenn Sie den optionalen Zeitzonenparameter (tz) angeben, liegt die zurückgegebene Zeit in dieser Zeitzone. Wenn Sie keine Zeitzone angeben, liegt die zurückgegebene Zeit in Ihrer Systemzeitzone.

Beachten Sie, dass die Funktion den Rest mit Nullen auffüllt, wenn Sie eine Genauigkeit anfordern, die über die Möglichkeiten Ihres Betriebssystems hinausgeht, wie im zweiten Beispiel unten.

Parameter

Ziffern: Geben Sie die Genauigkeit des zurückgegebenen Werts zwischen 0 und 18 (einschließlich) an.

tz: (Optional) Geben Sie eine Zeitzone für die zurückgegebene Zeit an. Sofern angegeben, verwendet die zurückgegebene Zeit diese Zeitzone. Wenn diese Option ausgelassen wird, verwendet die zurückgegebene Zeit Ihre Systemzeitzone.

Beispiel

DateTimeNowPrecise(3) gibt „2022-10-14 11:59:57.991“ zurück.

DateTimeNowPrecise(12) gibt „2022-10-14 11:59:57.991238400000“ zurück.

DateTimeParse

DateTimeParse(string,f,[l],[tzName]): konvertiert eine Datumszeichenfolge (Zeichenfolge) mit dem angegebenen Format (f), in einer angegebenen Sprache (l) mit der angegebenen Zeitzone (tzName) in das Format (YYYY-MM-DD HH:MM:SS mit optionaler Datum/Uhrzeit-Präzision, falls zutreffend). Wenn das spezifizierte Format eine geringere Präzision aufweist, wird die Ausgabe abgeschnitten.

Parameter

string: Datum/Uhrzeit-Zeichenfolgendaten. Die eingehenden Daten müssen dem Zeichenfolgen-Datentyp entsprechen und können in einem beliebigen Datum/Uhrzeit-Format vorliegen, sofern dieses Format mit dem von Ihnen für den Parameter f angegebenen Format konform ist.

f: das Format der eingehenden Datum-Zeichenfolgendaten, die Sie konvertieren, ausgedrückt als Formatzeichenfolge in Anführungszeichen.

Zeitzonen

Wenn das eingehende Format %z oder %Z enthält, erkennt Alteryx die eingegebene Zeitzone. Der Datum-/Uhrzeit-Ergebniswert wird in die lokale oder angegebene Zeitzone konvertiert. Wenn das Format oder die Daten keine Zeitzoneninformationen enthalten, geht Alteryx davon aus, dass sich die Eingabe bereits in der lokalen Zeitzone befindet, und wendet keine Zeitverschiebungen an.

Überprüfen Sie Ihre Daten, und ergreifen Sie die entsprechenden Schritte, um sicherzustellen, dass die Ausgabe im gewünschten Format erfolgt. Wichtige Überlegungen zur Zeitzone finden Sie unter Zeitzone und Änderungen der Sommerzeit/Standardzeit.

l: (optional) die Sprache der eingehenden Datum-Zeichenfolgendaten, die Sie konvertieren. Der Sprachparameter wird standardmäßig auf Ihre in Designer für die Formelbearbeitung ausgewählte Sprache eingestellt. Wenn diese Option ausgelassen oder leer ist, wird „Englisch“ verwendet. Wenn Designer beispielsweise auf Französisch eingestellt ist, lautet die Funktion standardmäßig DateTimeParse(string,f,"Français"). Navigieren Sie zu Sprachparameter für akzeptierte Sprachwerte.

tz: (Optional) die Zeitzone, in die die Daten konvertiert werden sollen, wenn %z oder %Z das Format hat und der Text den Namen einer Zeitzone oder einen Versatz enthält. Diese Beispiele sollen das verdeutlichen. Wenn die Zeitzone ausgelassen wird, wird die Systemzeitzone für die Konvertierung verwendet.

Beispiel

DateTimeParse("2016/28-03","%Y/%d-%m") gibt 2016-03-28 zurück

DateTimeParse('mardi 14 juillet 2020', '%A %d %B %Y', 'Français') gibt 2020-07-14 zurück, wobei die eingehende Datumszeichenfolge „mardi 14 juillet 2020“ (Dienstag 14. Juli 2020) ist.

DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S') gibt „2022-10-04 11:59:57“ zurück. Die Funktion löscht die nachgestellten Ziffern.

DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S.%3') gibt „2022-10-04 11:59:57.990“ zurück. Die Funktion fügt Nullen hinzu, um dem %3-Format zu entsprechen.

DateTimeParse('Oct 4, 22 11:59:57.99', '%b %d, %y %H:%M:%S,%3') gibt [Null] und eine Warnung zurück, dass ',' erwartet wurde anstatt '.'

DateTimeParse('Mar 10, 24 01:00:00 PST', '%b %d, %y %T %Z') gibt „2024-03-10 04:00:00“ zurück, wenn die lokale Zeitzone Eastern ist.

DateTimeParse('Mar 12, 24 01:00:00 PST', '%b %d, %y %T %Z') Gibt „2024-03-12 05:00:00“ zurück, wenn die lokale Zeitzone Eastern ist, da die Eastern Time bereits auf EDT (Eastern Daylight Time) geändert wurde.

DateTimeParse('Mar 10, 24 01:00:00', '%b %d, %y %T %Z') Gibt „2024-03-10 01:00:00“ zurück, wenn die lokale Zeitzone „Eastern“ ist. Obwohl das Format Zeitzoneninformationen abgefragt hat, waren in den Daten keine vorhanden. Ohne eine Angabe der Zeitzone in den Eingabedaten erfolgt keine Konvertierung.

DateTimeParse('Mar 10, 24 01:00:00 PST', '%b %d, %y %T') Gibt „2024-03-11 01:00:00“ zurück. Wie im obigen Beispiel werden alle Daten ignoriert, die Zeitzonendaten enthalten könnten, wenn das Format keine Zeitzoneninformationen verwendet.

DateTimeQuarter

DateTimeQuarter(dt, [Q1Start]: gibt den numerischen Wert für das Quartal des Jahres zurück, in das ein Datum/Uhrzeit-Wert (YYYY-MM-DD) fällt. Verwenden Sie den optionalen numerischen Parameter, um den Startmonat für das erste Quartal (Q1) anzugeben.

Parameter

dt: Datum/Uhrzeit-Daten.

Q1Start: optionaler numerischer Parameter, um den Startmonat für Q1 (1–12) anzugeben.

Beispiel

DateTimeQuarter("2023-01-03") gibt „1“ zurück. Kein Fehler, da der zweite Parameter optional ist.

DateTimeQuarter("2023-05-03", 1) gibt „2“ zurück.

DateTimeQuarter("2023-05-03", 7) gibt „4“ zurück. Der optionale Parameter gibt an, dass Q1 im Juli beginnt.

DateTimeQuarter("2023-05-03 12:04:55", 7) gibt „4“ zurück. Der optionale Parameter gibt an, dass Q1 im Juli beginnt. Der Zeitstempel wird ignoriert.

DateTimeQuarter("2023-01-03", 13) gibt Null zurück. Der zweite Parameter muss ein numerischer Wert zwischen 1–12 sein.

DateTimeQuarter("2023-01-03", 0) gibt Null zurück. Der zweite Parameter muss ein numerischer Wert zwischen 1–12 sein.

DateTimeQuarter("2023-01-03", -1) gibt Null zurück. Der zweite Parameter muss ein numerischer Wert zwischen 1–12 sein.

DateTimeQuarter("12:00:55") gibt Null zurück.

DateTimeSeconds

DateTimeSeconds(dt): gibt den Sekundenanteil der Uhrzeit in einem Datum/Uhrzeit-Wert zurück, gegebenenfalls einschließlich der Präzision im Sekundentakt.

Parameter

dt: Datum/Uhrzeit-Daten.

Beispiel

DateTimeSeconds('11:59:57.99') gibt „57,99“ zurück.

DateTimeSeconds('11:59:57') gibt „57“ zurück.

DateTimeStart

DateTimeStart(): gibt das Datum und die Uhrzeit zurück, zu der der aktuelle Workflow gestartet wurde. Dabei wird die Zeitzone des Systems verwendet.

DateTimeToday

DateTimeToday(): gibt das Datum von heute zurück.

Erwartetes Verhalten: DateTimeToday-Datentyp

Trotz seines Namens gibt DateTimeToday() keinen Zeitwert zurück. Stattdessen wird nur ein Datum mit dem aktuellen Datum zurückgegeben. Sie können die DateTimeToday()-Funktion in die ToDateTime()-Funktion einschließen, um einen Datum/Uhrzeit-Wert zurückzugeben, dessen Zeit auf Mitternacht des aktuellen Tages festgelegt ist:

ToDateTime(DateTimeToday())

DateTimeToLocal

DateTimeToLocal(dt,[tz]): konvertiert ein UTC-Datum/Uhrzeit in das optionale Argument „tz“, sonst in die lokale Systemzeitzone. Die Funktion „DateTimeToLocal“ unterstützt derzeit keine Präzision für Datum/Uhrzeit im Feld „dt“.

Anmerkung

Das Ergebnis hat keine Angabe über die Zeitzone. Sie müssen DateTimeFormat verwenden oder das Ergebnis als Zeichenfolge ändern, um die Zeitzone anzugeben, falls gewünscht. Wenn Sie „DateTimeFormat“ verwenden, sollte das Argument „tz“ ein Name für dasselbe „tz“ sein, das bei der Konvertierung verwendet wird. Es kann ein anderes Format annehmen, z. B. EST oder Eastern Daylight Time oder America/New_York oder „-0400“. Wichtige Überlegungen zur Zeitzone finden Sie unter Zeitzone und Änderungen der Sommerzeit/Standardzeit.

Parameter

dt: Datum/Uhrzeit-Daten.

tz: Dies ist ein optionaler Zeitzonenparameter, in den die Datums-/Uhrzeitdaten konvertiert werden. Wenn (tz) im Funktionsaufruf nicht angegeben ist, wird die Systemzeitzone verwendet.

Beispiel

DateTimeToLocal('2014-08-01 20:01:25') Gibt die lokale Systemzeitzone (Mountain Time) als „2014-08-01 14:01:25“ zurück.

DateTimeToLocal('2024-08-15 09:00:00.123') Wandelt die UTC-Zeit in die Systemzeit um, z. B. Amerika/New_York, gibt „2024-08-15 05:00:00.123“ zurück, oder Amerika/Denver und gibt „2024-08-03:00:00.123“ zurück.

DateTimeToLocal('2024-08-15 09:00:00.123', 'EST') Konvertiert die UTC-Zeit in Eastern Daylight Time, obwohl die angegebene Zeit Standardzeit ist. Bei der Suche nach der Zeitzone für die Konvertierung wird die Sommerzeit-/Standardspezifikation ignoriert, sodass „2024-08-15 05:00:00.123“ zurückgegeben wird.

DateTimeToUTC

DateTimeToUTC(dt,[tz]): konvertiert eine Datum/Uhrzeit-Angabe (in der Zeitzone des lokalen Systems oder in der bereitgestellten Zeitzone) in UTC. Es wird angenommen, dass das eingegebene Datum/die eingegebene Uhrzeit in der angegebenen Zeitzone oder in der Zeitzone des Systems liegt, auf dem der Workflow ausgeführt wird. Die Funktion „DateTimeToUTC“ unterstützt derzeit keine Präzision für Datum/Uhrzeit im Feld „dt“.

Anmerkung

Das Ergebnis weist nicht darauf hin, dass es in UTC ist. Sie müssen DateTimeFormat verwenden oder das Ergebnis als Zeichenfolge ändern, um die Zeitzone anzugeben, falls gewünscht. Wenn Sie „DateTimeFormat“ verwenden, sollte das Argument „tz“ ein Name für dieselbe Zeitzone sein, die bei der Konvertierung verwendet wird. Es kann ein anderes Format annehmen, z. B. UTC, GMT oder Z oder „+0000“. Wichtige Überlegungen zur Zeitzone finden Sie unter Zeitzone und Änderungen der Sommerzeit/Standardzeit.

Parameter

dt: Datum/Uhrzeit-Daten.

tz: Dies ist ein optionaler Zeitzonenparameter. Wenn im Funktionsaufruf kein „tz“ angegeben ist, wird die Systemzeitzone verwendet.

Beispiel

DateTimeToUTC(DateTimeNow()) gibt die Coordinated Universal Time zur Workflow-Laufzeit zurück: 2014-08-01 20:01:25 (wobei US-Mountain Time 2014-08-01 14:01:25 war).

DateTimeToUTC('2024-08-15 09:00:00.123') Konvertiert die Zeit in UTC aus der Systemzeit, z. B. America/New_York und gibt „2024-08-15 13:00:00.123“ zurück, oder America/Denver und gibt „2024-08-15:00:00.123“ zurück.

DateTimeTrim

DateTimeTrim(dt,t): entfernt unerwünschte Teile einer Datum/Uhrzeit-Angabe und gibt die geänderte Datum/Uhrzeit-Angabe zurück.

Parameter

dt: Datum/Uhrzeit-Daten.

t: Schnitttyp. Folgende Optionen sind verfügbar:

  • firstofmonth: Abschneiden bis auf den Monatsbeginn (dies hat dieselbe Wirkung wie Monat).

  • lastofmonth: Bis eine Sekunde vor Ende des letzten Tages des Monats verlängern.

  • year: Auf Mitternacht am 1. Januar zuschneiden.

  • month: Auf Mitternacht am ersten Tag des Monats zuschneiden.

  • Tag: Auf den Tag zuschneiden (d. h. Mitternacht). Dadurch wird ein Datum/Uhrzeit-Wert in einen Tag mit einer Null-Zeit (kein Datum) konvertiert.

  • hour: Zuschneiden auf die Stunde.

  • minute: Zuschneiden auf die Minute.

  • seconds: Zuschnitt auf Sekunden- und Sekundenbruchteile mit Schlüsselwörtern aus dem Abschnitt Schlüsselwörter für Datum/Uhrzeit-Einheiten.

Beim Zuschneiden einer Datum/Uhrzeit-Angabe wird der zurückgegebene Wert nicht gerundet. Zum Beispiel wird die Uhrzeit 15:59:59 auf die Stunde genau zu 15:00:00 und nicht zu 16:00:00 korrigiert.

Beispiel

DateTimeTrim("2016-12-07 16:03:00","year") gibt 2016-01-01 00:00:00 zurück.

DateTimeTrim('2016-12-07 11:59:57.99','msec') gibt 2016-12-07 11:59:57.990 zurück.

DateTimeTrim('2016-12-07 11:59:57.99',4) gibt 2016-12-07 11:59:57.9900 zurück.

DateTimeTrim('2016-12-07 11:59:57.123456789','milliseconds') gibt 11:59:57.123 zurück.

DateTimeYear

DateTimeYear(dt): gibt den numerischen Wert für das Jahr in einem Datum/Uhrzeit-Wert zurück.

Parameter

dt: Datum/Uhrzeit-Daten.

Beispiel

DateTimeYear("2017-03-24 11:43:23") gibt 2017 zurück.

ToDate

ToDate(x): wandelt eine Zeichenfolge, eine Zahl oder einen Datum/Uhrzeit-Wert in ein Datum um.

  • Eine eingehende Zeichenfolge sollte im Format YYYY-MM-DD sein. Beispiel: 2020-10-31.

  • Eine eingehende Nummer sollte als Excel-Datumsformat formatiert werden, wobei die Nummer die Anzahl der Tage seit dem 01-01-1900 darstellt. Beispiel: 7000 entspricht 03-01-1919.

  • Eine eingehende Datum-Uhrzeit-Angabe sollte im Format YYYY-MM-DD hh:mm:ss sein. Beispiel: 2020-10-31 12:00:00.

Beispiel

ToDate('2020-10-31') gibt 2020-10-31 als Datum zurück.

ToDate(7000) gibt 1919-03-01 als Datum zurück.

ToDate('2020-10-31 12:00:00') gibt 2020-10-31 als Datum zurück.

ToDateTime

ToDateTime(x): wandelt eine Zeichenfolge, eine Zahl oder ein Datum in eine Datum/Uhrzeit-Angabe um. Die ToDateTime-Funktion unterstützt keine höhere Genauigkeit als Sekunden. Excel-Werte auf Sekundendarstellung begrenzen (fünf Stellen, bis zu 99999).

  • Ein eingehende Zeichenfolge sollte im Format YYYY-MM-DD hh:mm:ss sein. Beispiel: 2020-10-31 12:00:00.

  • Eine eingehende Nummer sollte als Excel-Datum/Uhrzeit-Format formatiert werden, wobei die Nummer die Anzahl der Tage seit dem 01-01-1900 darstellt. Beispiel: 7000.354167 entspricht 03-01-1919 um 8:30 Uhr.

Beispiel

ToDateTime('2020-10-31') gibt 2020-10-31 00:00:00 als Datum-Uhrzeit-Angabe zurück.

ToDateTime(7000.354167) gibt „1919-03-01 08:30:00“ als Datum/Uhrzeit-Angabe zurück.

ToDateTime('2020-10-31 12:00:00') gibt „2020-10-31 12:00:00“ als Datum/Uhrzeit-Angabe zurück.

Datum/Uhrzeit-Funktionsreferenz

Informationen zur Verwendung in Datums- und Uhrzeitfunktionen finden Sie in diesen Bezeichnern, Trennzeichen, Schlüsselwörtern und Sprachparametern.

Bezeichner

Bezeichner beginnen immer mit einem Prozentzeichen (%), gefolgt von einem Buchstaben, bei dem zwischen Groß- und Kleinschreibung unterschieden wird, oder einer Zahl. Die Daten müssen mindestens eine zweistellige Jahreszahl enthalten.

Tipp

Wenn Sie lieber eine alphabetische Liste abrufen möchten, können Sie dies unten tun.

Bezeichner

Ausgabe von Datum/Uhrzeit-Format

Unterstützte Eingabe mit DateTimeParse

Jahr

%y

Letzten beiden Ziffern des Jahres („16“).

Bis zu vier Ziffern werden bis zu einem Trennzeichen oder dem Ende der Zeichenfolge gelesen und einem Bereich des aktuellen Jahres zugewiesen, 66 Jahre vor dem aktuellen Jahr bis 33 Jahre danach. Für 2016 bedeutet das beispielsweise 1950 bis 2049.

Einschränkung bei sechsstelligen Datumsangaben

Da für das Jahr bis zu vier Ziffern gelesen werden, werden bei Formaten, die für das Jahr nur zwei Ziffern ohne Trennzeichen enthalten sollen, wie ein sechsstelliger Datumsstempel (z. B. %y%m%d, für Daten wie „170522“ für den 22. Mai 2017), weiterhin vier Ziffern gelesen. Diese Einschränkung können Sie wie folgt umgehen:

  • Verwenden Sie je nach Datumsbereich vier Ziffern für das Jahr (Beispiel: 2017 statt 17).

  • Verwenden Sie das RegEx-Tool, um ein Leerzeichen nach den ersten beiden Ziffern in der Zeichenfolge einzufügen.

%Y

Alle vier Ziffern des Jahres („2016“).

Zwei oder vier Ziffern werden gelesen. Zwei Ziffern werden einem Bereich des aktuellen Jahres zugewiesen – minus 66 vom aktuellen Jahr, plus 33. Für 2024 bedeutet das beispielsweise 1958 bis 2057.

Monat

%b

Abgekürzter Monatsname („Sep“)

Eine gültige Abkürzung für einen Monatsnamen („Sep“, „SEPT.“). Gibt einen Fehler nur dann zurück, wenn der angegebene Text kein Monatsname (in der angegebenen Sprache) ist.

%B

Vollständiger Monatsname („September“)

Monatsname oder eine gültige Abkürzung für einen Monatsnamen („Sep“, „SEPT.“). Gibt einen Fehler nur dann zurück, wenn der angegebene Text kein Monatsname (in der angegebenen Sprache) ist.

%h

Abgekürzter Monatsname. Wie %b („Sep“).

Eine gültige Abkürzung für einen Monatsnamen („Sep“, „SEPT.“). Gibt einen Fehler nur dann zurück, wenn der angegebene Text kein Monatsname ist.

%m

Monatsnummer, 01 bis 12.

Ein- oder zweistellige Monatsnummer, 1 oder 01 bis 12.

Woche

%U

Gibt die Wochennummer als 00–53 mit dem Wochenbeginn am Sonntag zurück.

Nicht unterstützt

%W

Gibt die Wochennummer als 00–53 mit dem Wochenbeginn am Montag zurück.

Nicht unterstützt

Tag des Jahres/Monats

%d

Tag im Monat („01“)

Eine oder zwei Ziffern, wobei Leerzeichen ignoriert werden („1“ oder „01“).

%e

Tag des Monats, eine führende 0 wird durch ein Leerzeichen ersetzt („ 1“).

Eine oder zwei Ziffern, wobei Leerzeichen ignoriert werden („1“ oder „01“).

%j

Der Tag des Jahres von 001 bis 365 (oder 366 in Schaltjahren).

3-stelliger Tag des Jahres, von 001 bis 365 (oder 366 in Schaltjahren).

Wochentag

%a

Abgekürzter Wochentagsname („Mon“)

Eine gültige Abkürzung für einen Wochentag („Mon“, „Die“, „Don“). Gibt einen Fehler nur dann zurück, wenn der angegebene Text kein Wochentag ist. Beachten Sie, dass Alteryx nicht überprüft, ob der angegebene Name für einen Tag für ein bestimmtes Datum gültig ist.

%A

Vollständiger Wochentagsname („Montag“)

Tagesname oder eine gültige Abkürzung für einen Wochentag („Mon“, „Die“, „Don“). Gibt einen Fehler nur dann zurück, wenn der angegebene Text kein Wochentag ist. Beachten Sie, dass Alteryx nicht überprüft, ob der angegebene Name für einen Tag für ein bestimmtes Datum gültig ist.

%u

Wochentag als Dezimal, 1 bis 7, Montag als 1.

Nicht unterstützt

%w

Wochentag als Zahl, 0 bis 6, Sonntag als 0.

Nicht unterstützt

Stunde, Minute, Sekunde

%H

Stunde im 24-Stundenformat, 00 bis 23.

Bis zu zwei Ziffern für die Stunde, 0 bis 23. Nicht kompatibel mit %p oder %P.

%I (großes „I“ wie „Ida“)

Stunde im 12-Stundenformat, 01 bis 12.

Bis zu zwei Ziffern für die Stunde, 1 bis 12. Muss folgen mit %p oder %P.

%k

24 Stunden, führende Null wird durch Leerzeichen ersetzt, „ 0“ bis „23“.

Bis zu zwei Ziffern für die Stunde.

%M

Minuten, 00 bis 59

Bis zu zwei Ziffern für Minuten.

%S

Sekunden, 00 bis 59

Bis zu zwei Ziffern für Sekunden.

Sonstige Bestimmungen

%1 – %18 (eine Zahl im Bereich)

Die Anzahl der Dezimalstellen für Sekundenbruchteile.

Bis zu 18 Stellen Präzision für Sekundenbruchteile.

%c

Das Datum und die Uhrzeit für das Gebietsschema des Computers.

Nicht unterstützt

%C

Die Jahrhundertzahl („20“)

Nicht unterstützt

%D

Entspricht %m/%d/%y

Nicht unterstützt

%h

Wie %b („Sep“)

Eine gültige Abkürzung für einen Monatsnamen („Sep“, „SEPT.“). Gibt einen Fehler nur dann zurück, wenn der angegebene Text kein Monatsname ist.

%l (kleines „l“ wie „lustig“)

12 Stunden, führende Null wird durch Leerzeichen ersetzt, „ 1“ bis „12“.

Nicht unterstützt

%p

„AM“ oder „PM“

Keine Beachtung der Groß/Kleinschreibung („aM“ oder „Pm“). Muss %I folgen (großes „I“ wie „Ida“, Stunde im 12-Stundenformat).

%P

„am“ oder „pm“

Keine Beachtung der Groß/Kleinschreibung („aM“ oder „Pm“). Muss %I folgen (großes „I“ wie „Ida“, Stunde im 12-Stundenformat).

%T

Zeit in 24-Stunden-Format. Entspricht %H:%M:%S

Zeit in 24-Stunden-Format. Entspricht %H:%M:%S

%x

Das Datum für das Gebietsschema des Computers.

Nicht unterstützt

%X

Die Uhrzeit im 12-Stunden-Format, einschließlich AM oder PM („11:51:02 AM“).

Stunden:Minuten:Sekunden [AM/PM]

%z

Versatz von UTC-Zeit („-600“).

Unterstützt für Eingabe.

%Z

Vollständiger Zeitzonenname („Mountain Daylight Time”).

Unterstützt für Eingabe.

Bezeichner

Ausgabe von Datum/Uhrzeit-Format

Unterstützte Eingabe mit DateTimeParse

%1 - %18 (eine Zahl im Bereich)

Die Anzahl der Dezimalstellen für Sekundenbruchteile.

Bis zu 18 Stellen Präzision für Sekundenbruchteile.

%a

Abgekürzter Wochentagsname („Mon“)

Eine gültige Abkürzung für einen Wochentag („Mon“, „Die“, „Don“). Gibt einen Fehler nur dann zurück, wenn der angegebene Text kein Wochentag ist. Beachten Sie, dass Alteryx nicht überprüft, ob der angegebene Name für einen Tag für ein bestimmtes Datum gültig ist.

%A

Vollständiger Wochentagsname („Montag“)

Tagesname oder eine gültige Abkürzung für einen Wochentag („Mon“, „Die“, „Don“). Gibt einen Fehler nur dann zurück, wenn der angegebene Text kein Wochentag ist. Beachten Sie, dass Alteryx nicht überprüft, ob der angegebene Name für einen Tag für ein bestimmtes Datum gültig ist.

%b

Abgekürzter Monatsname („Sep“)

Eine gültige Abkürzung für einen Monatsnamen („Sep“, „SEPT.“). Gibt einen Fehler nur dann zurück, wenn der angegebene Text kein Monatsname (in der angegebenen Sprache) ist.

%B

Vollständiger Monatsname („September“)

Monatsname oder eine gültige Abkürzung für einen Monatsnamen („Sep“, „SEPT.“). Gibt einen Fehler nur dann zurück, wenn der angegebene Text kein Monatsname (in der angegebenen Sprache) ist.

%c

Das Datum und die Uhrzeit für das Gebietsschema des Computers.

Nicht unterstützt

%C

Die Jahrhundertzahl („20“)

Nicht unterstützt

%d

Tag im Monat („01“)

Eine oder zwei Ziffern, wobei Leerzeichen ignoriert werden („1“ oder „01“).

%D

Entspricht %m/%d/%y

Nicht unterstützt

%e

Tag des Monats, eine führende 0 wird durch ein Leerzeichen ersetzt („ 1“).

Eine oder zwei Ziffern, wobei Leerzeichen ignoriert werden („1“ oder „01“).

%h

Abgekürzter Monatsname. Wie %b („Sep“).

Eine gültige Abkürzung für einen Monatsnamen („Sep“, „SEPT.“). Gibt einen Fehler nur dann zurück, wenn der angegebene Text kein Monatsname ist.

%H

Stunde im 24-Stundenformat, 00 bis 23.

Bis zu zwei Ziffern für die Stunde, 0 bis 23. Nicht kompatibel mit %p oder %P.

%I (großes „I“ wie „Ida“)

Stunde im 12-Stundenformat, 01 bis 12.

Bis zu zwei Ziffern für die Stunde, 1 bis 12. Muss folgen mit %p oder %P.

%j

Der Tag des Jahres von 001 bis 365 (oder 366 in Schaltjahren).

3-stelliger Tag des Jahres, von 001 bis 365 (oder 366 in Schaltjahren).

%k

24 Stunden, führende Null wird durch Leerzeichen ersetzt, „ 0“ bis „23“.

Bis zu zwei Ziffern für die Stunde.

%l (kleines „l“ wie „lustig“)

12 Stunden, führende Null wird durch Leerzeichen ersetzt, „ 1“ bis „12“.

Nicht unterstützt

%M

Minuten, 00 bis 59

Bis zu zwei Ziffern für Minuten.

%m

Monatsnummer, 01 bis 12.

Ein- oder zweistellige Monatsnummer, 1 oder 01 bis 12.

%p

„AM“ oder „PM“

Keine Beachtung der Groß/Kleinschreibung („aM“ oder „Pm“). Muss %I folgen (großes „I“ wie „Ida“, Stunde im 12-Stundenformat).

%P

„am“ oder „pm“

Keine Beachtung der Groß/Kleinschreibung („aM“ oder „Pm“). Muss %I folgen (großes „I“ wie „Ida“, Stunde im 12-Stundenformat).

%S

Sekunden, 00 bis 59

Bis zu zwei Ziffern für Sekunden.

%T

Zeit in 24-Stunden-Format. Entspricht %H:%M:%S

Zeit in 24-Stunden-Format. Entspricht %H:%M:%S

%u

Wochentag als Dezimal, 1 bis 7, Montag als 1.

Nicht unterstützt

%U

Gibt die Wochennummer als 00–53 mit dem Wochenbeginn am Sonntag zurück.

Nicht unterstützt

%w

Wochentag als Zahl, 0 bis 6, Sonntag als 0.

Nicht unterstützt

%W

Gibt die Wochennummer als 00–53 mit dem Wochenbeginn am Montag zurück.

Nicht unterstützt

%x

Das Datum für das Gebietsschema des Computers.

Nicht unterstützt

%X

Die Uhrzeit im 12-Stunden-Format, einschließlich AM oder PM („11:51:02 AM“).

Stunden:Minuten:Sekunden [AM/PM]

%y

Letzten beiden Ziffern des Jahres („16“).

Bis zu vier Ziffern werden bis zu einem Trennzeichen oder dem Ende der Zeichenfolge gelesen und einem Bereich des aktuellen Jahres zugewiesen, 66 Jahre vor dem aktuellen Jahr bis 33 Jahre danach. Für 2016 bedeutet das beispielsweise 1950 bis 2049.

Einschränkung bei sechsstelligen Datumsangaben

Da für das Jahr bis zu vier Ziffern gelesen werden, werden bei Formaten, die für das Jahr nur zwei Ziffern ohne Trennzeichen enthalten sollen, wie ein sechsstelliger Datumsstempel (z. B. %y%m%d, für Daten wie „170522“ für den 22. Mai 2017), weiterhin vier Ziffern gelesen. Diese Einschränkung können Sie wie folgt umgehen:

  • Verwenden Sie für das Jahr vier Ziffern (z. B. 2017 anstelle von 17), abhängig von Ihrem Datumsbereich.

  • Verwenden Sie das RegEx-Tool, um ein Leerzeichen nach den ersten beiden Ziffern in der Zeichenfolge einzufügen.

%Y

Alle vier Ziffern des Jahres („2016“).

Zwei oder vier Ziffern werden gelesen. Zwei Ziffern werden einem Bereich des aktuellen Jahres zugewiesen – minus 66 vom aktuellen Jahr, plus 33. Für 2024 bedeutet das beispielsweise 1958 bis 2057.

%z

Offset zur UTC-Zeit („-600“).

Unterstützt für Eingabe.

%Z

Vollständiger Zeitzonenname („Mountain Daylight Time”).

Unterstützt für Eingabe.

Trennzeichen

Trennzeichen werden zwischen Datum/Uhrzeit-Bezeichnern eingefügt, um eine Formatzeichenfolge zu bilden.

Trennzeichen

Ausgabe von Datum/Uhrzeit-Format

Mit „DateTimeParse“ unterstützte Eingabe*

/

/

/ or -

-

-

/ or -

space

Ein Leerzeichen

Eine beliebige Folge von Leerzeichen.

%n

Eine neue Zeile

Nicht unterstützt

%t

Ein Tabulator

Nicht unterstützt

sonstige

Sonstige Zeichen, z. B. Komma, Punkt und Doppelpunkt.

Sonstige Zeichen, z. B. Komma, Punkt und Doppelpunkt.

*DateTimeParse akzeptiert Schrägstriche (/) und Bindestriche (-) als untereinander austauschbar. Kommas, Doppelpunkte und alle anderen Trennzeichen müssen jedoch exakt mit den eingehenden Daten übereinstimmen.

Schlüsselwörter für Datum/Uhrzeit-Einheiten

Diese Schlüsselwörter sind mit den Funktionen DateTimeAdd, DateTimeDiff und DateTimeTrim kompatibel. Dabei wird nicht zwischen Groß- und Kleinschreibung unterschieden. Die akzeptierten Schlüsselwörter für jede Einheit sind durch Komma getrennt.

In einigen Fällen akzeptieren wir Abkürzungen bis zum vollständigen Schlüsselwort. Diese werden mit upto in der Liste unten angegeben und reichen von der kürzesten akzeptablen Abkürzung bis zum vollständigen Schlüsselwort. Für Sekunden akzeptieren wir beispielsweise sec und seconds, sowie alles dazwischen, wie seco. Bitte beachten Sie, dass Schlüsselwörter auf Englisch sind und Übersetzungen in andere Sprachen nicht unterstützt sind.

Sie können auch numerische Werte als Schlüsselwörter für Zeiträume unter Sekunden verwenden. Dazu gehören Einheiten, die in der folgenden Liste nicht ausdrücklich aufgeführt sind. Beispiel: Sie können das Schlüsselwort "10" verwenden, um 10 Dezimalstellen anzugeben.

  • yea upto years

  • mon upto months

  • day, days

  • hou upto hours

  • min upto minutes

  • sec upto seconds

  • ds, dsec, dsecs, deciseconds, 1

  • cs, csec, csecs, centiseconds, 2

  • ms, msec, msecs, milliseconds, 3

  • us, usec, usecs, microseconds, 6

  • ns, nsec, nsecs, nanoseconds, 9

  • ps, psec, psecs, picoseconds, 12

  • fs, fsec, fsecs, femtoseconds, 15

  • as, asec, asecs, attoseconds, 18

Einige Beispiele für die Größe von DateTime-Feldern mit verschiedenen Präzisionseinheiten finden Sie in dieser Tabelle:

Name

Abkürzung

Datum/Uhrzeit-Größe

Beispiel

Sekunden

sec

19 (Standard)

2023-02-24 01:23:45

Dezisekunden (1)

ds, dsec, dsec

21 (19 + 1 + 1)

2023-02-24 01:23:45.1

Zentisekunden (2)

cs, csec, csecs

22 (19 + 1 + 2)

2023-02-24 01:23:45.12

Millisekunden (3)

ms, msec, msecs

23 (19 + 1 + 3)

2023-02-24 01:23:45.123

Mikrosekunden (6)

us, usec, usecs

26 (19 + 1 + 6)

2023-02-24 01:23:45.123456

Nanosekunden (9)

ns, nsec, nsecs

29 (19 + 1 + 9)

2023-02-24 01:23:45.123456789

Pikosekunden (12)

ps, psec, psecs

32 (19 + 1 + 12)

2023-02-24 01:23:45.123456789012

Femtosekunden (15)

fs, fsec, fsecs

35 (19 + 1 + 15)

2023-02-24 01:23:45.123456789012345

Attosekunden (18)

as, asec, asecs

38 (19 + 1 + 18)

2023-02-24 01:23:45.123456789012345678

Sprachparameter

Dies sind die kompatiblen Werte für den Parameter „l“ (Sprache), der von den Funktionen DateTimeFormat und DateTimeParse unterstützt wird.

Englischer Sprachenname

Name der Muttersprache

Sprachcode

Englisch

Englisch

en

Italienisch

Italiano

it

Französisch

Français

fr

Deutsch

Deutsch

de

Japanisch

日本語

ja

Spanisch

Español

es

Portuguese

Português

pt

Chinese

简体中文

zh

Zusätzlich zu den oben genannten Werten sind auch Werte mit einer Länge von mindestens zwei Zeichen zulässig, die mit einem der oben genannten beginnen. Zum Beispiel, eng, engl, engli, usw. für Englisch oder esp, espa, sp, spa, span, usw. für Spanisch/Español.

Zeitzonenbenennung

Es gibt viele Stile für die Benennung von Zeitzonen. Die Namen können lang (Mountain Time), kurz (MT), spezifisch (MDT, MST) oder generisch (MT) sein. Die Internet Assigned Names Authority (IANA) verwaltet eine Datenbank mit Zeitzoneninformationen. Der Namensstil ist Region/Stadt (z. B. Amerika/Los Angeles, Europa/Paris).

Zeitinformationen können auch mit dem Versatz in Bezug auf die koordinierte Weltzeit (UTC) gekennzeichnet werden. Beispiel: 11:31-0500 ist eine Zeitzone, die 5 Stunden hinter UTC liegt (der gleiche Moment in UTC ist 16:31). Diese Zeit kann Central Daylight Time, Eastern Standard Time oder Peru Time sein. Der IANA-Stil ist der kanonische Name für eine Zeitzone. Andere Namen können je nach Gebietsschema des Benutzers akzeptiert werden.

Alteryx verwendet eine weit verbreitete Bibliothek (ICU), um Zeitzoneninformationen abzurufen. Wenn Ihr Workflow auf eine Zeitzone verweist, die nicht gefunden werden kann, meldet der Workflow einen Fehler.

Warnung

Bitte beachten Sie, dass kurze Namen nicht eindeutig sein können. IST kann beispielsweise Indisch, Israel oder Irland Standardzeit sein. Seien Sie daher bei den Eingabedaten vorsichtig.

Alteryx empfiehlt, kurze Zeitzonennamen durch lange Namen oder Namen im IANA-Stil zu ersetzen, um sicherzustellen, dass Ihre Daten ordnungsgemäß verarbeitet werden. Dazu können Sie das Suchen-Ersetzen-Tool verwenden.

Um eine Zeitzone anhand des Namens zu finden, wenn die Designer-Sprache auf eine andere Sprache als Englisch eingestellt ist (über Benutzereinstellungen > Sprache und Region), fordert Alteryx ICU zunächst auf, die Zeitzone in dieser Sprache zu suchen. Wenn die Zeitzone in dieser Sprache nicht gefunden wird, bittet Alteryx ICU, die Zeitzone auf Englisch zu suchen. Es kommt vor, dass in einigen Regionen englische Abkürzungen verwendet werden, auch wenn die lokale Sprache einen langen Namen für die Zone hat.

Alteryx versucht außerdem, den Namen in jeder unterstützten Sprache zu suchen, beginnend mit der Sprache der Designer-Benutzeroberfläche (oder der in der Funktion angegebenen Sprache).

Tipp

Sie sollten sich der Namen bewusst sein, die für Zeitzonen in Ihren Daten verwendet werden, und möglicherweise das Suchen-Ersetzen-Tool verwenden, um sicherzustellen, dass Sie die richtigen Namen für Zeitzonen erhalten.

Änderung der Zeitzone und Sommerzeit/Standardzeit

Änderungen von Zeitzonen mit Sommerzeit/Standardzeit sind mit Komplikationen verbunden, wenn versucht wird, Zeiten nahe der Umstellung von Sommerzeit auf Standard und umgekehrt zu interpretieren.

Auf Sommerzeit umstellen

Es gibt eine Stunde bei der Umstellung auf die Sommerzeit, die ungültig ist. In den USA werden die Uhren, wenn die lokale Standardzeit kurz vor dem Erreichen von 10. März 2024, 2:00:00 Uhr ist, 1 Stunde vor auf 10. März 2024 3:00:00 Uhr lokale Sommerzeit gestellt.

So gab es z. B. keine 2024-03-10 02:30:00 Eastern Time. Diese Zeit ist ungültig – es gibt keine solche Zeit. Alteryx Bibliotheken erkennen dieses Problem jedoch nicht. Wenn Sie DateTimeToUTC('2024-03-10 02:30:00', 'Eastern Time') konvertieren, wendet der Code den Versatz für die Standardzeit (5 Stunden) an und gibt 2024-03-10 07:30:00 ohne Warnung vor der ungültigen Eingabe zurück.

Auf Standardzeit umstellen

Es gibt eine Stunde bei der Umstellung auf Standardzeit, die nicht eindeutig ist. In den USA werden die Uhren, wenn die örtliche Sommerzeit kurz vor dem Erreichen von 3. November 2024 2:00:00 Uhr ist, 1 Stunde zurück auf 3. November 2024 1:00:00 Uhr lokale Standardzeit gestellt.

2024-11-03 01:30:00 Eastern Time kann entweder Eastern Standard Time oder Eastern Daylight Time sein. Da es sich um einen sehr häufigen Fehler handelt, EST für eine Zeit anzugeben, die tatsächlich Sommerzeit ist, oder EDT für eine Zeit, die tatsächlich Standard ist, ignorieren die Bibliotheken die Saisonspezifikation im Allgemeinen beim Suchen nach Zeitzoneninformationen.

Aus diesem Grund kann Alteryx die mehrdeutige Stunde nicht von Eastern Time in UTC konvertieren, indem die angegebene Saison korrekt verwendet wird. Es wendet den Versatz für die Standardzeit (5 Stunden) an, unabhängig davon, ob EST oder EDT als Zeitzone angegeben ist, also ...

  • DateTimeToUTC('2024-11-03 01:30:00', 'Eastern Daylight Time') gibt „2024-11-03 06:30:00“ zurück.

  • DateTimeToUTC('2024-11-03 01:30:00', 'Eastern Standard Time') gibt „2024-11-03 06:30:00“ zurück.

  • DateTimeToUTC('2024-11-03 01:30:00', 'Eastern Time') gibt „2024-11-03 06:30:00“ zurück.

Hinweise und Einschränkungen

Datumsunterstützung

Alteryx Designer kann Daten vor dem 1. Januar 1400 nicht verarbeiten.

Alteryx unterstützt Termine in Jahren von 1400 bis 9999. Wir gehen davon aus, dass alle Termine im Gregorianischen Kalender liegen, der derzeit in den meisten Ländern der Welt verwendet wird. Bei allen Berechnungen (Addieren und Subtrahieren) werden Schaltsekunden ignoriert.