Datums- und Zeitfunktionen in Jitterbit Design Studio

Einführung

Wenn Sie diese Funktionen zusammen mit den Funktionen Now oder Now_ verwenden, beachten Sie, dass die zurückgegebene Zeitzone die auf dem Computer konfigurierte ist, auf dem der Agent läuft. Alle Cloud-Agenten befinden sich in UTC. Private Agenten variieren je nach dem spezifischen Computer, auf dem jeder Agent läuft. Wenn Sie eine Konvertierungsfunktion verwenden, berücksichtigen Sie dies, wenn Ihr Projekt sowohl in der Cloud als auch auf einem privaten Agent ausgeführt werden soll.

Zeitzonencodes

Die Zeitzonenparameter sind einer der Standard-Zeitzonencodes, entweder ein vollständiger Name (TZ-Code) wie "America/Los_Angeles", ein UTC-Offset wie "UTC-8:00" oder eine Abkürzung wie „PST" (dreistelliger Code). Zeitzonencodes unterscheiden zwischen Groß- und Kleinschreibung. Vollständige TZ-Codes werden empfohlen, wenn eine Zeitzone verwendet wird, da „AST" sich auf entweder „Atlantic" oder „Arabic" Standard Time beziehen kann.

• TZ-Codes (eine inoffizielle Liste) finden Sie unter https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
• Dreistellige Codes sind unter https://en.wikipedia.org/wiki/List_of_time_zone_abbreviations aufgelistet. Diese sind durch die IANA veraltet, werden aber derzeit unterstützt.
• Weitere Informationen finden Sie unter https://www.iana.org/time-zones.

UNIX-Zeiten in Daten konvertieren

Wenn eine UNIX-Zeit eine Zahl ist, die Millisekundengenauigkeit enthält, können Sie Code wie diesen verwenden, um eine UNIX-Zeit in ein Datum zu konvertieren:

// If you have a UNIX timestamp with milliseconds such as
createdate = "1478119530707";
// You can convert it to a date by
// truncating the last three digits and using FormatDate:
date = double(Left(createdate, 10));
FormatDate(date, "yyyy-mm-dd");

ConvertTimeZone

Deklaration

string ConvertTimeZone(date d, string fromTZ, string toTZ[, bool is_european_format, bool ignoreDST])

string ConvertTimeZone(string d, string fromTZ, string toTZ[, bool is_european_format, bool ignoreDST])

Syntax

ConvertTimeZone(<d>, <fromTZ>, <toTZ>[, <is_european_format>, <ignoreDST>])

Erforderliche Parameter

• date: Ein Datum, entweder als Datumsobjekt oder als Datumstring
• fromTZ: Die Zeitzone, aus der konvertiert werden soll, ausgedrückt als Zeitzonecode
• toTZ: Die Zeitzone, in die konvertiert werden soll, ausgedrückt als Zeitzonecode

Optionale Parameter

• is_european_format: Dieses optionale Flag bestimmt, ob das europäische Datumsformat verwendet werden soll. Wenn true, ist das Format Tag und dann Monat; wenn false, ist das Format Monat und dann Tag.

• ignoreDST: Standardmäßig wird die Sommerzeit bei der Konvertierung zwischen den vier wichtigsten US-Zeitzonen berücksichtigt. Setzen Sie dieses optionale Flag auf true, um diese Aktion zu überschreiben.

Beschreibung

Nimmt ein Datum und gibt es konvertiert von einer Zeitzone in eine andere Zeitzone zurück. Mit Agenten Version 12.8 und später wird Mitternacht (00:00:00) als gültiger Zeitwert behandelt, daher wird sie im zurückgegebenen String auf die gleiche Weise beibehalten wie jede andere Zeit. Mit Agenten Version 12.9 und später werden auch Millisekunden in der Eingabe im zurückgegebenen String beibehalten; zuvor wurden sie immer gelöscht. Ein Millisekunden-Wert von genau .000 wird aus dem zurückgegebenen String weggelassen.

Beispiele

ConvertTimeZone(Now(), "UTC", "America/Los_Angeles", false, false);
// If Now() is 2017-03-10 18:34:37
// returns "2017-03-10 10:34:37"

ConvertTimeZone("02/06/2017 5:25:00", "America/Los_Angeles", "America/New_York");
// returns "2017-02-06 08:25:00" (shifts the time by 3 hours)

