Datums- und Zeitfunktionen in Jitterbit Studio

Einführung

Wenn Sie diese Funktionen zusammen 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 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 sind Groß-/Kleinschreibung beachtet. 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 ähnlich dem folgenden 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 in der zurückgegebenen Zeichenkette auf die gleiche Weise beibehalten wie jede andere Zeit. Mit Agenten Version 12.9 und später werden auch Millisekunden in der Eingabe in der zurückgegebenen Zeichenkette beibehalten; zuvor wurden sie immer gelöscht. Ein Millisekunden-Wert von genau .000 wird in der zurückgegebenen Zeichenkette 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 Datumzeichenkette

• inputFormat: Eine Formatzeichenkette, die das Format des Eingabedatums angibt

• outputFormat: Eine Formatzeichenkette, die das Format des Ausgabedatums angibt

Beschreibung

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

Wenn ein leeres Datumsobjekt oder eine leere Datumzeichenkette 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 Agenten in der Cloud ausgeführt werden und die zurückgegebenen Zeiten in UTC erfolgen. "myDate" ist das Datum 19. Juni 1994.

Formatzeichenketten

Das Format sowohl der Eingabedatumzeichenkette als auch der Ausgabedatumzeichenkette wird auf die gleiche Weise angegeben, indem entweder Zeichen als 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 Datumzeichenkette an der Position gelesen, an der y, m, d, H, M, S, SSS und AP in der Eingabeformatzeichenkette erscheinen.

Bei Ausgaben wird die Formatzeichenkette in die Datenzeichenkette 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 wird:

DateAdd

Declaration

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

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

Syntax

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

Required parameters

• 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

Description

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

Diese Codes werden verwendet, um die Datumsteile zu beschreiben:

Examples

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

Declaration

int DayOfMonth(date d)

int DayOfMonth(string d)

Syntax

DayOfMonth(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenkette

Beschreibung

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

Beispiele

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

DayOfWeek

Declaration

int DayOfWeek(date d)

int DayOfWeek(string d)

Syntax

DayOfWeek(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenkette

Beschreibung

Gibt den Wochentag eines Datumsobjekts oder einer Datumzeichenkette zurück, wobei 0 für Sonntag, 1 für Montag und so weiter 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

Declaration

string FormatDate(date d, string format)

string FormatDate(string d, string format)

Syntax

FormatDate(<d>, <format>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenkette
• format: Eine Formatzeichenkette, die das Format des Ausgabedatums angibt

Beschreibung

Konvertiert ein Datumsobjekt gemäß einer Formatzeichenkette in eine Zeichenkette. Dies ähnelt der Funktion CVTDate und verwendet dieselben Formatzeichenketten.

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

Declaration

string GeneralDate(date d)

string GeneralDate(string d)

Syntax

GeneralDate(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenkette

Beschreibung

Gibt eine Zeichenkette im allgemeinen Datumformat für ein Datumsobjekt oder eine Datumzeichenkette 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

Declaration

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 Datumzeichenkette

• 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 Datumformat verwendet werden soll. Bei true ist das Format Tag und dann Monat; bei false ist das Format Monat und dann Tag.

Beschreibung

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

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 Datumzeichenkette

• 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 true, ist das Format Tag und dann Monat; wenn false, ist das Format Monat und dann Tag.

Beschreibung

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

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 Datumzeichenkette

Beschreibung

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

Beispiele

LastDayOfMonth(Now());
// Wenn Now() ein Tag im Februar 2000 ist (ein Schaltjahr),
// 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 eine Datumzeichenkette

Beschreibung

Gibt eine Zeichenkette im Langdatumsformat für ein Datumsobjekt oder eine Datumzeichenkette zurück.

Beispiele

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

LongTime

Deklaration

string LongTime(date d)

string LongTime(string d)

Syntax

LongTime(<d>)

Erforderliche Parameter

• d: Ein Datumsobjekt oder eine Datumzeichenkette

Beschreibung

Gibt eine Zeichenkette im langen Zeitformat für ein Datumsobjekt oder eine Datumzeichenkette 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 Datumzeichenkette

Beschreibung

Gibt eine Zeichenkette im mittleren Datumformat für ein Datumsobjekt oder eine Datumzeichenkette 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 Datumzeichenkette

Beschreibung

Gibt eine Zeichenkette im mittleren Zeitformat für ein Datumsobjekt oder eine Datumzeichenkette 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 Datumzeichenkette

Beschreibung

Gibt den Monat (1–12) für ein Datumsobjekt oder eine Datumzeichenkette 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 Kurzdatumsformat 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 Kurzzeitformat für ein Datumsobjekt oder eine Datumzeichenfolge zurück.

Beispiele

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