. OmniStudio-Datums- und -Uhrzeitfunktionen

Sie befinden sich hier:

OmniStudio-Datums- und -Uhrzeitfunktionen

Funktionen, die an Datums- und Uhrzeitangaben arbeiten.

OmniStudio-ADDDAY-Funktion
Gibt ein Datum und eine Uhrzeit nach dem Hinzufügen einer angegebenen Anzahl von Tagen zurück.
OmniStudio ADDMONTH-Funktion
Gibt ein Datum und eine Uhrzeit nach dem Hinzufügen einer angegebenen Anzahl von Monaten zurück.
OmniStudio-AddYEAR-Funktion
Gibt ein Datum und eine Uhrzeit nach dem Hinzufügen einer angegebenen Anzahl von Jahren zurück.
OmniStudio AGE-Funktion
Gibt das Alter in Jahren für ein angegebenes Geburtsdatum zurück.
Omnistudio AGEON Function
Gibt das Alter in Jahren für ein angegebenes Geburtsdatum an einem angegebenen Datum zurück.
Omnistudio DATEDIFF Function
Gibt die Differenz in der Anzahl der Tage zwischen zwei angegebenen Datumswerten als Ganzzahlwert zurück.
Omnistudio DATETIMETOUNIX Function
Gibt die Anzahl der Millisekunden in UNIX-Zeit für ein angegebenes Datum und eine angegebene Uhrzeit zurück.
OmniStudio DAY-Funktion
Gibt den Tag für ein angegebenes Datum als Ganzzahlwert zurück.
Omnistudio EOM Function
Gibt das Datum und die Uhrzeit des letzten Tags des Monats für ein angegebenes Datum zurück.
OmniStudio-Funktion FORMATDATETIME
Gibt ein Datum und eine Uhrzeit als Zeichenfolge in einem angegebenen Format und einer angegebenen Zeitzone zurück.
Omnistudio FORMATDATETIMEGMT Function
Gibt ein Datum und eine Uhrzeit als Zeichenfolge in einem angegebenen Format und in der GMT-Zeitzone zurück.
OmniStudio HOUR-Funktion
Gibt die Stunde für eine angegebene Zeit als Ganzzahlwert zurück.
OmniStudio-MINUTE-Funktion
Gibt die Minute für eine angegebene Zeit als Ganzzahlwert zurück.
OmniStudio-MONAT-Funktion
Gibt den Monat für ein angegebenes Datum als Ganzzahlwert zurück.
OmniStudio NOW-Funktion
Gibt das aktuelle Datum und die aktuelle Uhrzeit in einem angegebenen Format zurück.
OmniStudio SECOND-Funktion
Gibt die zweite für eine angegebene Zeit als Ganzzahlwert zurück.
OmniStudio TIMEDIFF-Funktion
Gibt die Differenz in der Anzahl der Millisekunden zwischen zwei angegebenen Zeiten als Ganzzahl zurück.
OmniStudio TODAY-Funktion
Gibt das aktuelle Datum zurück.
Omnistudio UNIXTODATETIME Function
Gibt das Datum und die Uhrzeit für eine in UNIX-Zeit angegebene Anzahl von Sekunden oder Millisekunden zurück.
OmniStudio-JAHR-Funktion
Gibt das Jahr für ein angegebenes Datum als Ganzzahlwert zurück.

OmniStudio-ADDDAY-Funktion

Gibt ein Datum und eine Uhrzeit nach dem Hinzufügen einer angegebenen Anzahl von Tagen zurück.

Wenn Sie ein Datum und eine Uhrzeit angeben, verwenden Sie die "YYYY-MM-DD" für das Datumsformat, um die Eingabezeit beizubehalten. Verwenden Sie die Datumsformat-"MM/DD/YYYY", um die Uhrzeit auf 00:00:00 zurückzusetzen.

Signatur

ADDDAY(date, days)

Rückgabewert

Datetime

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`date`	Datetime	Erforderlich	Ein Datum, das als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben.
`days`	Ganzzahl	Erforderlich	Die Anzahl der Tage, die dem angegebenen Datum hinzugefügt werden sollen. Verwenden Sie eine negative Zahl, um Tage vom Datum zu subtrahieren.

Beispiel 'Tage hinzufügen'

Formel: ADDDAY("2025-01-01", 31)

Formel: ADDDAY("01/01/2025", 31)

Formel: ADDDAY("01/01/2025T12:00:00Z", 31)

Rückgabewert: "2025-02-01T00:00:00.000Z"

Beispiel 'Tage hinzufügen'

Formel: ADDDAY("2025-01-01T12:00:00Z", 31)

Rückgabewert: "2025-02-01T12:00:00.000Z"

