Datum- und Zeitfunktionen im Jitterbit Design Studio

Einführung

Wenn Sie diese Funktionen in Verbindung mit den Funktionen Now oder Now_ verwenden, beachten Sie, dass die zurückgegebene Zeitzone diejenige ist, die auf dem Computer konfiguriert 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 Umrechnungsfunktion verwenden, berücksichtigen Sie dies, wenn Ihr Projekt sowohl in der Cloud als auch auf einem privaten Agenten ausgeführt werden soll.

Zeitzonencodes

Die Zeitzonenparameter sind einer der standardmäßigen Zeitzonencodes, entweder ein vollständiger Name (TZ-Code) wie "America/Los_Angeles", ein UTC-Versatz wie "UTC-8:00" oder eine Abkürzung wie "PST" (dreibuchstabiger Code). Zeitzonencodes sind groß- und kleinschreibungsempfindlich. Vollständige TZ-Codes werden empfohlen, wenn eine Zeitzone verwendet wird, da "AST" sowohl für die "Atlantische" als auch für die "Arabische" Standardzeit stehen kann.

• TZ-Codes (eine inoffizielle Liste) finden Sie unter https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
• Dreibuchstabige Codes sind unter https://en.wikipedia.org/wiki/List_of_time_zone_abbreviations aufgeführt. Diese sind von der IANA veraltet, werden jedoch derzeit unterstützt.
• Weitere Informationen finden Sie unter https://www.iana.org/time-zones.

Umwandlung von Unix-Zeiten in Daten

Wenn eine UNIX-Zeit eine Zahl ist, die eine Millisekundenpräzision enthält, können Sie ähnlichen Code verwenden, um eine UNIX-Zeit in ein Datum umzuwandeln:

// 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

Declaration

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>])

Required parameters

• date: Ein Datum, entweder als Datumsobjekt oder als Datumszeichenfolge
• fromTZ: Die Zeitzone, von der konvertiert werden soll, ausgedrückt als Zeitzonencode
• toTZ: Die Zeitzone, in die konvertiert werden soll, ausgedrückt als Zeitzonencode

Optional parameters

• 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 berücksichtigt, wenn zwischen den vier wichtigsten US-Zeitzonen konvertiert wird. Setzen Sie dieses optionale Flag auf true, um diese Aktion zu überschreiben.

Description

Nimmt ein Datum und gibt es konvertiert von einer Zeitzone in eine andere Zeitzone zurück. Mit Agenten der Version 12.8 und höher wird Mitternacht (00:00:00) als gültiger Zeitwert behandelt, sodass sie im zurückgegebenen String auf die gleiche Weise wie jede andere Zeit beibehalten wird.

Examples

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")

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 ein Datumsstring
• inputFormat: Eine Formatzeichenfolge, die das Format des Eingabedatums angibt
• outputFormat: Eine Formatzeichenfolge, die das Format des Ausgabedatums angibt

Beschreibung

Konvertiert ein Datumsobjekt oder einen Datumsstring im Eingabeformat in einen Datumsstring im Ausgabeformat.

Wenn ein leeres Datumsobjekt oder ein leerer Datumsstring für d übergeben wird, gibt die Funktion ein leeres Objekt zurück, wenn die Agenten-Version 11.39 oder höher verwendet wird.

Beispiele

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

Formatzeichenfolgen

Das Format sowohl der Eingabedatumszeichenfolge als auch der Ausgabedatumszeichenfolge 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.

Für Eingaben werden das Jahr, der Monat, der Tag, die Stunde, die Minute, die Sekunde und AM/PM aus der Datumszeichenfolge an der Stelle gelesen, an der y, m, d, H, M, S, SSS und AP in der Eingabeformatzeichenfolge erscheinen.

Für Ausgaben wird die Formatzeichenfolge in die Datenzeichenfolge kopiert, wobei Jahr, Monat, Tag, Stunde, Minute und Sekunde die Zeichen von y, m, d, H, M, S, SSS und AP ersetzen.

Alternativ können die in der ANSI C-Methode strftime verwendeten Ersetzungen verwendet werden. Zum Beispiel würde die Zeichenfolge "%Y-%m-%d" im ISO 8601-Datumsformat (yyyy-mm-dd) resultieren. Siehe die externe Dokumentation zu strftime für eine detaillierte Beschreibung.

Diese Codes können nach Bedarf in der Formatzeichenfolge erscheinen, 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 ganze Zahl, die zum Datumsteil hinzugefügt werden soll
• d: Das Datumsobjekt oder eine Datumszeichenfolge, auf die zugegriffen werden soll

Beschreibung

Gibt eine Datumszeichenfolge zurück, nachdem eine Zahl zu einem bestimmten Teil eines Datumsobjekts hinzugefügt 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 Datumszeichenfolge

Beschreibung

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

Beispiele

DayOfMonth(Now());
// Gibt 25 zurück, wenn heute der 25. Dezember ist

DayOfWeek

Deklaration

int DayOfWeek(date d)

int DayOfWeek(string d)

Syntax

