breadcrumbDescription
Brug af dato-, dato/tid- og tidsværdier i formler
Datoformler er nyttige til at administrere betalingsfrister, kontraktløbetider eller andre funktioner i din organisation, der er tids- eller datoafhængige.
EditionsHeading
| Tilgængelig i: både Salesforce Classic og Lightning Experience |
| Tilgængelig i: Alle versioner |
Der er to datatyper, der bruges til at arbejde med datoer: Dato og dato/tid. En datatype, Tid, er uafhængig af datoen for sporingstid, f.eks. arbejdstider. De fleste værdier bruges, når du arbejder med datoer, der er af datatypen dato, som lagrer år, måned og dag. Nogle felter, f.eks. CreatedDate, er dato/tidsfelter, hvilket betyder, at de ikke kun lagrer en datoværdi, men også en tidsværdi (lagres i GMT, men vises i brugerens tidszone). Dato-, dato/tid- og tidsfelter formateres i brugerens landestandard, når de vises i rapporter og på registreringsdetaljesider. En tidsværdis præcision er i millisekunder. Et dato/tid-værdis præcision er i sekunder.
Du kan bruge handlinger som plus og minus i dato- og dato/tids- og tidsværdier til at beregne en fremtidig dato eller forløbet tid mellem to datoer eller tider. Hvis du f.eks. trækker en dato fra en anden, vil den resulterende værdi være forskellen mellem de to indledende værdier i dage (taldatatype). Den samme handling mellem to dato/tidsværdier returnerer en decimalværdi, der angiver forskellen i antallet af dage, timer og minutter. Den samme handling mellem to tidsværdier returnerer millisekund
Hvis f.eks. forskellen mellem to dato/tidsværdier er 5,52, betyder det, at de to værdier er adskilt af fem dage, 12 timer (0,5 af en dag) og 28 minutter (0,02 af en dag). Du kan også tilføje numeriske værdier til dato- og dato/tid. F.eks. returnerer handlingen TODAY() + 3 tre dage efter dags dato. Hvis du ønsker flere oplysninger og eksempler på arbejde med datoer, kan du se listen over Eksempeldatoformler.
Overalt i eksemplerne bruges variablerne dato og dato/tid i stedet for de faktiske dato- og dato/tidsfelter eller -værdier.
Husk på, at komplekse datofunktioner har en tendens til at blive kompileret til en større størrelse end tekst- eller talformelfunktioner, så du kan få problemer med formelkompileringsstørrelsen.
TODAY(), NOW() og TIMENOW()
Funktionen TODAY() returnerer den aktuelle dag, måned og år som en Dato-datatype. Denne funktion er nyttig til formler, hvor du er bekymret for, hvor mange dage, der er gået siden en tidligere dato, datoen for et bestemt antal dage i fremtiden, eller hvis du blot ønsker at vise den aktuelle dato.
Funktionen NOW() returnerer dato/tidsværdien for det aktuelle øjeblik. Det er nyttigt, hvis du er bekymret med specifikke tider på dagen så vel som datoen.
Funktionen TIMENOW() returnerer en værdi i GMT, der viser den aktuelle tid uden datoen. Brug denne funktion i stedet for funktionen NOW()(), hvis du ønsker aktuel(t) time, minut, sekunder eller millisekunder. Værdien er nyttig til sporing af tid som arbejdsskift eller medgået tid.
Hvis du ønsker oplysninger om, hvordan du konverterer mellem datoværdier og dato/tidsværdier, kan du se Konvertering mellem dato/tid og dato.
Funktionen DATE()
Funktionen DATE() returnerer en Datoværdi, hvis der angives et år, en måned og en dag. Numeriske Y/M/D-værdier og funktionerne YEAR(), MONTH() og DAY() er gyldige parametre for DATE(). DATE( 2013, 6, 1 ) returnerer f.eks. den 1. juni 2013. På samme måde returnerer DATE( YEAR( TODAY() ), MONTH( TODAY() ) + 3, 1) datoværdien for den første dag tre måneder fra i dag i det indeværende år, hvis datoen er gyldig (f.eks. måneden falder mellem 1 og 12).
Hvis de indsatte Å/M/D-værdier resulterer i en ugyldig dato, returnerer DATE()-funktionen en fejl, så fejlkontrollen er en vigtig del af arbejdet med Dato-værdier. Du kan læse om metoder til håndtering af ugyldige datoer i Eksempeldatoformler.
Konvertering mellem dato/tid og dato
Dato og dato/tid er ikke datotyper, der kan byttes om, så når du ønsker at foretage handlinger mellem dato og dato/tidværdier, skal du konvertere værdierne, så de begge har den samme type. Nogle funktioner (som YEAR(), MONTH() og DAY()) fungerer også på datoværdier, så dato/tidsværdier skal først konverteres.
Brug funktionen DATEVALUE( date/time
) til at returnere datoværdien for en dato/tid. Hvis du f.eks. vil hente året fra en dato/tid, skal du bruge YEAR( DATEVALUE(
date/time ) ) ).
Hvis en formel refererer til et dato/tid-felt, men returnerer en dato, ignoreres tidskomponenten uden at konvertere til brugerens tidszone. Denne adfærd kan resultere i en forkert dato. Hvis du vil rette for brugerens tidszone, skal du bruge funktionen DATEVALUE() til at konvertere feltet Dato/tid.
Du kan konvertere en datoværdi til en dato/tid ved brug af funktionen DATETIMEVALUE( date ). Tiden vil blive indstillet til 12:00 GMT (Greenwich Mean Time), og derefter konverteret til tidszonen for den bruger, der betragter registreringen, når den vises. For en bruger, der er placeret i San Francisco, returnerer DATETIMEVALUE( TODAY() ) 17:00 på den foregående dag (under sommertid) i stedet for 12:00 den foregående dag. Se Et notat om dato/tid og tidszoner, hvis du ønsker yderligere oplysninger.
Konvertering mellem dato/tid og tid
Funktionen TIMEVALUE() returnerer en tidsdatatypeværdi i "HH:MM:SS.MS"-format (timer:minutter:sekunder.millisekunder) ved brug af et 24-timers ur. Numeriske H/M/S/MS-værdier og funktionerne HOUR(), MINUTE(), SECONDS() og MILLISECONDS() er gyldige parametre for TIMEVALUE().
Brug funktionen TIMEVALUE(value) til at returnere tidsværdien af en dato/tidstype, tekst, flettefelt eller et udtryk. Udtræk f.eks. tiden fra en ClosedDate-dato/tidsværdi med TIMEVALUE(ClosedDate).
Konvertering mellem dato og tekst
Hvis du ønsker at inkludere en dato, som en del af en streng, skal du indsætte datoværdien i funktionen TEXT() for at konvertere den til tekst. Hvis du f.eks. ønsker at returnere dags dato som tekst, skal du bruge:
"Today's date is " & TEXT( TODAY() )Dette returnerer datoen i formatet "ÅÅÅÅ-MM-DD" snarere end i det landestandardafhængige format. Du kan ændre formatet ved først at udtrække dagen, måneden og året fra datoen, og derefter kombinere dem igen i det ønskede format. Eksempel:
"Today's date is " & TEXT( MONTH( date ) ) & "/" & TEXT( DAY( date ) ) & "/" & TEXT( YEAR( date ) ) ) Du kan også konvertere tekst til en dato, så du kan bruger strengværdien sammen med dine andre datofelter og -formler. Du ønsker sikkert, at din tekst skal formateres som "ÅÅÅÅ-MM-DD". Brug denne formel til at returnere datoværdien:
DATEVALUE( "YYYY-MM-DD" )Konvertering mellem dato/tid og tekst
Du kan også inkludere dato/tidsværdier i en streng ved brug af funktionen TEXT()(), men du skal være forsigtig med tidszoner. Overvej f.eks. denne formel:
"The current date and time is " & TEXT( NOW() )I denne formel er NOW() forskudt til GMT. Normalt vil NOW() blive konverteret til brugerens tidszone, når den bliver vist, men da den er konverteret til tekst, vil konverteringen ikke finde sted. Så hvis du aktiverer denne formel den 1. august kl. 17:00 i San Francisco-tid (GMT-7), vil resultatet blive "Den aktuelle dato og tid er 2013–08–02 00:00:00Z".
Når du konverterer en dato/tid til tekst, medtages der et "Z" til sidst for at angive GMT. TEXT( date/time ) returnerer "Z", hvis feltet er tomt. Så, hvis den dato/tidsværdi, som du arbejder på, er tom, skal du kontrollere dette, før du konverterer til tekst:
IF(
ISBLANK( date/time ),
"",
TEXT( date/time )
)Hvis du vil konvertere en streng til en dato/tidsværdi, skal du bruge DATETIMEVALUE() i formatet "ÅÅÅÅ-MM-DD TT:MM:SS". Denne metode returnerer dato/tidsværdien i GMT.
Konvertering mellem tid og tekst
Hvis du ønsker at inkludere tid som en del af en streng, skal du indsætte tidsværdien i funktionen TEXT() for at konvertere den til tekst. Hvis du f.eks. ønsker at returnere aktuel tid som tekst, skal du bruge:
"The time is " & TEXT( TIMENOW() )Denne funktion returnerer tiden i formatet "HH:MM:SS.MS".
Du kan også konvertere tekst til en tidsdatatype, så du kan bruger strengværdien sammen med dine andre tidsfelter og -formler. Formater din tekst som "HH:MM:SS.MS" på et 24-timers ur. Brug TIMEVALUE()-funktionen:
TIMEVALUE("17:30:45.125")Et notat om dato/tid og tidszoner
Dato og dato/tidsværdier lagres i GTM. Når en registrering gemmes, justeres feltværdier fra brugerens tidszone til GMT, og justeres derefter tilbage til seerens tidszone, når de vises i registreringsdetaljesider og rapporter. Med datokonverteringer udgør dette ikke et problem, da konvertering af en dato/tid til en dato resulterer i den samme datoværdi.
Når du arbejder med dato/tidsfelter og -værdier, udføres konverteringen altid i GMT, ikke i brugerens tidszone. Hvis du fratrækker et standard dato/tidsfelt fra et andet, bliver det ikke et problem, da begge felter er i samme tidszone. Når en af værdierne i beregningen er en konvertering fra en tekst- eller datoværdi til en dato/tidsværdi, får du et andet resultat.
Lad os antage at en bruger i San Francisco indtaster en værdi på 12:00 den 2. august i et tilpasset dato/tidsfelt ved navn Date_Time_c. Denne værdi lagres som 2013-08-02 07:00:00Z, da tidsforskellen i Pacific Daylight Time er GMT-7. Kl. 12:00 PDT den 1. august ser brugeren registreringen og følgende formel køres:
Date_Time_c - NOW()I beregningen er NOW() 2013-08-01 19:00:00Z, hvorefter det trækkes fra 2013-08-02 07:00:00Z, så det returnerer det forventede resultat på 0,5 (12 timer).
Antag at i stedet for NOW(), konverterer formlen stregen "2013-08-01 12:00:00" til en Date/tid-værdi:
Date_Time_c - DATETIMEVALUE( "2013-08-01 12:00:00" )I denne situation er DATETIMEVALUE(
“2013–08–01 12:00:00” ) 2013-08-01 12:00:00Z, og returnerer et resultat på 0,79167, eller 19 timer.
Der findes ikke nogen måde, hvorpå du kan bestemme en brugers tidszone i en formel. Hvis alle dine brugere er i den samme tidszone, kan du justere tidszoneforskellen ved at tilføje eller fratrække tidsforskellen mellem brugerens tidszone og GMT til dine konverterede værdier. Men da tidszoner kan påvirkes af sommertid, og start- og slutdatoer for sommertid er forskellige hvert år, er dette vanskeligt at administrere i en formel. Vi anbefaler brug af Apex til transaktioner, der kræver konvertering mellem dato/tids-værdier og tekst eller datoværdier.
