Använda värdena Datum, Datum/Tid och Tid i formler
Datumformler är användbar för att hantera förfallodatum för betalningar, kontraktatum eller andra egenskaper för din organisation som beror på tid eller datum.
Versioner som krävs
| Tillgängliga i: både Salesforce Classic och Lightning Experience |
| Tillgängliga i: Alla versioner |
Två typer av data används för arbete med datum: Datum och datum/tid En datatyp, Tid, är oberoende av datumet för att följa tid, till exempel öppettider. De flesta värdena som används vid arbete med datum är typen Datum som lagrar år, månad och dag. Vissa fält som CreatedDate är Datum/tid-fält vilket betyder att de inte bara lagrar ett datumvärde, men även ett tidsvärde (lagras i GMT men visas i användarens tidszon). Fälten Datum, Datum/Tid och Tid formateras efter användarens plats när de visas i rapporter och postdetaljsidor. Ett Tidvärdes precision är i millisekunder. Ett datum/tidvärdes precision är i sekunder.
Du kan använda åtgärder som addera och subtrahera för värden för Datum, Datum/Tid och Tid för att beräkna ett framtida datum eller den tid som gått mellan två datum eller tider. Om du subtraherar ett datum från ett annat kommer värdet att motsvara skillnaden de två inledande värdena i dagar (nummertyp). Samma åtgärd mellan två datum/tid-värden ger ett decimalvärde som anger skillnaden i antal dagar, timmar och minuter. Samma operation mellan två tidsvärden returnerar millisekund
Om skillnaden mellan två datum/tid-värden är 5,52 betyder det att två värden separeras med fem dagar, 12 timmar (en halv dag) och 28 minuter (0,02 av en dag). Du kan även lägga till nummervärden till datum och datum/tid. Till exempel returnerar operationens TODAY() + 3 tre dagar efter dagens datum. Mer information och exempel på att arbeta med datum finns i listan över Exempel på datumformler.
Över alla exempel används variablerna datum och datum/tid istället för de aktuella datum- och datum/tid-fälten eller värdena.
Kom ihåg att komplicerade datumfunktioner har tendensen att kompilera till en större storlek än formelfunktioner med text eller nummer så du kanske påträffar problem med formelns kompileringsstorlek.
TODAY(), NOW() och TIMENOW()
Funktionen TODAY() returnerar den aktuella dagen, månaden och året som datatypen Datum. Den här funktionen är användbar för formler där du behöver se hur många dagar som gått sedan det tidigare datumet, datumet för ett visst antal dagar i framtiden eller om du bara vill visa det aktuella datumet.
Funktionen NOW() returnerar datum/tid-värdet för det aktuella ögonblicket. Den är användbar när du behöver specifika tider under dagen samt datumet.
Funktionen TIMENOW() returnerar ett värde i GMT som representerar den aktuella tidpunkten utan datumet. Använd denna funktion istället för NOW() om du vill ha den aktuella timmen, minuten, sekunden eller millisekunden. Detta värde är användbart för att följa tid, som till exempel arbetsskift eller förfluten tid.
För detaljer om hur du konverterar mellan datumvärden och datum/tid-värden, se Konvertera mellan datum/tid och datum.
Funktionen DATE()
Funktionen DATE() returnerar ett datumvärde som ges ett år, en månad och en dag. Numeriska J/M/D-värden och funktionerna YEAR(), MONTH() och DAY() är giltiga parametrar för DATE(). Till exempel returnerar DATE( 2013, 6, 1 ) 1 juni 2013. På samma sätt returnerar DATE( YEAR( TODAY() ), MONTH( TODAY() ) + 3, 1) datumvärdet för den första dagen tre månader från idag i det innevarande året, förutsatt att datumet är giltigt (till exempel att månaden hamnar mellan 1 och 12).
Om de inmatade J/M/D-värdena resulterar i ett ogiltigt datum returnerar DATE() ett fel, så felkontroll är en viktig del av arbetet med datumvärden. Du kan läsa om metoder för hantering av ogiltiga datum i Exempel på datumformler.
Konvertera mellan datum/tid och datum
Datum/tid och datum är inte utbytbara datatyper så när du vill göra åtgärder mellan Datum/tid och datum-värden, måste du konvertera värdena så att båda är av samma typ. Vissa funktioner (som YEAR(), MONTH() och DAY()) fungerar även endast för datumvärden, så datum/tid-värden måste konverteras först.
Använd funktionen DATEVALUE( date/time
) för att returnera datumvärdet för ett datum/tid. Till exempel, för att hämta året från ett datum/tid, använd YEAR( DATEVALUE(
date/time ) ) ).
Om en formel refererar till ett datum/tid-fält men returnerar ett datum ignoreras tidskomponenten utan att konverteras till användarens tidszon. Detta beteende kan resultera i ett felaktigt datum. För att korrigera för användarens tidszon, använd funktionen DATEVALUE() för att konvertera fältet Datum/tid.
Du kan konvertera ett datumvärde till ett datum/tid med hjälp av funktionen DATETIMEVALUE( date ). Tiden ställs in till 12:00 i Greenwich Mean Time (GMT) och konverteras sedan till tidszonen som användaren ser när posten visas. För en användare i San Francisco returnerar DATETIMEVALUE( TODAY() ) 17:00 föregående dag (under Sparande av dagsljus) istället för 12:00 innevarande dag. Se En notis om datum/tid och tidszoner för ytterligare information.
Konvertera mellan Datum/Tid och Tid
Funktionen TIMEVALUE() returnerar ett värde för datatypen Tid i formatet “TT:MM:SS.MS” (timmar:minuter:sekunder.millisekunder) med en 24-timmarsklocka. Numeriska H/M/S/MS-värden och funktionerna HOUR(), MINUTE(), SECONDS() och MILLISECONDS() är giltiga parametrar för TIMEVALUE().
Använd funktionen TIMEVALUE(value) för att returnera värdet Tid för en datum/tid-typ, text, kopplingsfält eller uttryck. Extrahera till exempel tiden från ett ClosedDate Datum/Tid-värde med TIMEVALUE(ClosedDate).
Konvertera mellan datum och text
Om du vill inkludera ett datum som en del av en sträng, omge värdet Datum med TEXT() för att konvertera det till text. Till exempel om du vill erhålla dagens datum som text, använd:
"Today's date is " & TEXT( TODAY() )Detta ger datumet i formatet "ÅÅÅÅ-MM-DD" istället för ett format som beror på platsen. Du kan ändra formatet genom att hämta dagen, månaden och året från datumet först och sedan kombinera om den i det format som du önskar. Exempel:
"Today's date is " & TEXT( MONTH( date ) ) & "/" & TEXT( DAY( date ) ) & "/" & TEXT( YEAR( date ) ) ) Du kan även konvertera text till ett datum så att du kan använda strängvärdet med dina andra datumfält och formler. Du vill att din text ska formatteras som “ÅÅÅÅ-MM-DD”. Använd denna formel för att ge datumvärdet:
DATEVALUE( "YYYY-MM-DD" )Konvertera mellan datum/tid och text
Du kan inkludera datum/tid-värden i en sträng med funktionen TEXT(), men du måste vara försiktig med tidszoner. Som exempel tar vi denna formel:
"The current date and time is " & TEXT( NOW() )I denna formel förskjuts NOW() till GMT. Normalt konverteras NOW() till användarens tidszon när de visas, men eftersom de konverteras till text sker ingen konvertering. Som om du kör den här formeln den 1 augusti kl 17:00 i San Francisco time (GMT-7), blir resultatet “Dagens datum och tid är 2013–08–02 00:00:00Z”.
När du konverterar datum/tid till text, inkluderas "Z" vid slutet för att ange GMT. TEXT( date/time ) returnerar "Z" om fältet är tomt. Så om värdet datum/tid som du arbetar med kan vara tomt, kontrollera detta innan konverteringen till text:
IF(
ISBLANK( date/time ),
"",
TEXT( date/time )
)För att konvertera en sträng till ett datum/tid-värde, använd DATETIMEVALUE() som skickas i en sträng i formatet “ÅÅÅÅ-MM-DD HH:MM:SS”. Den här metoden ger datum/tid-värdet i GMT.
Konvertera mellan Tid och Text
Om du vill inkludera tid som en del av en sträng, omge värdet Tid med funktionen TEXT() för att konvertera det till text. Till exempel, om du vill returnera den aktuella tidpunkten som text, använd:
"The time is " & TEXT( TIMENOW() )Denna funktion returnerar tiden i formatet “TT:MM:SS.MS”.
Du kan även konvertera text till en Tid-datatyp så att du kan använda strängvärdet med dina andra Tid-fält och -formler. Formatera din text som “TT:MM:SS.MS” enligt en 24-timmarsklocka. Använd funktionen TIMEVALUE():
TIMEVALUE("17:30:45.125")En notis om datum/tid och tidszoner
Datum- och datum/tid-värden lagras i GMT. När en post sparas justeras fältvärdena från användarens tidszon till GMT och justeras sedan tillbaka till läsarens tidszon när den visas på en posts detaljsidor och rapporter. Med datumkonverteringar är detta inget problem eftersom konverteringen av datum/tid till datum ger samma datumvärde.
När du arbetar med datum/tid-fält och värden görs konverteringen alltid i GMT, inte i användarens tidszon. Genom att dra av ett standard datum/tidsfält från ett annat är inte problem eftersom båda fälten är i samma tidszon. När ett av värdena i kalkylen är en konvertering från ett text eller datumvärde till ett datum/tid-värde, är resultaten annorlunda.
Ta t.ex. en användare i San Francisco som anger värdet 12:00 den 2 augusti, 2013 i ett eget datum/tidsfält som kallas Date_Time_c. Detta värde lagras som 2013–08–02 07:00:00Z, eftersom tidsskillnaden i Pacific Daylight Time är GMT-7. Klockan 12:00 PDT den 1 augusti visar användaren posten och följande formel körs:
Date_Time_c - NOW()I beräkningen är NOW() 2013–08–01 19:00:00Z och dras sedan av från 2013–08–02 07:00:00Z för att ge det förväntade resultatet 0,5 (12 timmar).
Anta att istället för NOW(), konverterar formeln strängen “2013–08–01 12:00:00” till ett datum/tid-värde:
Date_Time_c - DATETIMEVALUE( "2013-08-01 12:00:00" )I detta fall är DATETIMEVALUE(
“2013–08–01 12:00:00” ) 2013–08–01 12:00:00Z och returnerar resultatet 0.79167, eller 19 timmar.
Det finns inte något sätt att fastställa en användares tidszon i en formel. Om alla dina användare befinner sig i samma tidszon kan du justera tidszonens skillnad genom att lägga till eller dra av tidsskillnaden mellan användarens tidszon och GMT till dina konverterade värden. Eftersom tidszonen kan påverkas av sommartiden och start- och slutdatumen för DST är olika varje år, är det svårt att hantera i en formel. Vi rekommenderar en användning av Apex för transaktioner som kräver en konvertering mellan datum/tid-värden och text eller datumvärden.