DayOfWeek(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder ein Datumsstring

Beschreibung

Gibt den Wochentag für ein Datumsobjekt oder einen Datumsstring 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. Für den Wochentagsnamen 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 ein Datumsstring
• format: Ein Formatstring, der das Format des Ausgabedatums angibt

Beschreibung

Konvertiert ein Datumsobjekt in einen String gemäß einem Formatstring. Dies ähnelt der CVTDate-Funktion und verwendet die gleichen Formatstrings.

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 ein Datumsstring

Beschreibung

Gibt einen String im allgemeinen Datumsformat für ein Datumsobjekt oder einen Datumsstring 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 ein Datumsstring
• time_zone_id: Die Zeitzone, von 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. Wenn wahr, ist das Format Tag und dann Monat; wenn falsch, ist das Format Monat und dann Tag.

Beschreibung

Gibt einen Datumsstring ohne Zeitinformationen zurück. Konvertiert ein Datumsobjekt oder einen Datumsstring in einen String gemäß einem Zeitzonencode.

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 ein Datumsstring
• time_zone_id: Die Zeitzone, von 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. Wenn wahr, ist das Format Tag und dann Monat; wenn falsch, ist das Format Monat und dann Tag.

Beschreibung

Gibt einen Datumsstring mit Zeitinformationen zurück. Konvertiert ein Datumsobjekt oder einen Datumsstring in einen String gemäß einem Zeitzonencode.

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 Datumszeichenfolge

Beschreibung

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

Beispiele

LastDayOfMonth(Now());
// Wenn Now() ein Tag im Februar 2000 (ein Schaltjahr) ist,
// gibt "2000-02-29" zurück

LongDate

Deklaration

string LongDate(date d)

string LongDate(string d)

Syntax

LongDate(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder Datumszeichenfolge

Beschreibung

Gibt eine Zeichenfolge im langen Datumsformat für ein Datumsobjekt oder eine Datumszeichenfolge zurück.

Beispiele

LongDate(Now());
// Wenn Now() 2017-09-16 11:59:23 ist
// gibt "Samstag, 16. September 2017" zurück

LongTime

Deklaration

string LongTime(date d)

string LongTime(string d)

Syntax

LongTime(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder Datumszeichenfolge

Beschreibung

Gibt eine Zeichenfolge im langen Zeitformat für ein Datumsobjekt oder eine Datumszeichenfolge zurück.

Beispiele

LongTime(Now());
// Wenn Now() 2017-09-16 11:59:23 ist
// gibt "11:59:23 AM" zurück

MediumDate

Deklaration

string MediumDate(date d)

string MediumDate(string d)

Syntax

MediumDate(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder ein Datumsstring

Beschreibung

Gibt einen String im mittleren Datumsformat für ein Datumsobjekt oder einen Datumsstring zurück.

Beispiele

MediumDate(Now());
// Wenn Now() 2017-09-16 11:59:23 ist
// gibt "16-Sep-17" zurück

MediumTime

Deklaration

string MediumTime(date d)

string MediumTime(string d)

Syntax

MediumTime(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder ein Datumsstring

Beschreibung

Gibt einen String im mittleren Zeitformat für ein Datumsobjekt oder einen Datumsstring zurück.

Beispiele

MediumTime(Now());
// Wenn Now() 2017-09-16 11:59:23 ist
// gibt "11:59 AM" zurück

MonthOfYear

Deklaration

int MonthOfYear(date d)

int MonthOfYear(string d)

Syntax

MonthOfYear(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder ein Datumsstring

Beschreibung

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

Beispiele

MonthOfYear(Now());
// Wenn Now() 2017-09-16 11:59:23 ist
// gibt "9" zurück

Now

Deklaration

date Now()

Syntax

Now()

Beschreibung

Gibt ein Datumsobjekt zurück, das die Datums- und Zeitwerte zum Zeitpunkt der Ausführung der Funktion darstellt. Der Bruchteil der Sekunde wird abgeschnitten.

Beispiele

Now();
// Wenn das aktuelle Datum und die Uhrzeit 11:59:23 AM am 16. September 2017 sind
// gibt "2017-09-16 11:59:23" zurück

Now_

Deklaration

date Now_()

Syntax

Now_()

Beschreibung

Gibt ein Datumsobjekt zurück, das die Datums- und Uhrzeitwerte zum Zeitpunkt der Ausführung der Funktion darstellt. Der Zeitwert umfasst den Bruchteil einer Sekunde (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 ein Datumsstring

Beschreibung

Gibt einen String im kurzen Datumsformat für ein Datumsobjekt oder einen Datumsstring zurück.

Beispiele

ShortDate(Now());
// Wenn Now() 2017-09-16 11:59:23 ist
// gibt "9/16/17" zurück

ShortTime

Deklaration

string ShortTime(date d)

string ShortTime(string d)

Syntax

ShortTime(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder ein Datumsstring

Beschreibung

Gibt einen String im Kurzzeitformat für ein Datumsobjekt oder einen Datumsstring zurück.

Beispiele

ShortTime(Now());
// Wenn Now() 2017-09-16 11:59:23 ist
// gibt "11:59" zurück