Datums- und Uhrzeitfunktionen im Jitterbit Design Studio

Einführung

Wenn Sie diese Funktionen in Verbindung mit den Now oder Now_ Beachten Sie bei Funktionen, dass die zurückgegebene Zeitzone die auf dem Computer konfigurierte ist, auf dem der Agent ausgeführt wird. Alle Cloud-Agenten sind in UTC. Private Agenten variieren je nach dem jeweiligen Computer, auf dem jeder Agent ausgeführt wird. Wenn Sie eine Konvertierungsfunktion 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 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). Bei Zeitzonencodes wird zwischen Groß- und Kleinschreibung unterschieden. Wenn eine Zeitzone verwendet wird, werden vollständige TZ-Codes empfohlen, da „AST“ sich entweder auf die „atlantische“ oder die „arabische“ Standardzeit 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 aufgeführt. Diese werden von der IANA abgelehnt, wird derzeit jedoch unterstützt.
• Weitere Informationen finden Sie unter https://www.iana.org/time-zones.

Konvertieren von Unix-Zeiten in Datumsangaben

Wenn eine UNIX-Zeit eine Zahl mit Millisekundengenauigkeit ist, können Sie Code wie diesen 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

Erklärung

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 Datumszeichenfolge
• fromTZ: Die Zeitzone, aus der konvertiert werden soll, ausgedrückt als Zeitzonencode
• toTZ: Die Zeitzone, in die umgerechnet werden soll, ausgedrückt als Zeitzonencode

Optionale Parameter

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

• ignoreDST: Standardmäßig wird die Sommerzeit bei der Umrechnung zwischen den vier großen US-Zeitzonen berücksichtigt. Setzen Sie dieses optionale Flag auf true um diese Aktion außer Kraft zu setzen.

Beschreibung

Nimmt ein Datum und gibt es konvertiert von einer Zeitzone in eine andere zurück.

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)

CVTDate

Erklärung

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 Datumszeichenfolge
• inputFormat: Ein Formatstring, Angabe des Formats des Eingabedatums
• outputFormat: Ein Formatstring, Angabe des Formats des Ausgabedatums

Beschreibung

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

Beispiele

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

Formatzeichenfolgen

Das Format der Eingabe- und Ausgabedatumszeichenfolge wird auf die gleiche Weise angegeben, indem entweder Zeichen für Platzhalter oder eines der vier vordefinierten Datumsformate verwendet werden (GeneralDate, LongDate, MediumDate, oder ShortDate).

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

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

Alternativ können die in der ANSI C-Methode verwendeten Substitutionen strftime kann verwendet werden. Beispielsweise kann die Zeichenfolge "%Y-%m-%d" würde zum ISO 8601-Datumsformat führen (yyyy-mm-dd). 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

Erklärung

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 Ergänzung angewendet werden soll
• number: Eine Ganzzahl, die dem Datumsteil hinzugefügt werden soll
• d: Das Datumsobjekt oder eine Datumszeichenfolge, mit der gearbeitet werden soll

Beschreibung

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

Erklärung

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());
// Returns 25 if today is December 25

DayOfWeek

Erklärung

int DayOfWeek(date d)

int DayOfWeek(string d)

Syntax

DayOfWeek(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumszeichenfolge

Beschreibung

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

Diese Definition ist unabhängig vom Gebietsschema. Für den Wochentagsnamen rufen Sie auf FormatDate stattdessen.

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

Erklärung

string FormatDate(date d, string format)

string FormatDate(string d, string format)

Syntax

FormatDate(<d>, <format>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumszeichenfolge
• format: Ein Formatstring, Angabe des Formats des Ausgabedatums

Beschreibung

Konvertiert ein Datumsobjekt gemäß einer Formatzeichenfolge in eine Zeichenfolge. Dies ist ähnlich wie die CVTDate Funktion und verwendet dieselben 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

Erklärung

string GeneralDate(date d)

string GeneralDate(string d)

Syntax

GeneralDate(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumszeichenfolge

Beschreibung

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

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

Erklärung

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 Datumszeichenfolge
• 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. Wenn es wahr ist, ist das Format Tag und dann Monat; wenn es falsch ist, ist das Format Monat und dann Tag.

Beschreibung

Gibt eine Datumszeichenfolge ohne Zeitinformationen zurück. Wandelt ein Datumsobjekt oder eine Datumszeichenfolge gemäß einem Zeitzonencode in eine Zeichenfolge um.

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

Erklärung

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 Datumszeichenfolge
• 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. Wenn es wahr ist, ist das Format Tag und dann Monat; wenn es falsch ist, ist das Format Monat und dann Tag.

Beschreibung

Gibt eine Datumszeichenfolge mit Zeitinformationen zurück. Wandelt ein Datumsobjekt oder eine Datumszeichenfolge entsprechend einem Zeitzonencode in eine Zeichenfolge um.

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

Erklärung

date LastDayOfMonth(date d)

date LastDayOfMonth(string d)

Syntax

LastDayOfMonth(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumszeichenfolge

Beschreibung

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

Beispiele

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

LongDate

Erklärung

string LongDate(date d)

string LongDate(string d)

Syntax

LongDate(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumszeichenfolge

Beschreibung

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

Beispiele

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

LongTime

Erklärung

string LongTime(date d)

string LongTime(string d)

Syntax

LongTime(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumszeichenfolge

Beschreibung

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

Beispiele

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

MediumDate

Erklärung

string MediumDate(date d)

string MediumDate(string d)

Syntax

MediumDate(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumszeichenfolge

Beschreibung

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

Beispiele

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

MediumTime

Erklärung

string MediumTime(date d)

string MediumTime(string d)

Syntax

MediumTime(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumszeichenfolge

Beschreibung

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

Beispiele

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

MonthOfYear

Erklärung

int MonthOfYear(date d)

int MonthOfYear(string d)

Syntax

MonthOfYear(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumszeichenfolge

Beschreibung

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

Beispiele

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

Now

Erklärung

date Now()

Syntax

Now()

Beschreibung

Gibt ein Datumsobjekt zurück, das die Datums- und Zeitwerte zum Zeitpunkt der Ausführung der Funktion darstellt. Der Sekundenbruchteil 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_

Erklärung

date Now_()

Syntax

Now_()

Beschreibung

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

ShortDate

Erklärung

string ShortDate(date d)

string ShortDate(string d)

Syntax

ShortDate(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumszeichenfolge

Beschreibung

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

Beispiele

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

ShortTime

Erklärung

string ShortTime(date d)

string ShortTime(string d)

Syntax

ShortTime(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumszeichenfolge

Beschreibung

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

Beispiele

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