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 ISO-Format yyyy-mm-dd 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
yyyy-mm-dd HH:MM:SS.5
. 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
.
Date Format
Bei einigen Datum/Uhrzeit-Funktionen müssen Sie das Format für das Datum einstellen. Formatzeichenfolgen bestehen aus Angaben 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, ausgedrückt als ausgewählte Spalte oder angegebener Datum/Uhrzeit-Wert in Anführungszeichen.
i
: Positive oder negative ganze Zahl der Zeit zum Addieren oder Subtrahieren.
u
: Datum/Uhrzeit-Einheit (unit), die zwischen Anführungszeichen mit Schlüsselwörtern angegeben wird, die im Abschnitt
Schlüsselwörter für Datum/Uhrzeit-Einheiten
aufgeführt sind.
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 anzeigen
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. Beispielsweise ändert das Hinzufügen von Stunden nicht den Wert von Minuten oder Sekunden. 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.
This function performs calculations as if the time zone does not have time changes related to Daylight and Standard time. This might produce unexpected results if your calculation includes dates and times when the time changes from Daylight to Standard or vice versa. If the precision of the actual time that passes is critical, you should first convert your data to UTC.
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, ausgedrückt als ausgewählte Spalte oder angegebener Datum/Uhrzeit-Wert in Anführungszeichen.
Beispiel
DateTimeDay("2017-03-24 11:43:23")
gibt 24 zurück.
DateTimeDiff
DateTimeDiff(dt1,dt2,u)
: subtrahiert das zweite Argument vom ersten und gibt es als ganzzahlige Differenz zurück. Die Dauer wird als Zahl, nicht als eine Zeichenfolge, in den angegebenen Zeiteinheiten zurückgegeben.
Parameter
dt
: Datum/Uhrzeit-Daten, ausgedrückt als ausgewählte Spalte oder angegebener Datum/Uhrzeit-Wert in Anführungszeichen.
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") returns 3.
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 anzeigen
Bei unterschiedlichen Monaten und Jahren wird ein Monat nur dann gezählt, wenn der Endtag den Starttag erreicht. Die Tageszeit wird dabei ignoriert.
Für die Genauigkeit von Tag, Stunde, Minute und Sekunde wird das Ergebnis genau berechnet, dann werden Bruchteile abgeschnitten, nicht gerundet. 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.
Seien Sie vorsichtig, wenn Sie Zeitunterschiede in Sekunden speichern. Ein Int32 kann nur eine Differenz von 68 Jahren in Sekunden oder 4082 Jahren in Minuten halten. Sie können ein Double oder ein Int64 verwenden, um Intervalle zwischen allen unterstützten Daten zu bewahren.
This function performs calculations as if the time zone does not have time changes related to Daylight and Standard time. This might produce unexpected results if your calculation includes dates and times when the time changes from Daylight to Standard or vice versa. If the precision of the actual time that passes is critical, you should first convert your data to UTC.
DateTimeFirstOfMonth
DateTimeFirstOfMonth()
: gibt den ersten Tag des Monats um Mitternacht zurück.
DateTimeFormat
DateTimeFormat(dt,f,l)
: konvertiert Datum/Uhrzeit-Daten vom ISO-Format in ein anderes angegebenes Format (f), in einer angegebenen Sprache (l) zur Verwendung durch eine andere Anwendung. Ausgabe in einen Zeichenfolgen-Datentyp. Wenn das spezifizierte Format eine geringere Präzision aufweist, wird die Ausgabe abgeschnitten.
Parameter
dt
: Datum/Uhrzeit-Daten, ausgedrückt als ausgewählte Spalte oder angegebener Datum/Uhrzeit-Wert in Anführungszeichen.
f
: Das Format, in das die Daten konvertiert werden sollen, ausgedrückt in einer Formatzeichenfolge.
l
: Optionaler Sprachparameter. Der Sprachparameter wird standardmäßig auf Ihre gewählte Designer-Sprache eingestellt. Wenn Designer beispielsweise auf Französisch eingestellt ist, lautet die Funktion standardmäßig
DateTimeParse(dt,f,"Français")
. Siehe
Sprachparameter
für akzeptierte Sprachwerte.
tz: This is an optional time zone parameter. Note that the data is not converted. This is simply to guide the style of the text added to the string.
The time zone identifier determines what offset to show if you use the offset format instruction (%z) or to get a name for the time zone to show if you use the time zone name format instruction (%Z).
The time zone name preserves the style of the argument: short (like EST), long (like Eastern Standard Time), generic (like ET), or specific (like EST/EDT).
The name is modified to match the correct season for the data. For example, if the tz is provided as EST for 2024-08-15, it is corrected to EDT. Similarly, for 2024-01-15, if the tz is provided as EDT, it is corrected to EST. For both of these examples, if the tz is provided as a generic ET it is not changed to show whether it is Daylight or Standard time.
If the tz is not provided in the function call, the system time zone is used.
Beispiel
DateTimeFormat([DateTime_Out],"%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') returns 'Mar 10, 24 01:00:00 ET'. The style of the time zone argument is short and generic, so that is used in the result.
DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %Z', '', 'EDT') returns 'Mar 10, 24 01:00:00 EST'. The style of the time zone argument is short and specific. It's incorrect for the time of the data. The result gets the specific time zone offset corrected.
DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %Z', '', 'Eastern Time') returns 'Mar 10, 24 01:00:00 Eastern Time’. The style is kept, and no shift needs to be corrected.
DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %Z', '', 'Eastern Daylight Time') returns 'Mar 10, 24 01:00:00 Eastern Standard Time’. The time zone shift is corrected.
DateTimeFormat('2024-03-10 01:00:00', '%b %d, %y %T %z', '', 'ET') returns 'Mar 10, 24 01:00:00 -0400’.
DateTimeHour
DateTimeHour(dt)
: gibt die Stundenzahl der Uhrzeit in einem Datum/Uhrzeit-Wert zurück.
Parameter
dt
: Datum/Uhrzeit-Daten, ausgedrückt als ausgewählte Spalte oder angegebener Datum/Uhrzeit-Wert in Anführungszeichen.
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 Uhr auf eine Sekunde vor dem Ende des Tages (23:59:59) eingestellt ist.
Designer verwendet das Datum und die Uhrzeit, wenn die Formel zum ersten Mal geparst wird. In einem Batch-Prozess wird diese Zeit bei jedem neuen Datensatz 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, ausgedrückt als eine ausgewählte Spalte oder ein angegebener Datum/Uhrzeit-Wert zwischen Anführungszeichen.
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, ausgedrückt als ausgewählte Spalte oder angegebener Datum/Uhrzeit-Wert in Anführungszeichen.
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.
Zeitstempel-Tool
DateTimeNow()
: gibt das aktuelle Systemdatum und die aktuelle Systemuhrzeit auf die Sekunde genau zurück.
Parameters
tz: (Optional) Provide a time zone for the returned time. If provided, the returned time uses that time zone. If omitted, the returned time uses your system time zone.
DateTimeNowPrecise
DateTimeNowPrecise()
: gibt das aktuelle Systemdatum und die aktuelle Systemuhrzeit mit Sekundenbruchteilen zurück (bis zu einer Präzision von 18 Stellen). 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.
Note that if you request precision beyond what your operating system provides, the function fills in the remainder with zeros, like in the second example below.
Parameters
digits: Specify the precision of the returned value, between 0 and 18 (inclusive).
tz: (Optional) Provide a time zone for the returned time. If provided, the returned time uses that time zone. If omitted, the returned time uses your system time zone.
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)
: konvertiert eine Datumszeichenfolge (Zeichenfolge) mit dem angegebenen Format (f), in einer angegebenen Sprache (l), in das Standard-ISO-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, ausgedrückt als ausgewähltes Feld oder Datum/Uhrzeit-Zeichenfolge in Anführungszeichen. 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.
Time Zones
If the incoming format includes %z or %Z, Alteryx knows the input time zone. It converts the DateTime result value into the local or specified time zone. If the format or data does not have time zone information, Alteryx assumes the input is already in the local time zone, and does not apply any time shifts.
Review your data and take appropriate steps to ensure that your output is in the format you expect. For important time zone considerations, go to Time Zone and Daylight/Standard Time Changes.
l
: (optional) die Sprache der eingehenden Datum-Zeichenfolgendaten, die Sie konvertieren. Der Sprachparameter wird standardmäßig auf Ihre gewählte Designer-Sprache eingestellt. 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) The time zone to convert the data to if %z or %Z is in the format and the text has the name of a time zone or an offset in it. The examples will help to clarify this. If the time zone is omitted, the system time zone is used for conversion.
Beispiel
DateTimeParse("2016/28-03","%Y/%d-%m")
gibt 2016-03-28 zurück
DateTimeParse([DateTimeNow],"%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 '2022-10-04 11:59:57.000' und eine Warnung zurück, dass ',' erwarted wurde anstatt '.'
DateTimeParse('Mar 10, 24 01:00:00 PST', '%b %d, %y %T %Z') returns '2024-03-10 04:00:00’ if the local time zone is Eastern.
DateTimeParse('Mar 12, 24 01:00:00 PST', '%b %d, %y %T %Z') returns ‘2024-03-12 05:00:00’ If the local time zone is Eastern because Eastern time has already changed to EDT (Eastern Daylight Time).
DateTimeParse('Mar 10, 24 01:00:00', '%b %d, %y %T %Z') returns ‘2024-03-10 01:00:00’ if the local time zone is Eastern. Even though the format asked for time zone information, none was present in the data. Without knowing the time zone for the input data, no conversion is done.
DateTimeParse('Mar 10, 24 01:00:00 PST', '%b %d, %y %T') returns ‘2024-03-11 01:00:00’. As in the above example, if the format does not ask to use time zone information, any data that might have time zone data is ignored.
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, ausgedrückt als ausgewählte Spalte oder angegebener Datum/Uhrzeit-Wert in Anführungszeichen.
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, ausgedrückt als ausgewählte Spalte oder angegebener Datum/Uhrzeit-Wert in Anführungszeichen.
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.
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:
)
DateTimeToLocal
DateTimeToLocal(dt)
: konvertiert eine UTC-Datum/Uhrzeit-Angabe in die Zeitzone des lokalen Systems. Die DateTimeToLocal-Funktion unterstützt derzeit keine Präzision für Datum/Uhrzeit im Feld
dt
.
Anmerkung
The result doesn't have any indication about what its time zone is. You need to use DateTimeFormat or modify the result as a string to indicate the time zone if desired. If you use DateTimeFormat, the tz argument should be a name for the same tz used in the conversion. It could use a different style like EST, or Eastern Daylight Time, or America/New_York, or ‘-0400’. For important time zone considerations, go to Time Zone and Daylight/Standard Time Changes.
Parameter
dt
: Datum/Uhrzeit-Daten, ausgedrückt als ausgewählte Spalte oder angegebener Datum/Uhrzeit-Wert in Anführungszeichen.
tz: This is an optional time zone parameter to convert the date-time data to. If (tz) is not provided in the function call, the system time zone is used.
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') converts the UTC time to the system time, which could be America/New_York, returns ‘2024-08-15 05:00:00.123’, or it could be America/Denver, returning ‘2024-08-03:00:00.123’.
DateTimeToLocal('2024-08-15 09:00:00.123', 'EST') converts the UTC time to Eastern Daylight Time, even though the time specified is Standard Time. The daylight/standard specification is ignored when looking up the time zone for the conversion, so this returns ‘2024-08-15 05:00:00.123’.
DateTimeToUTC
DateTimeToUTC(dt)
: konvertiert eine Datum/Uhrzeit-Angabe (in der Zeitzone des lokalen Systems) zu UTC. Die DateTimeToUTC-Funktion unterstützt derzeit keine Präzision für Datum/Uhrzeit im Feld
dt
.
Anmerkung
The result doesn't have any indication that it is in UTC. You need to use DateTimeFormat or modify the result as a string to indicate the time zone if desired. If you use DateTimeFormat, the tz argument should be a name for the same time zone used in the conversion. It could use a different style like UTC, GMT, or Z, or ‘+0000’. For important time zone considerations, go to Time Zone and Daylight/Standard Time Changes.
Parameter
dt
: Datum/Uhrzeit-Daten, ausgedrückt als ausgewählte Spalte oder angegebener Datum/Uhrzeit-Wert in Anführungszeichen.
tz: This is an optional time zone parameter. If the tz is not given in the function call, the system time zone is used.
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') converts the time to UTC from the system time, which can be America/New_York, returning ‘2024-08-15 13:00:00.123’, or America/Denver, returning ‘2024-08-15:00:00.123’.
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, ausgedrückt als ausgewählte Spalte oder angegebener Datum/Uhrzeit-Wert in Anführungszeichen.
t
: Trim-Typ (Zuschneiden-Typ) Die folgenden 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 Abschneiden (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 : 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 11:59:57.990 zurück.
DateTimeTrim('2016-12-07 11:59:57.99',4)
gibt 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, ausgedrückt als ausgewählte Spalte oder angegebener Datum/Uhrzeit-Wert in Anführungszeichen.
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.
Date-Time Function Reference
Refer to these specifiers, separators, keywords, and language parameters for use in date-time functions.
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
If you prefer to view an alphabetized list, you can do so below.
Bezeichner | Ausgabe im Datum/Uhrzeit-Format | Unterstützte Eingabe mit DateTimeParse |
|---|---|---|
Year | ||
| Last two digits of the year ("16"). | Up to 4 digits are read, stopping at a separator or the end of the string, and mapped to a range of the current year minus 66 to the current year plus 33. For example, in 2016, that's 1950 to 2049. Limitation with 6-Digit Dates Because up to 4 digits are read for the year, formats that are intended to have only 2 digits without a separator, such as a 6-digit date stamp (for example, %y%m%d for data resembling 170522 for May 22, 2017), are still read as 4 digits. To work around this limitation, you can...
|
| 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 2016 bedeutet das beispielsweise 1950 bis 2049. |
Month | ||
| 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 ist. |
| 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 ist. |
| Abbreviated Month Name. Same as %b ("Sep"). | Any valid abbreviation of a month name ("Sep", "SEPT."). Returns an error only if the given text is not the name of a month. |
| Monatsnummer, 01 bis 12. | Ein- oder zweistellige Monatsnummer, 1 oder 01 bis 12. |
Week | ||
| Dies gibt die Wochennummer als 00 - 53 zurück, mit dem Wochenanfang als Sonntag. | Nicht unterstützt |
| Gibt die Wochennummer als 00–53 mit dem Wochenbeginn am Montag zurück. | Nicht unterstützt |
Day of the Year/Month | ||
| Tag im Monat („01“) | Eine oder zwei Ziffern, wobei Leerzeichen ignoriert werden („1“ oder „01“). |
| Tag des Monats, eine führende 0 wird durch ein Leerzeichen ersetzt („ 1“). | Eine oder zwei Ziffern, wobei Leerzeichen ignoriert werden („1“ oder „01“). |
| 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) |
Day of the Week | ||
| 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. |
| 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. |
| Wochentag als Dezimal, 1 bis 7, Montag als 1. | Nicht unterstützt |
| Wochentag als Zahl, 0 bis 6, Sonntag als 0. | Nicht unterstützt |
Hour, Minute, Second | ||
| Stunde im 24-Stundenformat, 00 bis 23. | Bis zu zwei Ziffern für die Stunde, 0 bis 23. Nicht kompatibel mit %p oder %P. |
| Stunde im 12-Stundenformat, 01 bis 12. | Bis zu zwei Ziffern für die Stunde, 1 bis 12. Muss mit %p oder %P folgen. |
| 24 Stunden, führende Null wird durch Leerzeichen ersetzt, „ 0“ bis „23“. | Bis zu zwei Ziffern für die Stunde. |
| Minuten, 00 bis 59 | Bis zu zwei Ziffern für Minuten. |
| Sekunden, 00 bis 59 | Bis zu zwei Ziffern für Sekunden. |
Miscellaneous | ||
| Die Anzahl der Dezimalstellen für Sekundenbruchteile. | Bis zu 18 Stellen Präzision für Sekundenbruchteile. |
| Das Datum und die Uhrzeit für das Gebietsschema des Computers. | Nicht unterstützt |
| Die Jahrhundertzahl („20“) | Nicht unterstützt |
| Entspricht %m/%d/%y | Nicht unterstützt |
| 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. |
| 12 Stunden, führende Null wird durch Leerzeichen ersetzt, „ 1“ bis „12“. | Nicht unterstützt |
| „AM“ oder „PM“ | Keine Beachtung der Groß/Kleinschreibung („aM“ oder „Pm“). Muss %I folgen (großes „I“ wie „Ida“, Stunde im 12-Stundenformat). |
| „am“ oder „pm“ | Keine Beachtung der Groß/Kleinschreibung („aM“ oder „Pm“). Muss %I folgen (großes „I“ wie „Ida“, Stunde im 12-Stundenformat). |
| Zeit in 24-Stunden-Format. Entspricht %H:%M:%S | Nicht unterstützt |
| Das Datum für das Gebietsschema des Computers. | Nicht unterstützt |
| Die Uhrzeit im 12-Stunden-Format, einschließlich AM oder PM („11:51:02 AM“). | Hours:Minutes:Seconds [AM / PM] |
| Offset zur UTC-Zeit („-600“). | Nicht unterstützt |
| Vollständiger Zeitzonenname („Mountain Daylight Time”). | Nicht unterstützt |
Specifier | Output from DateTimeFormat | Supported Input with DateTimeParse |
|---|---|---|
| The number of digits of precision for sub-seconds. | Up to 18 digits of precision for sub-seconds. |
| Abbreviated Weekday Name ("Mon") | Any valid abbreviation of a day of the week ("mon", "Tues.", "Thur"). Returns an error only if the given text is not a day of the week. Note that Alteryx does not check that the specified day name is valid for a particular date. |
| Full Weekday Name ("Monday") | Day name or any valid abbreviation of a day of the week ("mon", "Tues.", "Thur"). Returns an error only if the given text is not a day of the week. Note that Alteryx does not check that the specified day name is valid for a particular date. |
| Abbreviated Month Name ("Sep") | Any valid abbreviation of a month name ("Sep", "SEPT."). Returns an error only if the given text is not the name of a month (in the specified language). |
| Full Month Name ("September") | Month name or any valid abbreviation of a month name ("Sep", "SEPT."). It returns an error only if the given text is not the name of a month (in the specified language). |
| The date and time for the computer’s locale. | Not Supported |
| The Century Number ("20") | Not Supported |
| Day of the Month ("01") | 1 or 2 digits, ignoring spaces ("1" or "01"). |
| Equivalent to %m/%d/%y | Not Supported |
| Day of the month, leading 0 replaced by a space (" 1"). | 1 or 2 digits, ignoring spaces ("1" or "01"). |
| Abbreviated Month Name. Same as %b ("Sep"). | Any valid abbreviation of a month name ("Sep", "SEPT."). Returns an error only if the given text is not a name of a month. |
| Hour in 24-hour clock, 00 to 23. | Up to 2 digits for hour, 0 to 23. Not compatible with %p or %P. |
| Hour in 12-hour clock, 01 to 12. | Up to 2 digits for hour, 1 to 12. Must follow with %p or %P. |
| The day of the year, from 001 to 365 (or 366 in leap years). | 3-digit day of the year, from 001 to 365 (or 366 in leap years). |
| 24 hours, leading zero is space, " 0" to "23". | Up to 2 digits for hour. |
| 12 hours, leading zero is space, " 1" to "12". | Not Supported |
| Minutes, 00 to 59 | Up to 2 digits for minutes. |
| Month number, 01 to 12. | 1 or 2-digit month number, 1 or 01 to 12. |
| "AM" or "PM" | Case blind ("aM" or "Pm"). Must follow %I (capital "eye", hour in 12-hour format). |
| "am" or "pm" | Case blind ("aM" or "Pm"). Must follow %I (capital "eye", hour in 12-hour format). |
| Seconds, 00 to 59 | Up to 2 digits for seconds. |
| Time in 24-hour notation. Equivalent to %H:%M:%S | Time in 24-hour notation. Equivalent to %H:%M:%S |
| Day of week as a decimal, 1 to 7, with Monday as 1. | Not Supported |
| This returns the week number, as 00–53, with the beginning of weeks as Sunday. | Not Supported |
| Day of week as a number, 0 to 6, with Sunday as 0. | Not Supported |
| This returns the week number, as 00–53, with the beginning of weeks as Monday. | Not Supported |
| The date for the computer’s locale. | Not Supported |
| The 12-hour clock time, including AM or PM ("11:51:02 AM"). | Hours:Minutes:Seconds [AM/PM] |
| Last two digits of the year ("16"). | Up to 4 digits are read, stopping at a separator or the end of the string, and mapped to a range of the current year minus 66 to the current year plus 33. For example, in 2016, that's 1950 to 2049. Limitation with 6-Digit Dates Because up to 4 digits are read for the year, formats that are intended to have only 2 digits without a separator, such as a 6-digit date stamp (for example, %y%m%d for data resembling 170522 for May 22, 2017), are still read as 4 digits. To work around this limitation, you can...
|
| All four digits of the year ("2016"). | Two or four digits are read. Two digits are mapped to a range from the current year minus 66 to the current year plus 33. For example, in 2024, that's 1958 to 2057. |
| Offset from UTC time ("-600"). | Supported for input. |
| Full timezone name ("Mountain Daylight Time"). | Supported for input. |
Trennzeichen
Trennzeichen werden zwischen Datum/Uhrzeit-Bezeichnern eingefügt, um eine Formatzeichenfolge zu bilden.
Trennzeichen | Ausgabe im Datum/Uhrzeit-Format | Unterstützte Eingabe mit DateTimeParse* |
|---|---|---|
| / | / or - |
| - | / or - |
Leerzeichen | Ein Leerzeichen | Eine beliebige Folge von Leerzeichen. |
| Eine neue Zeile | Nicht unterstützt |
| 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 genau 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. Bei Schlüsselwörtern 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 yearsmon upto monthsday, dayshou upto hoursmin upto minutessec upto secondsds, dsec, dsecs, deciseconds, 1cs, csec, csecs, centiseconds, 2ms, msec, msecs, milliseconds, 3us, usec, usecs, microseconds, 6ns, nsec, nsecs, nanoseconds, 9ps, psec, psecs, picoseconds, 12fs, fsec, fsecs, femtoseconds, 15as, 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 |
| 19 (Standard) | 2023-02-24 01:23:45 |
Dezisekunden (1) |
| 21 (19 + 1 + 1) | 2023-02-24 01:23:45.1 |
Zentisekunden (2) |
| 22 (19 + 1 + 2) | 2023-02-24 01:23:45.12 |
Millisekunden (3) |
| 23 (19 + 1 + 3) | 2023-02-24 01:23:45.123 |
Mikrosekunden (6) |
| 26 (19 + 1 + 6) | 2023-02-24 01:23:45.123456 |
Nanosekunden (9) |
| 29 (19 + 1 + 9) | 2023-02-24 01:23:45.123456789 |
Pikosekunden (12) |
| 32 (19 + 1 + 12) | 2023-02-24 01:23:45.123456789012 |
Femtosekunden (15) |
| 35 (19 + 1 + 15) | 2023-02-24 01:23:45.123456789012345 |
Attosekunden (18) |
| 38 (19 + 1 + 18) | 2023-02-24 01:23:45.123456789012345678 |
Sprachparameter
Dies sind die kompatiblen Werte für den Parameter „l“ (Sprache), der mit den Funktionen DateTimeFormat und DateTimeParse unterstützt wird.
Englischer Sprachenname | Name der Muttersprache | Sprachcode |
|---|---|---|
English | English | en |
Italienisch | Italiano | it |
Französisch | Français | fr |
German | Deutsch | de |
Japanese | 日本語 | ja |
Spanish | 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.
Time Zone Naming
There are many styles for naming time zones. Names can be long (Mountain Time), short (MT), specific (MDT, MST), or generic (MT). The Internet Assigned Names Authority (IANA) maintains a database of time zone information. Its style of name is Region/City (for example, America/Los Angeles, Europe/Paris).
Time information can also be marked with its offset relative to Coordinated Universal Time (UTC). For example, 11:31-0500 is a time zone that is 5 hours behind UTC (the same moment in UTC is 16:31). This time could be Central Daylight Time, Eastern Standard Time, or Peru Time. The IANA style is the canonical name for a time zone. Other names might be accepted depending on the user’s locale.
Alteryx uses a widely used library (ICU) to look up time zone information. If your workflow references a time zone that can't be found, the workflow reports an error.
Warnung
Please be aware that short names can be ambiguous. For example, IST can be Indian, Israel, or Ireland Standard Time. As such, be careful with your input data.
Alteryx recommends replacing short time zone names with long or IANA-style names to ensure that your data is handled properly. You can use the Find Replace tool to do this.
To find a time zone by name, if the Designer language is set to a language other than English (via User Settings > Language and Region), Alteryx first asks ICU to look up the time zone using that language. If it fails to find the time zone with that language, Alteryx then asks ICU to look up the time zone using English. It happens that in some regions, English abbreviations are used even when the local language has a long name for the zone.
Alteryx also attempts to look up the name in each supported language, starting with the Designer interface language (or the language specified in the function).
Tipp
You should be aware of the names used for time zones in your data, and possibly use the Find-Replace tool to ensure that you get appropriate names for time zones.
Time Zone and Daylight/Standard Time Changes
Time zones that have daylight and standard time changes encounter complications when trying to interpret times near the shift from daylight to standard and vice versa.
Shift to Daylight Time
There is an hour around the shift to daylight time (Summer) that is invalid. In the US when local standard time was about to reach March 10, 2024, 2:00:00 AM, clocks were turned forward 1 hour to March 10, 2024, 3:00:00 AM local daylight time instead.
As a result, there was no 2024-03-10 02:30:00 Eastern Time, for example. This time is invalid—there is no such time. However, Alteryx libraries don't detect this problem. If you convert DateTimeToUTC('2024-03-10 02:30:00', 'Eastern Time'), the code applies the offset for standard time (5 hours), and returns '2024-03-10 07:30:00' without any warning of the invalid input.
Shift to Standard Time
There is an hour at the shift to standard time that is ambiguous. In the US, when local daylight time is about to reach November 3, 2024, 2:00:00 AM, clocks are turned backward 1 hour to November 3, 2024, 1:00:00 AM local standard time instead.
2024-11-03 01:30:00 Eastern Time can be either Eastern Standard Time or Eastern Daylight Time. Since it is a very common error to specify EST for a time that is really in Daylight, or EDT for a time that is really Standard, the libraries generally ignore the season specification when looking up time zone information.
As a result, Alteryx can't convert the ambiguous hour from Eastern Time to UTC by using the specified season correctly. It applies the offset for standard time (5 hours) regardless of whether EST or EDT is specified as the time zone to use, that is...
DateTimeToUTC('2024-11-03 01:30:00', 'Eastern Daylight Time')returns 2024-11-03 06:30:00.DateTimeToUTC('2024-11-03 01:30:00', 'Eastern Standard Time')returns 2024-11-03 06:30:00.DateTimeToUTC('2024-11-03 01:30:00', 'Eastern Time')returns 2024-11-03 06:30:00.
Notes and Limitations
Datumsunterstützung
Designer kann Daten vor dem 1. Januar 1400 nicht verarbeiten.
Alteryx supports dates in years from 1400 to 9999. We assume all dates are in the Gregorian Calendar, which is the civil calendar used now in most of the world. All computations (adding and subtracting) ignore leap seconds.