Sie befinden sich hier:
Verwenden von Datums-, Datum/Uhrzeit- und Uhrzeitwerten in Formeln
Datumsformeln sind nützlich zur Verwaltung von Zahlungsfristen, des Vertragsalters und allen anderen Funktionen Ihrer Organisation, für die Uhrzeit oder Datum eine Rolle spielen.
Erforderliche Editionen
| Verfügbarkeit: Salesforce Classic und Lightning Experience |
| Verfügbarkeit: Alle Editionen |
Für die Arbeit mit Datumswerten werden zwei Datentypen verwendet: "Datum" und "Datum/Zeit". Ein Datentyp, nämlich "Uhrzeit", ist unabhängig vom Datum für die Zeitverfolgung, beispielsweise Geschäftszeiten. Die meisten Werte, die bei der Arbeit mit Datumswerten verwendet werden, haben den Datentyp "Datum", bei dem das Jahr, der Monat und der Tag gespeichert werden. Einige Felder "wie CreatedDate" sind Datum/Zeit-Felder, das heißt, sie speichern nicht nur einen Datumswert, sondern auch einen Zeitwert (wird in GMT gespeichert, jedoch in der Zeitzone des Benutzers angezeigt). Die Formatierung der Felder "Datum", "Datum/Uhrzeit" und "Uhrzeit" bei Anzeige in Berichten und auf Datensatz-Detailseiten richtet sich nach dem Gebietsschema des Benutzers. Der Wert vom Typ "Uhrzeit" hat eine Genauigkeit von Millisekunden. Ein Wert vom Typ "Datum/Uhrzeit" hat eine Genauigkeit von Sekunden.
Sie können Operationen wie Addition oder Subtraktion auf Datums-, Datum/Uhrzeit- und Uhrzeitwerte anwenden, um ein in der Zukunft liegendes Datum oder die verstrichene Zeit zwischen zwei Datums- oder Uhrzeitangaben zu berechnen. Wenn Sie beispielsweise ein Datum von einem anderen subtrahieren, erhalten Sie die Differenz zwischen den beiden Ausgangswerten in Tagen (Datentyp "Zahl"). Dieselbe Operation zwischen zwei Datums-/Zeitwerten gibt einen Dezimalwert zurück, der die Differenz in der Anzahl von Tagen, Stunden und Minuten angibt. Derselbe Vorgang zwischen zwei Zeitwerten gibt Millisekunden zurück
Wenn die Differenz zwischen zwei Datums-/Zeitwerten beispielsweise 5,52 ist, bedeutet dies, dass zwischen den beiden Werten fünf Tage, 12 Stunden (0,5 eines Tages) und 28 Minuten (0,02 eines Tages) liegen. Sie können zu Datums- und Datums-/Zeitwerten auch numerische Werte addieren. Die Operation TODAY() + 3 beispielsweise gibt den Tag drei Tage nach dem heutigen Datum zurück. Weitere Informationen und Beispiele für die Arbeit mit Datumswerten finden Sie in der Liste der Beispiel-Datumsformeln.
In allen Beispielen werden anstelle tatsächlicher Datums- und Datum/Zeit-Felder oder -werte die Variablen date und date/time verwendet.
Beachten Sie, dass komplexe Datumsfunktionen oftmals eine größere kompilierte Größe haben als Funktionen mit Text- oder Zahlenformeln, es können sich also Probleme mit der kompilierten Größe von Formeln ergeben.
TODAY(), NOW() und TIMENOW()
Die TODAY()-Funktion gibt den aktuellen Tag, den aktuellen Monat und das aktuelle Jahr als Datentyp "Datum" zurück. Diese Funktion ist nützlich für Formeln, mit denen ermittelt werden soll, wie viele Tage seit einem früheren Datum verstrichen sind, das Datum einer bestimmten Anzahl von Tagen in der Zukunft, oder um einfach nur das aktuelle Datum anzuzeigen.
Die NOW()-Funktion gibt den Datum/Uhrzeit-Wert des aktuellen Moments zurück. Dies ist nützlich, wenn Sie genaue Uhrzeiten sowie das Datum ermitteln möchten.
Die TIMENOW()-Funktion gibt einen Wert in GMT zurück, der die aktuelle Uhrzeit ohne Datum angibt. Verwenden Sie diese Funktion anstelle der Funktion NOW(), wenn Sie die aktuelle Stunde, Minute, Sekunde oder Millisekunde wünschen. Dieser Wert eignet sich zum Nachverfolgen von Zeiten wie Arbeitsschichten oder verstrichener Zeit.
Einzelheiten zur Umwandlung von Datumswerten in Datums-/Zeitwerte und umgekehrt finden Sie unter Umwandeln von Datum/Zeit in Datum und umgekehrt.
Die DATE()-Funktion
Die DATE()-Funktion gibt einen Datumswert aus den angegebenen Jahres-, Monats- und Tageswerten zurück. Numerische J/M/T-Werte und die YEAR()-, MONTH()- undDAY()-Funktion sind gültige Parameter für DATE(). DATE( 2013, 6, 1 ) gibt beispielsweise den 1. Juni 2013 zurück. Ebenso gibt DATE( YEAR( TODAY() ), MONTH( TODAY() ) + 3, 1) den Datumswert des ersten Tages drei Monate nach heute im aktuellen Jahr zurück, vorausgesetzt, das Datum ist gültig (beispielsweise liegt der Monat zwischen 1 und 12).
Wenn die eingegebenen J/M/T-Werte ein ungültiges Datum ergeben, gibt die DATE()-Funktion einen Fehler zurück, die Fehlerprüfung ist also ein wichtiger Teil der Arbeit mit Datumswerten. Informationen über Methoden zur Handhabung ungültiger Datumsangaben finden Sie unter Beispiel-Datumsformeln.
Umwandeln von Datum/Zeit in Datum und umgekehrt
"Datum" und "Datum/Zeit" sind keine austauschbaren Datentypen, wenn Sie also Operationen mit sowohl Datums- als auch Datums-/Zeitwerten durchführen möchten, müssen Sie die Werte in denselben Typ umwandeln. Einige Funktionen (z. B. YEAR(), MONTH() und DAY()) können auch nur mit Datumswerten arbeiten, Datums-/Zeitwerte müssen also zuerst umgewandelt werden.
Mit der Funktion DATEVALUE( date/time
) können Sie den Datumswert einer Datums-/Zeitangabe zurückgeben. Um beispielsweise das Jahr aus einer Datums-/Zeitangabe zu ermitteln, verwenden Sie YEAR( DATEVALUE(
date/time ) ) ).
Wenn eine Formel auf ein Datums-/Uhrzeitfeld verweist, jedoch ein Datum zurückgibt, wird die Zeitkomponente ignoriert, ohne in die Zeitzone des Benutzers konvertiert zu werden. Dieses Verhalten kann zu einem falschen Datum führen. Konvertieren Sie das Feld "Datum/Uhrzeit" mithilfe der Funktion "DATEVALUE()", um die Zeitzone des Benutzers zu korrigieren.
Mit der Funktion DATETIMEVALUE( date ) können Sie einen Datumswert in einen Datums-/Zeitwert umwandeln. Die Zeit wird auf 00:00 Uhr in mittlerer Greenwich-Zeit (Greenwich Mean Time, GMT) festgelegt und dann in die Zeitzone des Benutzers, der den Datensatz gerade anzeigt, zum Zeitpunkt der Anzeige umgewandelt. Für einen Benutzer in San Francisco gibt DATETIMEVALUE( TODAY() ) 17:00 Uhr am vorherigen Tag (in Sommerzeit) statt 00:00 Uhr des aktuellen Tags zurück. Weitere Informationen finden Sie unter Hinweise zu Datum/Uhrzeit und Zeitzonen.
Umwandeln von Datum/Uhrzeit in Uhrzeit und umgekehrt
Die FunktionTIMEVALUE() gibt einen Uhrzeit-Datentypwert im 24-Stunden-Format "HH:MM:SS.MS" (Stunden:Minuten:Sekunden:Millisekunden) zurück. Numerische H/M/S/MS-Werte und die HOUR()-, MINUTE()-, SECONDS()- und MILLISECONDS()-Funktion sind gültige Parameter für TIMEVALUE().
Verwenden Sie die FunktionTIMEVALUE(value), um den Uhrzeitwert eines Datum/Uhrzeit-Typs, Texts, Briefvorlagenfelds oder Ausdrucks zurückzugeben. Zum Beispiel können Sie mit TIMEVALUE(ClosedDate) die Uhrzeit aus einem Datum/Uhrzeit-Wert vom Typ "ClosedDate" extrahieren.
Umwandeln von Datum in Text und umgekehrt
Wenn Sie ein Datum als Teil einer Zeichenfolge aufnehmen möchten, setzen Sie den Datumswert in die TEXT()-Funktion, um ihn in Text umzuwandeln. Wenn Sie beispielsweise das heutige Datum als Text zurückgeben möchten, verwenden Sie:
"Today's date is " & TEXT( TODAY() )Dies gibt das Datum im Format "JJJJ-MM-TT" statt im entsprechenden Format des Gebietsschemas zurück. Sie können das Format ändern, indem Sie zuerst den Tag, Monat und das Jahr aus dem Datum extrahieren und diese dann im gewünschten Format wieder zusammensetzen. Beispiel:
"Today's date is " & TEXT( MONTH( date ) ) & "/" & TEXT( DAY( date ) ) & "/" & TEXT( YEAR( date ) ) ) Sie können auch Text in ein Datum umwandeln, sodass Sie den Zeichenfolgenwert mit Ihren anderen Datumsfeldern und -formeln verwenden können. Sie möchten Ihren Text als "JJJJ-MM-TT" formatieren. Folgende Formel gibt den Datumswert zurück:
DATEVALUE( "YYYY-MM-DD" )Umwandeln von Datum/Zeit in Text und umgekehrt
Mithilfe der TEXT()-Funktion können Sie Datums-/Zeitwerte in eine Zeichenfolge aufnehmen, Sie müssen dabei jedoch auf die Zeitzonen achten. Nehmen Sie zum Beispiel diese Formel:
"The current date and time is " & TEXT( NOW() )In dieser Formel ist NOW() auf GMT verschoben. Normalerweise würde NOW() bei der Anzeige in die Zeitzone des Benutzers umgerechnet werden, da der Wert jedoch in Text umgewandelt wurde, wird diese Umrechnung nicht durchgeführt. Wenn Sie diese Formel also am 01. August um 17:00 Uhr San Franciscoer Zeit (GMT-7) ausführen, lautet das Ergebnis: "Das aktuelle Datum und die Uhrzeit sind 2013–08–02 00:00:00Z".
Wenn Sie einen Datums-/Zeitwert in Text umwandeln, wird am Ende ein "Z" angefügt, um anzugeben, dass es sich um GMT handelt. TEXT( date/time ) gibt "Z" zurück, wenn das Feld leer ist. Wenn also der Datum-/Zeitwert, mit dem Sie arbeiten, leer sein könnte, überprüfen Sie dies, bevor Sie ihn in Text umwandeln:
IF(
ISBLANK( date/time ),
"",
TEXT( date/time )
)Um eine Zeichenfolge in einen Datums-/Zeitwert umzuwandeln, verwenden Sie DATETIMEVALUE() und übergeben Sie diesen Wert in einer Zeichenfolge im Format "JJJJ-MM-TT HH:MM:SS". Diese Methode gibt den Datums-/Zeitwert in GMT zurück.
Umwandeln von Uhrzeit in Text und umgekehrt
Wenn Sie die Uhrzeit als Teil einer Zeichenfolge aufnehmen möchten, setzen Sie den Uhrzeitwert in die TEXT()-Funktion, um ihn in Text umzuwandeln. Wenn Sie beispielsweise die aktuelle Uhrzeit als Text zurückgeben möchten, verwenden Sie:
"The time is " & TEXT( TIMENOW() )Die Funktion gibt die Uhrzeit im Format "HH:MM:SS.MS" zurück.
Sie können auch Text in einen Uhrzeitdatentyp umwandeln, sodass Sie den Zeichenfolgenwert mit Ihren anderen Uhrzeitfeldern und -formeln verwenden können. Formatieren Sie Ihren Text im 24-Stunden-Format "HH:MM:SS.MS". Verwenden Sie die TIMEVALUE()-Funktion:
TIMEVALUE("17:30:45.125")Hinweise zu Datum/Uhrzeit und Zeitzonen
Datums- und Datums-/Zeitwerte werden in GMT gespeichert. Beim Speichern eines Datensatzes werden Feldwerte von der Zeitzone des Benutzers in GMT geändert und dann bei der Anzeige auf Datensatz-Detailseiten und Berichten wieder in die Zeitzone des Benutzers zurück geändert. Bei Datumsumwandlungen stellt dies kein Problem dar, da die Umwandlung eines Datums-/Zeitwerts in einen Datumswert denselben Datumswert ergibt.
Bei der Arbeit mit Datums-/Zeitfeldern und -werten erfolgt die Umwandlung jedoch stets in GMT und nicht in der Zeitzone des Benutzers. Die Subtraktion eines Standard-Datums-/Zeitfelds von einem anderen stellt kein Problem dar, da beide Felder in derselben Zeitzone liegen. Wenn einer der Werte in der Berechnung das Ergebnis einer Umwandlung eines Text- oder Datumswerts in einen Datums-/Zeitwert darstellt, sind die Ergebnisse jedoch unterschiedlich.
Beispiel: Ein Benutzer in San Francisco gibt einen Wert von 00:00 Uhr am 02. August 2013 in ein benutzerdefiniertes Datums-/Zeitfeld mit dem Namen Date_Time_c ein. Dieser Wert wird als "2013–08–02 07:00:00Z" gespeichert, da die Zeitdifferenz in Pacific Daylight Time (PDT) bei GMT-7 liegt. Um 12:00 Uhr PDT am 01. August zeigt der Benutzer den Datensatz an und die folgende Formel wird ausgeführt:
Date_Time_c - NOW()In der Berechnung hat NOW() den Wert "2013–08–01 19:00:00Z". Dieser wird dann von "2013–08–02 07:00:00Z" subtrahiert, was das erwartete Ergebnis 0,5 (12 Stunden) ergibt.
Wenn die Formel anstelle von NOW() die Zeichenfolge "2013–08–01 12:00:00" in einen Datums-/Zeitwert umwandelt, wird Folgendes zurückgegeben:
Date_Time_c - DATETIMEVALUE( "2013-08-01 12:00:00" )In diesem Fall ist DATETIMEVALUE(
“2013–08–01 12:00:00” ) "2013–08–01 12:00:00Z", was ein Ergebnis von 0,79167 oder 19 Stunden ergibt.
Es ist nicht möglich, die Zeitzone eines Benutzers in einer Formel zu ermitteln. Wenn sich alle unsere Benutzer in derselben Zeitzone befinden, können Sie die Zeitzonendifferenz anpassen, indem Sie die Zeitdifferenz zwischen der Zeitzone der Benutzer und GMT zu oder von ihren umgewandelten Werten addieren bzw. subtrahieren. Da sich die Sommerzeit jedoch auf die Zeitzonen auswirken kann und das Start- und Enddatum der Sommerzeit jedes Jahr unterschiedlich sind, lässt sich dies in einer Formel schwierig bewerkstelligen. Wir empfehlen für Transaktionen, bei denen eine Umwandlung von Datums-/Zeitwerten in Text- oder Datumswerte und umgekehrt erforderlich ist, die Verwendung von Apex.