ConvertTimeZone("2025-04-17 00:00:00", "UTC", "UTC");
// returns "2025-04-17 00:00:00" (the time is preserved, not truncated to "2025-04-17")

ConvertTimeZone("2025-04-17 12:08:41.982", "UTC", "America/Chicago");
// returns "2025-04-17 07:08:41.982" (milliseconds are preserved, not dropped)

CVTDate

Deklaration

string CVTDate(date d, string inputFormat, string outputFormat)

string CVTDate(string d, string inputFormat, string outputFormat)

Syntax

CVTDate(<d>, <inputFormat>, <outputFormat>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge
• inputFormat: Eine Formatzeichenfolge, die das Format des Eingabedatums angibt
• outputFormat: Eine Formatzeichenfolge, die das Format des Ausgabedatums angibt

Beschreibung

Konvertiert ein Datumsobjekt oder eine Datumzeichenfolge im Eingabeformat in eine Datumzeichenfolge im Ausgabeformat.

Wenn ein leeres Datumsobjekt oder eine leere Datumzeichenfolge für d bereitgestellt wird, gibt die Funktion mit Agent-Version 11.39 und später ein leeres Objekt zurück.

Beispiele

In diesen Beispielen wird davon ausgegangen, dass alle Agents in der Cloud ausgeführt werden und die zurückgegebenen Zeiten UTC sind. "myDate" ist das Datum 19. Juni 1994.

Formatzeichenfolgen

Das Format sowohl der Eingabedatumzeichenfolge als auch der Ausgabedatumzeichenfolge wird auf die gleiche Weise angegeben, indem entweder Zeichen für Platzhalter oder eines der vier vordefinierten Datumsformate (GeneralDate, LongDate, MediumDate oder ShortDate) verwendet wird.

Bei Eingaben werden Jahr, Monat, Tag, Stunde, Minute, Sekunde und AM/PM aus der Datumzeichenfolge an der Position gelesen, an der y, m, d, H, M, S, SSS und AP in der Eingabeformatzeichenfolge erscheinen.

Bei Ausgaben wird die Formatzeichenfolge in die Datumzeichenfolge kopiert, wobei Jahr, Monat, Tag, Stunde, Minute und Sekunde die Zeichen y, m, d, H, M, S, SSS und AP ersetzen.

Alternativ können die Ersetzungen der ANSI-C-Methode strftime verwendet werden. Beispielsweise würde die Zeichenkette "%Y-%m-%d" das ISO-8601-Datumsformat (yyyy-mm-dd) ergeben. Weitere Informationen finden Sie in der externen Dokumentation zu strftime.

Diese Codes können nach Bedarf in der Formatzeichenkette verwendet werden, um anzugeben, wie die Eingabe gelesen oder die Ausgabe geschrieben werden soll:

DateAdd

Deklaration

string DateAdd(string datePart, int number, date d)

string DateAdd(string datePart, int number, string d)

Syntax

DateAdd(<datePart>, <number>, <d>)

Erforderliche Parameter

• datePart: Ein Teilcode, der den Teil des Datums beschreibt, auf den die Addition angewendet werden soll
• number: Eine Ganzzahl, die zum Datumsteil addiert werden soll
• d: Das Datumsobjekt oder eine Datumszeichenkette, auf die die Operation angewendet werden soll

Beschreibung

Gibt eine Datumszeichenkette zurück, nachdem eine Zahl zu einem bestimmten Teil eines Datumsobjekts addiert wurde.

Diese Codes werden verwendet, um die Datumsteile zu beschreiben:

Beispiele

DateAdd("yyyy", 1, Now());
// Adding one year to a date
// If Now() is 2017-03-10 18:46:41
// returns "2018-03-10 18:46:41"

DateAdd("dd", 1, "2017-03-10");
// Adding one day to a date
// returns "2017-03-11"

DayOfMonth

Deklaration

int DayOfMonth(date d)

int DayOfMonth(string d)

Syntax

DayOfMonth(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumszeichenkette

Beschreibung

Gibt den Tag des Monats (1-31) eines Datumsobjekts oder einer Datumszeichenkette zurück.

Beispiele

DayOfMonth(Now());
// Returns 25 if today is December 25

DayOfWeek

Deklaration

int DayOfWeek(date d)

int DayOfWeek(string d)

Syntax

DayOfWeek(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge

Beschreibung

Gibt den Wochentag für ein Datumsobjekt oder eine Datumzeichenfolge zurück, wobei 0 für Sonntag, 1 für Montag und bis 6 für Samstag steht.

Diese Definition ist unabhängig von der Gebietsschema-Einstellung. Für den Namen des Wochentags rufen Sie stattdessen FormatDate auf.

Beispiele

DayOfWeek(Now());
// Returns 0, if today is Sunday

Now() + (6 - DayOfWeek(Now()))*24*60*60;
// Returns the date object of the last day of the current week,
// assuming Saturday (day 6) is the last day of the week

FormatDate

Deklaration

string FormatDate(date d, string format)

string FormatDate(string d, string format)

Syntax

FormatDate(<d>, <format>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge
• format: Eine Formatzeichenfolge, die das Format der Ausgabedatum angibt

Beschreibung

Konvertiert ein Datumsobjekt gemäß einer Formatzeichenfolge in eine Zeichenfolge. Dies ähnelt der Funktion CVTDate und verwendet die gleichen Formatzeichenfolgen.

Beispiele

FormatDate(Now(),"%w");
// Similar to DayOfWeek(Now()), except the return value
// is a string value of today's weekday name, such as "Wed"

FormatDate("2017-12-07","%A");
// Returns the weekday name of the date string, such as "Thursday"

LPadChar(String(Long(FormatDate(d, "yyyy")) - 1900), "0", 3) + FormatDate(d, "ddd");
// Returns, for a date d, a string formatted as a JD Edwards Date ("CYYDDD")
// If d = "2000-12-31" (a leap year), returns "100366"
// See https://docs.oracle.com/cd/E26228_01/doc.93/e21961/julian_date_conv.htm#WEAWX259

GeneralDate

Deklaration

string GeneralDate(date d)

string GeneralDate(string d)

Syntax

GeneralDate(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge

Beschreibung

Gibt eine Zeichenfolge im allgemeinen Datumsformat für ein Datumsobjekt oder eine Datumzeichenfolge zurück.

Beispiele

GeneralDate(Now());
// If Now() is 2017-09-16 11:59:23
// returns "09/16/2017 11:59:23 AM"

GeneralDate("2017-12-07");
// returns "12/07/2017 12:00:00 AM"

GetUTCFormattedDate

Deklaration

string GetUTCFormattedDate(date d, string time_zone_id[, bool is_european_format])

string GetUTCFormattedDate(string d, string time_zone_id[, bool is_european_format])

Syntax

GetUTCFormattedDate(<d>, <time_zone_id>[, <is_european_format>])

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge
• time_zone_id: Die Zeitzone, aus der konvertiert werden soll, ausgedrückt als Zeitzonencode

Optionale Parameter

• is_european_format: Dieses optionale Flag bestimmt, ob das europäische Datumsformat verwendet werden soll. Bei „true" ist das Format Tag und dann Monat; bei „false" ist das Format Monat und dann Tag.

Beschreibung

Gibt eine Datumzeichenfolge ohne Zeitinformationen zurück. Konvertiert ein Datumsobjekt oder eine Datumzeichenfolge gemäß einem Zeitzonencode in eine Zeichenfolge.

Beispiele

// If Now() is 2017-12-09 18:46:41, then:

GetUTCFormattedDate(Now(), "UTC", false);
// Returns "2017-12-09"

GetUTCFormattedDate(Now(), "America/Los_Angeles", false);
// Returns "2017-12-09"

GetUTCFormattedDateTime

Deklaration

string GetUTCFormattedDateTime(date d, string time_zone_id[, bool is_european_format])

string GetUTCFormattedDateTime(string d, string time_zone_id[, bool is_european_format])

Syntax

GetUTCFormattedDateTime(<d>, <time_zone_id>[, <is_european_format>])

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge
• time_zone_id: Die Zeitzone, aus der konvertiert werden soll, ausgedrückt als Zeitzonencode

Optionale Parameter

• is_european_format: Dieses optionale Flag bestimmt, ob das europäische Datumsformat verwendet werden soll. Bei „true" ist das Format Tag und dann Monat; bei „false" ist das Format Monat und dann Tag.

Beschreibung

Gibt eine Datumzeichenfolge mit Zeitinformationen zurück. Konvertiert ein Datumsobjekt oder eine Datumzeichenfolge gemäß einem Zeitzonencode in eine Zeichenfolge.

Beispiele

// If Now() is 2017-12-09 18:46:21, then:

GetUTCFormattedDateTime(Now(), "UTC", false);
// returns "2017-12-09T18:46:21Z"

GetUTCFormattedDateTime(Now(), "America/Los_Angeles", false);
// returns "2017-12-10T02:46:21Z"

LastDayOfMonth

Deklaration

date LastDayOfMonth(date d)

date LastDayOfMonth(string d)

Syntax

LastDayOfMonth(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge

Beschreibung

Gibt ein Datumsobjekt zurück, das den letzten Tag des Monats für ein Datumsobjekt oder eine Datumzeichenfolge darstellt.

Beispiele

LastDayOfMonth(Now());
// If Now() is a day in February of 2000 (a leap year),
// returns "2000-02-29"

LongDate

Deklaration

string LongDate(date d)

string LongDate(string d)

Syntax

LongDate(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge

Beschreibung

Gibt eine Zeichenfolge im Langdatumsformat für ein Datumsobjekt oder eine Datumzeichenfolge zurück.

Beispiele

LongDate(Now());
// If Now() is 2017-09-16 11:59:23
// returns "Saturday, September 16, 2017"

LongTime

Deklaration

string LongTime(date d)

string LongTime(string d)

Syntax

LongTime(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge

Beschreibung

Gibt eine Zeichenfolge im Langzeitformat für ein Datumsobjekt oder eine Datumzeichenfolge zurück.

Beispiele

LongTime(Now());
// If Now() is 2017-09-16 11:59:23
// returns "11:59:23 AM"

MediumDate

Deklaration

string MediumDate(date d)

string MediumDate(string d)

Syntax

MediumDate(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge

Beschreibung

Gibt eine Zeichenfolge im mittleren Datumsformat für ein Datumsobjekt oder eine Datumzeichenfolge zurück.

Beispiele

MediumDate(Now());
// If Now() is 2017-09-16 11:59:23
// returns "16-Sep-17"

MediumTime

Deklaration

string MediumTime(date d)

string MediumTime(string d)

Syntax

MediumTime(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge

Beschreibung

Gibt eine Zeichenfolge im mittleren Zeitformat für ein Datumsobjekt oder eine Datumzeichenfolge zurück.

Beispiele

MediumTime(Now());
// If Now() is 2017-09-16 11:59:23
// returns "11:59 AM"

MonthOfYear

Deklaration

int MonthOfYear(date d)

int MonthOfYear(string d)

Syntax

MonthOfYear(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge

Beschreibung

Gibt den Monat (1-12) für ein Datumsobjekt oder eine Datumzeichenfolge zurück.

Beispiele

MonthOfYear(Now());
// If Now() is 2017-09-16 11:59:23
// returns "9"

Now

Deklaration

date Now()

Syntax

Now()

Beschreibung

Gibt ein Datumsobjekt zurück, das die Datums- und Zeitwerte zum Zeitpunkt der Funktionsausführung darstellt. Der Sekundenbruchteile wird abgeschnitten.

Beispiele

Now();
// If the current date and time is 11:59:23 AM on September 16, 2017
// returns "2017-09-16 11:59:23"

Now_

Deklaration

date Now_()

Syntax

Now_()

Beschreibung

Gibt ein Datumsobjekt zurück, das die Datums- und Zeitwerte zum Zeitpunkt der Funktionsausführung darstellt. Der Zeitwert enthält den Sekundenbruchteile (Millisekunden).

Beispiele

Now_();
// If the current date and time is 11:59:23.123 AM on September 16, 2017
// returns "2017-09-16 11:59:23.123"

// Examples of manipulating Now_ output:
date = Now_();
seconds = Long(date);
milliseconds = FormatDate(date, 'zzz');

ShortDate

Deklaration

string ShortDate(date d)

string ShortDate(string d)

Syntax

ShortDate(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge

Beschreibung

Gibt eine Zeichenfolge im kurzen Datumsformat für ein Datumsobjekt oder eine Datumzeichenfolge zurück.

Beispiele

ShortDate(Now());
// If Now() is 2017-09-16 11:59:23
// returns "9/16/17"

ShortTime

Deklaration

string ShortTime(date d)

string ShortTime(string d)

Syntax

ShortTime(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenfolge

Beschreibung

Gibt eine Zeichenfolge im Kurzformat für die Uhrzeit für ein Datumsobjekt oder eine Datumzeichenfolge zurück.

Beispiele

ShortTime(Now());
// If Now() is 2017-09-16 11:59:23
// returns "11:59"