Beispiel 'Tage subtrahieren'

Formel: ADDDAY("2025-01-01", -100)

Formel: ADDDAY("2025-01-01T00:00:00Z", -100)

Rückgabewert: "2024-09-23T00:00:00.000Z"

OmniStudio ADDMONTH-Funktion

Gibt ein Datum und eine Uhrzeit nach dem Hinzufügen einer angegebenen Anzahl von Monaten zurück.

Signatur

ADDMONTH(date, months)

Rückgabewert

Datetime

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`date`	Datetime	Erforderlich	Ein Datum, das als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben.
`months`	Ganzzahl	Erforderlich	Die Anzahl der Monate, die dem angegebenen Datum hinzugefügt werden sollen. Verwenden Sie eine negative Zahl, um Monate vom Datum zu subtrahieren.

Beispiel 'Monate hinzufügen'

Formel: ADDMONTH('2025-25-01', 15)

Formel: ADDMONTH("01/25/2025", 15)

Formel: ADDMONTH("01/25/2025T16:35:30Z", 15)

Rückgabewert: "2026-04-25T00:00:00.000Z"

Beispiel 'Monate hinzufügen'

Formel: ADDMONTH("2025-01-25T16:35:30Z", 15)

Rückgabewert: "2026-04-25T16:35:30.000Z"

Beispiel 'Monate subtrahieren'

Formel: ADDMONTH("01/25/2025", -15)

Formel: ADDMONTH('01/25/2025T16:35:30Z', -15)

Rückgabewert: "2023-10-25T00:00:00.000Z"

OmniStudio-AddYEAR-Funktion

Gibt ein Datum und eine Uhrzeit nach dem Hinzufügen einer angegebenen Anzahl von Jahren zurück.

Signatur

ADDYEAR(date, years)

Rückgabewert

Datetime

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`date`	Datetime	Erforderlich	Ein Datum, das als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben.
`years`	Ganzzahl	Erforderlich	Die Anzahl der Jahre, die dem angegebenen Datum hinzugefügt werden sollen. Verwenden Sie eine negative Zahl, um Jahre vom Datum zu subtrahieren.

Beispiel 'Jahre hinzufügen'

Formel: ADDYEAR("2025-01-01", 10)

Formel: ADDYEAR("01/01/2025", 10)

Formel: ADDYEAR("01/01/2025T16:35:30", 10)

Rückgabewert: "2035-01-01T00:00:00.000Z"

Beispiel 'Jahre hinzufügen'

Formel: ADDYEAR("2025-01-01T16:35:30", 10)

Rückgabewert: "2035-01-01T16:35:30.000Z"

Beispiel 'Jahre subtrahieren'

Formel: ADDYEAR("2025-01-01", -10)

Formel: ADDYEAR("2025-01-01T00:00:00", -10)

Rückgabewert: "2015-01-01T00:00:00.000Z"

OmniStudio AGE-Funktion

Gibt das Alter in Jahren für ein angegebenes Geburtsdatum zurück.

Signatur

AGE(birthDate)

Rückgabewert

Ganze Zahl

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`birthDate`	Datetime	Erforderlich	Ein Datum, das als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben.

Beispiel für Datumszeichenfolge

Formel: AGE("02/15/2002")

Formel: AGE("2002-02-15")

Rückgabewert: 23

Beispiel für eine Datums- und Uhrzeitzeichenfolge

Formel: AGE("2002-02-15T16:35:30")

Formel: AGE("2002-02-15T16:35:30Z")

Rückgabewert: 23

Omnistudio AGEON Function

Gibt das Alter in Jahren für ein angegebenes Geburtsdatum an einem angegebenen Datum zurück.

Die Funktion berechnet ein Alter nur anhand von Datumswerten. Sie ignoriert die Uhrzeiten. Die Funktion gibt 0 zurück, wenn der angegebene date weniger als ein Jahr vom birthDate entfernt ist oder davor liegt.

Signatur

AGEON(birthDate, date)

Rückgabewert

Ganze Zahl

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`birthDate`	Datetime	Erforderlich	Das Geburtsdatum, für das das Alter berechnet werden soll. Geben Sie ein Datum als Zeichenfolge im Format Day.js an. Sie können ein Datum und eine Uhrzeit angeben.
`date`	Datetime	Erforderlich	Ein Datum, für das die Funktion ein Alter basierend auf dem Geburtsdatum berechnen soll. Geben Sie ein Datum als Zeichenfolge im Format Day.js an. Sie können ein Datum und eine Uhrzeit angeben.

Beispiel für eine Datums- und Uhrzeitzeichenfolge

Formel: AGEON("02/15/2002T16:35:30Z", "2030-02-28")

