Gebruik van waarden voor Datum, Datum/tijd en Tijd in formules
Datumformules zijn handig voor het beheer van betalingsdeadlines, contractleeftijden of andere voorzieningen van uw organisatie, die tijd- of datumafhankelijk zijn.
Vereiste editions
| Beschikbaar in: zowel Salesforce Classic als Lightning Experience |
| Beschikbaar in: Alle editions |
Voor het werken met datums worden twee gegevenstypen gebruikt: Datum en Datum/tijd. Eén gegevenstype, Tijd, is onafhankelijk van de datum voor het bijhouden van tijd, zoals kantooruren. De meeste waarden die worden gebruikt bij het werken met datums, zijn van het gegevenstype Datum, die het jaar, de maand en de dag opslaan. Bepaalde velden, zoals CreatedDate, zijn velden voor Datum/tijd, hetgeen inhoudt dat ze niet alleen een datumwaarde opslaan, maar ook een tijdwaarde (opgeslagen in GMT, maar weergegeven in de tijdzone van de gebruiker). De notatie van velden voor datum, datum/tijd en tijd is afhankelijk van de omgeving van de gebruiker wanneer deze velden worden weergegeven in rapporten en op recorddetailpagina's. De precisie van de waarde van een tijdveld is in milliseconden. De precisie van een datum-/tijdveld is in seconden.
U kunt bewerkingen zoals optellen en aftrekken gebruiken voor waarden voor Datum, Datum/tijd en Tijd om een toekomstige datum of de verstreken tijd tussen twee datums of tijden te berekenen. Als u bijvoorbeeld de ene datum aftrekt van de andere, geeft de resulterende waarde het verschil tussen de twee aanvankelijke waarden aan in dagen (gegevenstype Getal). Dezelfde bewerking tussen twee waarden voor Datum/tijd geeft een decimale waarde die het verschil in aantal dagen, uren en minuten aangeeft. Dezelfde bewerking tussen twee tijdwaarden retourneert milliseconde
Als bijvoorbeeld het verschil tussen twee waarden voor Datum/tijd 5,52 is, betekent dit dat de twee waarden van elkaar zijn gescheiden door vijf dagen, 12 uur (0,5 van een dag) en 28 minuten (0,02 van een dag). U kunt ook numerieke waarden toevoegen aan waarden voor Datum en Datum/tijd. Zo geeft de bewerking TODAY() + 3 drie dagen na de datum van vandaag. Raadpleeg voor meer informatie over en voorbeelden van werken met datums de lijst van Voorbeelden van datumformules.
In alle voorbeelden worden de variabelen datum en datum/tijd gebruikt in plaats van de feitelijke velden of waarden voor Datum en Datum/tijd.
Onthoud dat complexe datumfuncties veelal uitmonden in een grotere grootte dan functies voor tekst- of getalformules, waardoor er problemen kunnen ontstaan met de compileergrootte van formules.
TODAY(), NOW() en TIMENOW()
De functie TODAY() retourneert de huidige dag, de huidige maand en het huidige jaar als een gegevenstype Datum. Deze functie is handig voor formules die betrekking hebben op het aantal dagen dat is verstreken sinds een vorige datum, de datum van een bepaald aantal dagen in de toekomst of gewoon op het weergeven van de huidige datum.
De functie NOW() retourneert de waarde voor Datum/tijd van het huidige moment. Dit is handig voor zowel specifieke tijden van een dag als voor de datum op zich.
De functie TIMENOW() retourneert een waarde in GMT die de huidige tijd zonder datum vertegenwoordigt. Gebruik deze functie in plaats van de functie NOW() als u het huidige uur, de huidige minuut, de huidige seconden of de huidige milliseconden wilt. Deze waarde is nuttig voor het bijhouden van tijd, zoals ploegendiensten of verstreken tijd,
Raadpleeg voor details over conversies tussen waarden voor Datum en waarden voor Datum/tijd Conversies tussen Datum/tijd en Datum.
De functie DATE()
De functie DATE() retourneert een waarde voor Datum, waarbij een jaar, maand en dag zijn gegeven. Numerieke J/M/D-waarden en de functies YEAR(), MONTH() en DAY() zijn geldige parameters voor DATE(). Zo retourneert DATE( 2013, 6, 1 ) 1 juni 2013. Op soortgelijke wijze retourneert DATE( YEAR( TODAY() ), MONTH( TODAY() ) + 3, 1) de waarde Datum van de eerste dag drie maanden na vandaag in het huidige jaar, ervan uitgaande dat de datum geldig is (de maand valt bijvoorbeeld tussen 1 en 12).
Als de ingevoerde J/M/D-waarden resulteren in een ongeldige datum, retourneert de DATE() functie een fout, waardoor foutcontroles een belangrijk onderdeel vormen van werken met waarden voor Datum. Zie Voorbeelden van datumformules voor meer informatie over methoden voor het omgaan met ongeldige datums.
Conversies tussen Datum/tijd en Datum
Datum en Datum/tijd zijn geen onderling verwisselbare gegevenstypen; als u dus bewerkingen wilt uitvoeren tussen waarden voor Datum en Datum/tijd, moet u de waarden dusdanig converteren dat ze van hetzelfde type zijn. Sommige functies (zoals YEAR(), MONTH() en DAY()) werken ook alleen bij waarden voor Datum, waardoor waarden voor Datum/tijd eerst moeten worden geconverteerd.
Gebruik de functie DATEVALUE( date/time
) om de waarde Datum van een Datum/tijd te retourneren. Gebruik bijvoorbeeld YEAR( DATEVALUE(
date/time ) ) ) om het jaar op te halen uit een Datum/tijd.
Als een formule verwijst naar een veld Datum/tijd, maar een datum retourneert, wordt de tijdcomponent genegeerd zonder te converteren naar de tijdzone van de gebruiker. Deze werking kan leiden tot een onjuiste datum. Als u de tijdzone van de gebruiker wilt corrigeren, gebruikt u de functie DATEVALUE() om het veld Datum/tijd te converteren.
U kunt een waarde voor Datum converteren naar een Datum/tijd met behulp van de functie DATETIMEVALUE( date ). De tijd wordt ingesteld op 00:00 uur in Greenwich Mean Time (GMT) en vervolgens geconverteerd naar de tijdzone van de gebruiker die de record bekijkt wanneer deze wordt weergegeven. Voor een gebruiker op de locatie San Francisco retourneert DATETIMEVALUE( TODAY() ) 17:00 uur op de vorige dag (tijdens Daylight Saving Time) in plaats van 00:00 uur van de huidige dag. Zie Een opmerking over datum/tijd en tijdzones voor meer informatie.
Conversies tussen Datum/tijd en Tijd
De functie TIMEVALUE() retourneert een waarde van het gegevenstype Tijd in de indeling "UU:MM:SS.MS" (uren:minuten:seconden.milliseconden), met behulp van een 24-uurs klok. Numerieke H/M/S/MS-waarden en de functies HOUR(), MINUTE(), SECONDS() en MILLISECONDS() zijn geldige parameters voor TIMEVALUE().
Gebruik de functie TIMEVALUE(value) om de tijdwaarde te retourneren van een Datum/Tijd-type, tekst, samenvoegveld of expressie. Haal bijvoorbeeld de tijd uit de Datum/Tijd-waarde ClosedDate met TIMEVALUE(ClosedDate).
Converteren tussen Datum en Tekst
Als u een datum wilt opnemen als deel van een tekenreeks, neemt u de waarde voor Datum op in de functie TEXT() om deze naar tekst te converteren. Als u bijvoorbeeld de datum van vandaag wilt retourneren als tekst, gebruikt u:
"Today's date is " & TEXT( TODAY() )Dit retourneert de datum volgens de notatie "JJJJ-MM-DD" in plaats van de omgevingsafhankelijke notatie. U kunt de notatie wijzigen door de dag, de maand en het jaar eerst uit de datum te extraheren en deze vervolgens opnieuw te combineren in de gewenste notatie. Bijvoorbeeld:
"Today's date is " & TEXT( MONTH( date ) ) & "/" & TEXT( DAY( date ) ) & "/" & TEXT( YEAR( date ) ) ) U kunt tekst ook converteren naar Datum, waardoor u de tekenreekswaarde kunt gebruiken bij uw andere velden en formules voor Datum. Hierbij moet uw tekst de notatie "JJJJ-MM-DD" volgen. Gebruik deze formule om de waarde voor Datum te retourneren:
DATEVALUE( "YYYY-MM-DD" )Conversies tussen Datum/tijd en Tekst
U kunt waarden voor Datum/tijd wel opnemen in een tekenreeks met behulp van de functie TEXT(), maar hierbij moet u oppassen met tijdzones. Kijk bijvoorbeeld eens naar de volgende formule:
"The current date and time is " & TEXT( NOW() )In deze formule wordt NOW() "verschoven" naar GMT. Normaliter wordt NOW() geconverteerd naar de tijdzone van de gebruiker wanneer deze wordt weergegeven, maar omdat deze is geconverteerd naar tekst, vindt er geen conversie plaats. Dus als u deze formule uitvoert op 1 augustus om 17:00 uur bij de tijd van San Francisco (GMT-7), luidt het resultaat "De huidige datum en tijd is 2013–08–02 00:00:00Z".
Wanneer u Datum/tijd converteert naar tekst, wordt er een "Z" opgenomen aan het einde om GMT aan te duiden. TEXT( date/time ) retourneert "Z" als het veld leeg is. Dus als de waarde voor Datum/tijd waarmee u werkt, mogelijk blanco zijn, controleert u dit voordat u gaat converteren naar tekst:
IF(
ISBLANK( date/time ),
"",
TEXT( date/time )
)Voor de conversie van een tekenreeks naar een waarde voor Datum/tijd gebruikt u DATETIMEVALUE() die een tekenreeks doorgeeft volgens de notatie "JJJJ-MM-DD UU:MM:SS". Deze methode retourneert de waarde voor Datum/tijd in GMT.
Conversies tussen Tijd en Tekst
Als u tijd wilt opnemen als deel van een tekenreeks, neemt u de waarde voor Tijd op in de functie TEXT() om deze naar tekst te converteren. Als u bijvoorbeeld de huidige tijd wilt retourneren als tekst, gebruikt u:
"The time is " & TEXT( TIMENOW() )Deze functie retourneert de tijd in de indeling "UU:MM:SS.MS".
U kunt tekst ook converteren naar het gegevenstype Tijd, waardoor u de tekenreekswaarde kunt gebruiken bij uw andere velden en formules voor Tijd. Geef uw tekst de indeling "UUHH:MM:SS.MS" met een 24-uurs klok. Gebruik de functie TIMEVALUE():
TIMEVALUE("17:30:45.125")Een opmerking over datum/tijd en tijdzones
Waarden voor Datum en Datum/tijd worden opgeslagen in GMT. Wanneer een record wordt opgeslagen, worden veldwaarden eerst aangepast vanuit de tijdzone van de gebruiker naar GMT en vervolgens opnieuw aangepast aan de tijdzone van degene die de record bekijkt, wanneer deze wordt weergegeven op recorddetailpagina's en in rapporten. Bij Datum-conversies vormt dit geen probleem, aangezien het converteren van Datum/tijd naar Datum resulteert in dezelfde waarde voor Datum.
Bij het werken met velden en waarden voor Datum/tijd wordt de conversie echter altijd uitgevoerd in GMT, niet de tijdzone van de gebruiker. Het aftrekken van een standaardveld voor Datum/tijd van een ander veld vormt geen probleem omdat beide velden in dezelfde tijdzone liggen. Wanneer een van de waarden in de berekening een conversie is vanuit een waarde voor Tekst of Datum naar een waarde voor Datum/tijd, zijn de resultaten echter anders.
Stel dat een gebruiker in San Francisco een waarde 00:00 uur op 2 augustus 2013 opgeeft in een aangepast veld voor Datum/tijd met de naam Datum_Time_c. Deze waarde wordt opgeslagen als 2013–08–02 07:00:00Z, omdat het tijdverschil in Pacific Daylight Time GMT-7 is. Om 12:00 uur PDT op 1 augustus geeft de gebruiker de record weer en wordt de volgende formule uitgevoerd:
Date_Time_c - NOW()In de berekening is NOW() 2013–08–01 19:00:00Z, dat vervolgens wordt afgetrokken van 2013–08–02 07:00:00Z; dit geeft het verwachte resultaat van 0,5 (12 uur).
Maar stel dat in plaats van NOW() de formule de tekenreeks "2013–08–01 12:00:00" converteert naar een waarde voor Datum/tijd:
Date_Time_c - DATETIMEVALUE( "2013-08-01 12:00:00" )In dat geval geeft DATETIMEVALUE(
“2013–08–01 12:00:00” )( "2013–08–01 12:00:00Z" ) als resultaat 0,79167, oftewel 19 uur.
Er is geen manier om de tijdzone van een gebruiker te bepalen in een formule. Als al uw gebruikers in dezelfde tijdzone zijn, kunt u het tijdzoneverschil aanpassen door het tijdverschil op te tellen bij of af te trekken van de tijdzone van de gebruikers en uw geconverteerde waarden om te zetten naar GMT. Maar omdat tijdzones mogelijk worden beïnvloed door Daylight Saving Time en omdat de begin- en einddatums voor DST elk jaar anders zijn, is het moeilijk om dat in een formule op te nemen. U wordt aangeraden om Apex te gebruiken voor transacties die de conversie vereisen tussen waarden voor Datum/tijd en Tekst of waarden voor Datum.