Formel: AGEON("2002-02-15", "2030-02-28T16:35:30Z")

Rückgabewert: 28

JSON-Objektbeispiel

Beispieldaten:

"BirthDate": "6/25/2004T09:05:00 GMT -0500 (EDT)"
"FutureDate1": "02/28/2030",
"FutureDate2": "2030-02-28"

Formel: AGEON(%Birthdate%, %FutureDate1%)

Formel: AGEON("BirthDate%, %FutureDate2%)

Rückgabewert: 25

Omnistudio DATEDIFF Function

Gibt die Differenz in der Anzahl der Tage zwischen zwei angegebenen Datumswerten als Ganzzahlwert zurück.

Das erste Datum wird vom zweiten Datum abgezogen. Wenn das erste Datum größer als das zweite Datum ist, gibt die Funktion eine negative Ganzzahl zurück.

Wenn Sie eine Uhrzeit angeben, berücksichtigt die Funktion sie bei ihrer Berechnung. Wenn Sie eine Zeitzone angeben, berücksichtigt die Funktion sie bei ihrer Berechnung.

Signatur

DATEDIFF(firstDate, secondDate)

Rückgabewert

Ganze Zahl

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`firstDate`	Date (Datum)	Erforderlich	Ein Datum, das als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben.
`secondDate`	Date (Datum)	Erforderlich	Ein Datum, für das die Funktion die Differenz der Anzahl der Tage zwischen dem ersten Datum berechnen soll. Geben Sie ein Datum als Zeichenfolge im Format Day.js an. Sie können ein Datum und eine Uhrzeit angeben.

Beispiel für positive Tage

Formel: DATEDIFF("02/01/2000", "2001-02-01")

Rückgabewert: 366

Beispiel für negative Tage

Formel: DATEDIFF("2001-02-01", "02/01/2000")

Rückgabewert: -366

Beispiel für Datum und Uhrzeit

Formel: DATEDIFF("2025-02-04T00:00:00", "2025-03-04T00:00:00")

Rückgabewert: 28

Beispiel für Datum und Uhrzeit

Formel: DATEDIFF("2025-02-04T12:00:00", "2025-03-04T11:59:59")

Rückgabewert: 27

Beispiel für Datum und Uhrzeit mit Zeitzone

Formel: DATEDIFF("2025-02-04T12:00:00-0500", "2025-03-04T11:59:59+0000")

Rückgabewert: 28

JSON-Objektbeispiele

Beispieldaten:

"Account": [
  {
    "Cases": [
      {
        "Case1": {
          "CreatedDate": "2/1/2024T16:35:30 GMT -0500 (EDT)",
          "LastUpdate": "2/8/2024T09:15:00 GMT -0500 (EDT)"
        }
      },
      {
        "Case2": {
          "CreatedDate": "2/2/2025T11:05:05 GMT -0500 (EDT)",
          "LastUpdate": "2/3/2025T15:50:57 GMT -0500 (EDT)"
        }
      }
    ]
  }
]

Formel: DATEDIFF(Account:Cases:Case1:CreatedDate, Account:Cases:Case1:LastUpdate)

Rückgabewert: 7

Formel: DATEDIFF(%Account:Cases:Case2:CreatedDate%, TODAY())

Rückgabewert: 8

Omnistudio DATETIMETOUNIX Function

Gibt die Anzahl der Millisekunden in UNIX-Zeit für ein angegebenes Datum und eine angegebene Uhrzeit zurück.

Die UNIX-Zeit ist die Anzahl der Nicht-Schaltsekunden, die seit dem 1. Januar 1970, koordinierte Weltzeit (UTC), um 00:00:00 Uhr vergangen sind. UTC entspricht Greenwich Mean Time (GMT). Der Wert wird als UNIX-Zeitraum bezeichnet.

Signatur

DATETIMETOUNIX(datetime)

Rückgabewert

Ganze Zahl

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`datetime`	Datetime	Erforderlich	Ein Datum und eine Uhrzeit, die als Zeichenfolge im Format Day.js angegeben sind. Sie können auch nur ein Datum angeben.

Beispiel für Datum und Uhrzeit

Formel: DATETIMETOUNIX("2002-02-01T16:35:30:000Z")

Formel: DATETIMETOUNIX("2002-02-01T16:35:30:000")

Formel: DATETIMETOUNIX("2002-02-01T16:35:30")

Formel: DATETIMETOUNIX("02/01/2002T16:35:30")

Rückgabewert: 1012581330000

Beispiel für Datum und Nullzeit

Formel: DATETIMETOUNIX("2002-02-01")

Formel: DATETIMETOUNIX("02/01/2002")

Formel: DATETIMETOUNIX("2002-02-01T00:00:00")

Formel: DATETIMETOUNIX("02/01/2002T00:00:00")

Formel: DATETIMETOUNIX("2002-02-01T00:00:00Z")

Formel: DATETIMETOUNIX("02/01/2002T00:00:00Z")

Rückgabewert: 1012521600000

OmniStudio DAY-Funktion

Gibt den Tag für ein angegebenes Datum als Ganzzahlwert zurück.

Signatur

DAY(date)

Rückgabewert

Ganze Zahl

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`date`	Datetime	Erforderlich	Ein Datum, das als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben.

Beispiel für Datumszeichenfolge

Formel: DAY("2025-01-31")

Formel: DAY("01/31/2025")

Formel: DAY("1/31/2025")

Rückgabewert: 31

JSON-Objektbeispiel

Beispieldaten: "Birthdate": "2002-02-15T16:35:30 GMT -0500 (EDT)"

Formel: DAY(Birthdate)

Rückgabewert: 15

Omnistudio EOM Function

Gibt das Datum und die Uhrzeit des letzten Tags des Monats für ein angegebenes Datum zurück.

Signatur

EOM(date)

Rückgabewert

Datetime

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`date`	Datetime	Erforderlich	Ein Datum, das als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben.

Datumsbeispiel

Formel: EOM("2024-02-01")

Formel: EOM("02/01/2024")

Rückgabewert: "2024-02-29T00:00:00.000Z"

Beispiel für Datum und Uhrzeit

Formel: EOM("02/01/2024T16:35:30")

Formel: EOM("02/01/2024T16:35:30Z")

Rückgabewert: "2024-02-29T00:00:00.000Z"

OmniStudio-Funktion FORMATDATETIME

Gibt ein Datum und eine Uhrzeit als Zeichenfolge in einem angegebenen Format und einer angegebenen Zeitzone zurück.

Die Greenwich-Mittelzeit (GMT) entspricht der koordinierten Weltzeit (Coordinated Universal Time, UTC), die als Grundlage für die UNIX-Zeit und die UNIX-Zeit dient.

Signatur

FORMATDATETIME(datetime, format, timezone)

Rückgabewert

Zeichenfolge

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`datetime`	Datetime	Erforderlich	Ein Datum und eine Uhrzeit, die als Zeichenfolge im Format Day.js angegeben sind. Sie können nur ein Datum oder eine Uhrzeit angeben. Wenn Sie nur ein Datum angeben, lautet die Standardzeit `00:00:00`. Wenn Sie nur eine Uhrzeit angeben, lautet das Standarddatum `1970-01-01` (UNIX-Zeitraum).
`format`	Zeichenfolge	Optional	Eine Zeichenfolge, die das Format angibt, in dem Datum und Uhrzeit zurückgegeben werden sollen. Verwenden Sie die Java SimpleDateFormat-Notation, um das Format der Antwort anzugeben. Standardmäßig gibt die Funktion das Datum und die Uhrzeit im Format `"MM/DD/YY HH:mm aaa"` zurück.
`timezone`	Zeichenfolge	Optional	Eine Zeichenfolge, die die Zeitzone angibt, in der Datum und Uhrzeit zurückgegeben werden sollen. Standardmäßig gibt die Funktion das Datum und die Uhrzeit in der Zeitzone des Anrufers zurück. Wenn Sie eine andere Zeitzone verwenden möchten, geben Sie einen Zeitzonenkennzeichner an, beispielsweise `America/New_York`. Eine vollständige Liste der Zeitzonenkennzeichner finden Sie unter IANA (TZDB)-Zeitzoneninformationen. Wenn Sie eine `Zeitzone` angeben, müssen Sie auch ein `Format` angeben.

Beispiel für ein Datum ohne Uhrzeit, Format oder Zeitzone

Formel: FORMATDATETIME("01/31/2025")

Rückgabewert: "1/30/25 4:00 PM"

Beispiel für Datum/Uhrzeit ohne Format oder Zeitzone

Formel: FORMATDATETIME("01/31/2025T12:00:00")

Rückgabewert: "1/31/25 4:00 AM"

Beispiel für Datum/Uhrzeit ohne Zeitzone

Formel: FORMATDATETIME("01/31/2025T12:00:00", "yyyy-MM-dd'T'HH:mm:ssZ")

Rückgabewert: "2025-01-31T04:00:00-0800"

Datum/Uhrzeit-Beispiel

Formel: FORMATDATETIME("01/31/2025T12:00:00", "yyyy-MM-dd'T'HH:mm:ssZ", "America/Los_Angeles")

Rückgabewert: "2025-01-31T04:00:00-0800"

Datum/Uhrzeit-Beispiel

Formel: FORMATDATETIME("01/31/2025T12:00:00", "yyyy-MM-dd'T'HH:mm:ssZ", "America/New_York")

Rückgabewert: "2025-01-31T07:00:00-0500"

Omnistudio FORMATDATETIMEGMT Function

Gibt ein Datum und eine Uhrzeit als Zeichenfolge in einem angegebenen Format und in der GMT-Zeitzone zurück.

Die Greenwich-Mittelzeit (GMT) entspricht der koordinierten Weltzeit (Coordinated Universal Time, UTC), die als Grundlage für die UNIX-Zeit und die UNIX-Zeit dient.

Signatur

FORMATDATETIMEGMT(datetime, timezone, format)

Rückgabewert

Zeichenfolge

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`datetime`	Datetime	Erforderlich	Ein Datum und eine Uhrzeit, die als Zeichenfolge im Format Day.js angegeben sind. Sie können nur ein Datum oder eine Uhrzeit angeben. Wenn Sie nur ein Datum angeben, lautet die Standardzeit `00:00:00`. Wenn Sie nur eine Uhrzeit angeben, lautet das Standarddatum `1970-01-01` (UNIX-Zeitraum).
`timezone`	Zeichenfolge	Optional	Eine Zeichenfolge, die die Zeitzone des angegebenen Datums und der angegebenen Uhrzeit angibt. Standardmäßig verwendet die Funktion die Zeitzone des Anrufers. Wenn Sie eine andere Zeitzone verwenden möchten, geben Sie einen Zeitzonenkennzeichner an, beispielsweise `America/New_York`. Eine vollständige Liste der Zeitzonenkennzeichner finden Sie unter IANA (TZDB)-Zeitzoneninformationen.
`format`	Zeichenfolge	Optional	Eine Zeichenfolge, die das Format angibt, in dem Datum und Uhrzeit zurückgegeben werden sollen. Verwenden Sie die Java SimpleDateFormat-Notation, um das Format der Antwort anzugeben. Standardmäßig gibt die Funktion das Datum und die Uhrzeit im Format `"MM/DD/YY HH:mm aaa"` zurück. Wenn Sie ein `Format` angeben, müssen Sie auch eine `Zeitzone` angeben.

Datum ohne Uhrzeit, Zeitzone oder Formatbeispiel

Formel: FORMATDATETIMEGMT("01/31/2025")

Rückgabewert: "2025-01-31T08:00:00.000Z"

Datum/Uhrzeit ohne Zeitzone oder Formatbeispiel

Formel: FORMATDATETIMEGMT("01/31/2025T12:00:00")

Rückgabewert: "2025-01-31T20:00:00.000Z"

Beispiel für Datum/Uhrzeit ohne Format

Formel: FORMATDATETIMEGMT("01/31/2025T12:00:00", "America/Los_Angeles")

Rückgabewert: "2025-01-31T20:00:00.000Z"

Datum/Uhrzeit-Beispiel

Formel: FORMATDATETIMEGMT("01/31/2025T12:00:00", "America/Los_Angeles", "yyyy-MM-dd'T'HH:mm:ssZ")

Rückgabewert: "2025-01-31T20:00:00+0000"

Datum/Uhrzeit-Beispiel

Formel: FORMATDATETIMEGMT("01/31/2025T12:00:00", "America/New_York", "yyyy-MM-dd'T'HH:mm:ssZ")

Rückgabewert: "2025-01-31T17:00:00+0000"

OmniStudio HOUR-Funktion

Gibt die Stunde für eine angegebene Zeit als Ganzzahlwert zurück.

Signatur

Hour(time)

Rückgabewert

Ganze Zahl

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`time`	Datetime	Erforderlich	Eine Uhrzeit, die als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben.

Zeitbeispiel

Formel: HOUR("08:00:00")

Formel: HOUR("T08:00:00")

Rückgabewert: 8

Beispiel für Datum und Uhrzeit

Formel: HOUR("2004-02-01T08:00:00Z")

Formel: HOUR("02/01/2004T08:00:00Z")

Rückgabewert: 8

JSON-Objektbeispiel

Beispieldaten: "DateField": "2003-02-01T16:35:30Z"

Formel: HOUR(%DateField%)

Rückgabewert: 16

OmniStudio-MINUTE-Funktion

Gibt die Minute für eine angegebene Zeit als Ganzzahlwert zurück.

Signatur

MINUTE(time)

Rückgabewert

Ganze Zahl

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`time`	Datetime	Erforderlich	Eine Uhrzeit, die als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben.

Zeitbeispiel

Formel: MINUTE("08:17:00")

Formel: MINUTE("T08:17:00")

Rückgabewert: 17

Beispiel für Datum und Uhrzeit

Formel: MINUTE("2004-02-01T08:17:00Z")

Formel: MINUTE("02/01/2004T08:17:00Z")

Rückgabewert: 17

JSON-Objektbeispiel

Beispieldaten: "DateField": "2003-02-01T16:35:30Z"

Formel: MINUTE(DateField)

Rückgabewert: 35

OmniStudio-MONAT-Funktion

Gibt den Monat für ein angegebenes Datum als Ganzzahlwert zurück.

Signatur

MONTH(date)

Rückgabewert

Ganze Zahl

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`date`	Datetime	Erforderlich	Ein Datum, das als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben.

Beispiel für Datumszeichenfolge

Formel: MONTH("2025-01-01")

Formel: MONTH("01/01/2025")

Formel: MONTH("1/1/2025")

Rückgabewert: 1

JSON-Objektbeispiel

Beispieldaten: "Birthdate": "2007-06-25T08:35:00Z"

Formel: MONTH(%Birthdate%)

Rückgabewert: 6

OmniStudio NOW-Funktion

Gibt das aktuelle Datum und die aktuelle Uhrzeit in einem angegebenen Format zurück.

Standardmäßig gibt die Funktion Datum und Uhrzeit in koordinierter Weltzeit zurück. UTC entspricht Greenwich Mean Time (GMT). Verwenden Sie die $Vlocity.NOW , um die Zeitzone des Benutzers oder der Organisation anzuwenden.

Sie können die Funktion "NOW" mit anderen Funktionen verwenden, um ein Datum und eine Uhrzeit anzugeben, die sich auf das aktuelle Datum und die aktuelle Uhrzeit beziehen.

Signatur

NOW(format)

Rückgabewert

Datetime

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`format`	Zeichenfolge	Optional	Eine Formatzeichenfolge in der Notation SimpleDateFormat, die das Format der Antwort angibt. Standardmäßig gibt die Funktion Datum und Uhrzeit im Format `"yyyy-MM-dd'T'HH:mm:ss:SSS"` UTC (GMT) zurück.

Beispiel für kein Format

Formel: NOW()

Rückgabewert: "2025-03-08T22:01:46.684Z"

Java SimpleDateFormat-Beispiel für Datum und Uhrzeit

Formel: NOW("yyyy-MM-dd'T'HH:mm:ss")

Rückgabewert: "2025-03-08T22:10:42"

Java SimpleDateFormat-Beispiel für Datum und Uhrzeit

Formel: NOW("yyyy-MM-dd'T'HH:mm:ss z")

Rückgabewert: "2025-03-08T22:08:24 GMT"

Java SimpleDateFormat-Beispiel für Datum und Uhrzeit

Formel: NOW("yyyy-MM-dd'T'HH:mm:ss Z")

Rückgabewert: "2025-03-08T22:07:30 +0000"

Java SimpleDateFormat-Beispiel für Datum und Uhrzeit

Formel: NOW("yyyy-MM-dd'T'HH:mm:ss:SSS")

Rückgabewert: "2025-03-08T21:59:24:895"

Java SimpleDateFormat-Beispiel für Datum und Uhrzeit

Formel: NOW("yyyy-MM-dd'T'HH:mm:ss:SSSz")

Rückgabewert: "2025-03-08T21:57:48:740GMT"

Java SimpleDateFormat-Beispiel für Datum und Uhrzeit

Formel: NOW("yyyy-MM-dd'T'HH:mm:ss:SSSZ")

Rückgabewert: "2025-03-08T21:58:08:412+0000"

Java SimpleDateFormat Date-Only Example

Formel: NOW("yyyy-MM-dd")

Formel: NOW("MM/dd/yyyy")

Rückgabewert: "03/08/2025"

Beispiel für ein reines Java SimpleDateFormat

Formel: NOW("HH:mm:ss")

Rückgabewert: "22:12:30"

Beispiel für ein reines Java SimpleDateFormat

Formel: NOW("HH:mm:ss.SSS")

Rückgabewert: "22:13:43.304"

Beispiel für mehrere Funktionen

Beispieldaten: Die Funktion wird am 8. März 2025 um 10:16:19 UTC (GMT) aufgerufen ("2025-03-08T22:16:19Z").

Formel: DATETIMETOUNIX(NOW("yyyy-MM-dd'T'HH:mm:ss"))

Rückgabewert: 1741472179000

Beispiel für mehrere Funktionen

Beispieldaten: Die Funktion wird am 8. März 2025 um 10:16:19 UTC (GMT) aufgerufen ("2025-03-08T22:16:19.956Z").

Formel: DATETIMETOUNIX(NOW())

Rückgabewert: 1741472179956

OmniStudio SECOND-Funktion

Gibt die zweite für eine angegebene Zeit als Ganzzahlwert zurück.

Signatur

SECOND(time)

Rückgabewert

Ganze Zahl

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`time`	Datetime	Erforderlich	Eine Uhrzeit, die als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben.

Zeitbeispiel

Formel: SECOND("08:00:59")

Formel: SECOND("T08:00:59")

Rückgabewert: 59

Beispiel für Datum und Uhrzeit

Formel: SECOND("2004-02-01T08:00:59Z")

Formel: SECOND("02/01/2004T08:00:59Z")

Rückgabewert: 59

JSON-Objektbeispiel

Beispieldaten: "DateField": "2003-02-01T16:35:30Z"

Formel: SECOND(%DateField%)

Rückgabewert: 30

OmniStudio TIMEDIFF-Funktion

Gibt die Differenz in der Anzahl der Millisekunden zwischen zwei angegebenen Zeiten als Ganzzahl zurück.

Die zweite Zeit wird von der ersten Zeit subtrahiert. Wenn der zweite Zeitpunkt größer als der erste Zeitpunkt ist, gibt die Funktion eine negative Ganzzahl zurück. Wenn Sie eine Zeitzone angeben, berücksichtigt die Funktion sie bei ihrer Berechnung.

Signatur

TIMEDIFF(firstTime, secondTime)

Rückgabewert

Ganze Zahl

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`firstTime`	Datetime	Erforderlich	Eine Uhrzeit, die als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben. Wenn Sie nur ein Datum angeben, verwendet die Funktion `00:00:00:000` als Uhrzeit.
`secondTime`	Datetime	Erforderlich	Eine Zeit, für die die Funktion die Differenz der Anzahl der Millisekunden zwischen dem ersten Zeitpunkt berechnen soll. Geben Sie eine Uhrzeit als Zeichenfolge im Format Day.js an. Sie können ein Datum und eine Uhrzeit angeben. Wenn Sie nur ein Datum angeben, verwendet die Funktion `00:00:00:000` als Uhrzeit.

Beispiel für positive Zeiten

Formel: TIMEDIFF("16:35:30", "08:00:15")

Rückgabewert: 30915000

Beispiel für negative Zeiten

Formel: TIMEDIFF("T08:00:15", "T16:35:30")

Rückgabewert: -30915000

Beispiel für positive Datumswerte

Formel: TIMEDIFF("2001-02-01", "02/01/2000")

Rückgabewert: 31622400000

Beispiel für Datum und Uhrzeit mit Zeitzone

Formel: TIMEDIFF("03/01/2025T12:00:00+0000", "03/01/2025T12:00:00-0500")

Rückgabewert: 43200000

JSON-Objektbeispiele

Beispieldaten:

"Account": [
  {
    "Cases": [
      {
        "Case1": {
          "CreatedDate": "2/1/2024T16:35:30 GMT -0500 (EDT)",
          "LastUpdate": "2/8/2024T09:15:00 GMT -0500 (EDT)"
        }
      },
      {
        "Case2": {
          "CreatedDate": "2/2/2025T11:05:05 GMT -0500 (EDT)",
          "LastUpdate": "2/3/2025T15:50:57 GMT -0500 (EDT)"
        }
      }
    ]
  }
]

Formel: TIMEDIFF(Account:Cases:Case2:CreatedDate, Account:Cases:Case2:LastUpdate)

Rückgabewert: -86400000

Formel: TIMEDIFF(%Account:Cases:Case2:LastUpdate%, %Account:Cases:Case2:CreatedDate%)

Rückgabewert: 86400000

OmniStudio TODAY-Funktion

Gibt das aktuelle Datum zurück.

Die TODAY-Funktion gibt immer das aktuelle Datum im Format "YYYY-MM-DD" zurück. Standardmäßig gibt die Funktion das Datum in koordinierter Weltzeit zurück. UTC entspricht Greenwich Mean Time (GMT). Verwenden Sie die $Vlocity.NOW , um die Zeitzone des Benutzers oder der Organisation anzuwenden.

Sie können die Funktion "TODAY" mit anderen Funktionen verwenden, um ein Datum anzugeben, das sich auf das aktuelle Datum bezieht.

Signatur

TODAY()

Rückgabewert

Datetime

Parameter

Ohne

Beispiel für heute

Formel: TODAY()

Rückgabewert: "2025-01-15"

Beispiel für den ersten Tag des nächsten Jahres

Formel: CONCAT(YEAR(ADDYEAR(TODAY(), 1)), "-01-01")

Rückgabewert: "2026-01-01"

Omnistudio UNIXTODATETIME Function

Gibt das Datum und die Uhrzeit für eine in UNIX-Zeit angegebene Anzahl von Sekunden oder Millisekunden zurück.

Signatur

UNIXTODATETIME(timestamp)

Rückgabewert

Datetime

Parameter

Parameter	Datentyp	Notwendigkeit	Beschreibung
`timestamp`	Ganzzahl	Erforderlich	Eine positive Ganzzahl, die die Anzahl der Sekunden oder Millisekunden darstellt, die seit der UNIX-Zeit vergangen sind. Der Wert wird als UNIX-Zeitstempel bezeichnet.

Beispiel für einen Zeitstempel in Sekunden

Formel: UNIXTODATETIME(1012581330)

Rückgabewert: "2002-02-01T16:35:30.000Z"

Beispiel für einen Zeitstempel in Millisekunden

Formel: UNIXTODATETIME(1012581330000)

Rückgabewert: "2002-02-01T16:35:30.000Z"

OmniStudio-JAHR-Funktion

Gibt das Jahr für ein angegebenes Datum als Ganzzahlwert zurück.

Signatur

YEAR(date)

Rückgabewert

Ganze Zahl

Parameter

Parameter	Datentyp	Notwendigkeit ..	Beschreibung
`date`	Datetime	Erforderlich	Ein Datum, das als Zeichenfolge im Format Day.js angegeben ist. Sie können ein Datum und eine Uhrzeit angeben.

Beispiel für Datumszeichenfolge

Formel: YEAR("2025-01-01")

Formel: YEAR("01/01/2025")

Formel: YEAR("1/1/2025")

Rückgabewert: 2025

JSON-Objektbeispiel

Beispieldaten:

"Account": [
  {
    "Cases": [
      {
        "Case1": {
          "CreatedDate": "2/1/2024T16:35:30 GMT -0500 (EDT)",
          "LastUpdate": "2/8/2024T09:15:00 GMT -0500 (EDT)"
        }
      },
      {
        "Case2": {
          "CreatedDate": "2/2/2025T11:05:05 GMT -0500 (EDT)",
          "LastUpdate": "2/3/2025T15:50:57 GMT -0500 (EDT)"
        }
      }
    ]
  }
]

Formel: YEAR(Account:Cases:Case1:CreatedDate)

Rückgabewert: 2024

Formel: YEAR(Account:Cases:Case2:CreatedDate)

Rückgabewert: 2025

Konnten Sie Ihr Problem mithilfe dieses Artikels lösen?

Geben Sie uns Feedback, damit wir uns verbessern können.

Dieser Text wurde mit dem maschinellen Übersetzungssystem von Salesforce übersetzt. Weitere Details finden Sie hier.Zu Englisch wechselnNicht jetzt

Produktbereich

Auswirkungen auf Funktionen

Edition

Erfahrung

OmniStudio-Datums- und -Uhrzeitfunktionen

OmniStudio-ADDDAY-Funktion

Signatur

Rückgabewert

Parameter

OmniStudio ADDMONTH-Funktion

Signatur

Rückgabewert

Parameter

OmniStudio-AddYEAR-Funktion

Signatur

Rückgabewert

Parameter

OmniStudio AGE-Funktion

Signatur

Rückgabewert

Parameter

Omnistudio AGEON Function

Signatur

Rückgabewert

Parameter

Omnistudio DATEDIFF Function

Signatur

Rückgabewert

Parameter

Omnistudio DATETIMETOUNIX Function

Signatur

Rückgabewert

Parameter

OmniStudio DAY-Funktion

Signatur

Rückgabewert

Parameter

Omnistudio EOM Function

Signatur

Rückgabewert

Parameter

OmniStudio-Funktion FORMATDATETIME

Signatur

Rückgabewert

Parameter

Omnistudio FORMATDATETIMEGMT Function

Signatur

Rückgabewert

Parameter

OmniStudio HOUR-Funktion

Signatur

Rückgabewert

Parameter

OmniStudio-MINUTE-Funktion

Signatur

Rückgabewert

Parameter

OmniStudio-MONAT-Funktion

Signatur

Rückgabewert

Parameter

OmniStudio NOW-Funktion

Signatur

Rückgabewert

Parameter

OmniStudio SECOND-Funktion

Signatur

Rückgabewert

Parameter

OmniStudio TIMEDIFF-Funktion

Signatur

Rückgabewert

Parameter

OmniStudio TODAY-Funktion

Signatur

Rückgabewert

Parameter

Omnistudio UNIXTODATETIME Function

Signatur

Dieser Text wurde mit dem maschinellen Übersetzungssystem von Salesforce übersetzt. Weitere Details finden Sie hier.