Bruke dato-, dato/klokkeslett- og klokkeslettverdier i formler
Datoformler er nyttige når du skal behandle betalingsfrister, kontraktløpetider eller andre funksjoner i organisasjonen, som er tids- eller datoavhengige.
Nødvendige utgaver
| Tilgjengelig i både Salesforce Classic og Lightning Experience |
| Tilgjengelig i alle versjoner |
Det brukes to datatyper ved arbeid med datoer: dato- og dato/klokkeslett. Én datatype, Klokkeslett, er uavhengig av datoen for sporingstid, for eksempel åpningstider. De fleste verdier som brukes ved arbeid med datoer, er av datatypen dato, som lagrer år, måned og dag. Noen felt, for eksempel CreatedDate, er dato/klokkeslett-felt, noe som betyr at de ikke bare lagrer en datoverdi, men også en klokkeslettverdi (lagres som GMT-tid, men vises i brukerens tidssone). Dato-, dato/klokkeslett- og klokkeslettfelt formateres etter brukerlandets standard når de vises i rapporter og på postopplysningssider. Presisjonen til verdien i et klokkeslettfelt er millisekunder. Presisjonen til verdien i et dato/klokkeslett-felt er sekunder.
Du kan bruke operasjoner som addisjon og subtraksjon i dato-, dato/klokkeslett- og klokkeslettverdier til å beregne en fremtidig dato eller medgått tid mellom to datoer. Hvis du for eksempel subtraherer en dato fra en annen dato, blir resultatet forskjellen mellom de to første verdiene, i dager (talldatatype). Den samme operasjonen mellom to dato/klokkeslett-verdier returnerer en desimalverdi som angir forskjellen i antall dager, timer og minutter. Den samme operasjonen mellom to klokkeslettverdier returnerer millisekund
Hvis for eksempel forskjellen mellom to dato/klokkeslett-verdier er 5,52, betyr det at det er fem dager, 12 timer (0,5 dag) og 28 minutter (0,02 dag) mellom de to verdiene. Du kan også legge til numeriske verdier til dato- og dato/klokkeslett. Operasjons TODAY() + 3 returnerer for eksempel tre dager etter dagens dato. Se listen over Eksempler på datoformler for å få mer informasjon og eksempler på arbeid med datoer.
Overalt i eksemplene brukes variablene dato og dato/klokkeslett i stedet for de faktiske dato og dato/klokkeslett-feltene eller verdiene.
Husk at komplekse datofunksjoner har en tendens til å bli kompilert til en større størrelse enn tekst- og tallformelfunksjoner, så du kan få problemer med formelkompileringsstørrelsen.
TODAY(), NOW() og TIMENOW()
TODAY()-funksjonen returnerer gjeldende dag, måned og år som en dato-datatype. Denne funksjon er nyttig i formler der du er opptatt av hvor mange dager som er gått siden en tidligere dato, datoen for et bestemt antall dager i fremtiden, eller hvis du bare ønsker å vise aktuell dato.
NOW()-funksjonen returnerer dato/klokkeslett-verdien for det gjeldende øyeblikket. Den er nyttig hvis du er opptatt av bestemte tider på dagen og datoen.
TIMENOW()-funksjonen returnerer en verdi i GMT som representerer det gjeldende klokkeslettet uten datoen. Bruk denne funksjonen i stedet for NOW()-funksjonen hvis du vil ha gjeldende time, minutt, sekunder eller millisekunder. Denne verdien er nyttig for å spore tid som arbeidsskift eller medgått tid.
Hvis du ønsker opplysninger om hvordan du konverterer mellom datoverdier og dato/klokkeslett-verdier, kan du se Konvertere mellom dato/klokkeslett og dato.
DATE()-funksjonen
DATE()-funksjonen returnerer en datoverdi gitt år, måned og dag. Numeriske Y/M/D-verdier og YEAR()-, MONTH()- og DAY()-funksjonene er gyldige parametere for DATE(). DATE( 2013, 6, 1 ) returnerer for eksempel 1. juni 2013. På samme måte returnerer DATE( YEAR( TODAY() ), MONTH( TODAY() ) + 3, 1) datoverdien for den første dagen tre måneder fra i dag i gjeldende år, forutsatt at datoen er gyldig (for eksempel at måneden faller mellom 1 og 12).
Hvis de oppgitte Y/M/D-verdiene resulterer i en ugyldig dato, returnerer DATE()-funksjonen en feil, så feilsøking er en viktig del av arbeidet med datoverdier. Du kan lese om metoder for behandling av ugyldige datoer i Eksempler på datoformler.
Konvertering mellom dato/klokkeslett og dato
Dato og dato/klokkeslett er ikke ombyttbare datotyper, så hvis du vil foreta operasjoner mellom dato- og dato/klokkeslett-verdier, må du konvertere verdiene, slik at begge får samme type. Noen funksjoner (som YEAR(), MONTH() og DAY()) fungerer også bare på datoverdier, så dato/klokkeslett-verdier må konverteres først.
Bruk DATEVALUE( date/time
)-funksjonen til å returnere datoverdien for dato/klokkeslett. Hvis du for eksempel vil hente året fra en dato/klokkeslett-feltet, bruker du YEAR( DATEVALUE(
date/time ) ) ).
Hvis en formel refererer til et Dato/klokkeslett-felt, men returnerer en dato, ignoreres klokkeslettkomponenten uten å konverteres til brukerens tidssone. Denne virkemåten kan føre til en feil dato. Hvis du vil korrigere for brukerens tidssone, bruker du DATEVALUE()-funksjonen til å konvertere Dato/klokkeslett-feltet.
Du kan konvertere en datoverdi til dato/klokkeslett ved bruk av DATETIMEVALUE( date )-funksjonen. Klokkeslettet blir satt til 12.00 GMT (Greenwich Mean Time), og deretter konvertert til tidssonen for brukeren som ser posten, når den vises. For en bruker som befinner seg i San Francisco, returnerer DATETIMEVALUE( TODAY() ) 17:00 den forrige dagen (under sommertid) i stedet for 12:00 den gjeldende dagen. Hvis du vil ha mer informasjon, kan du se Et notat om dato/klokkeslett og tidssoner.
Konvertere mellom dato/klokkeslett og klokkeslett
TIMEVALUE()-funksjonen returnerer en klokkeslettdatatypeverdi i formatet "TT:MM:SS.MS" (timer:minutter:sekunder.millisekunder) ved bruk av en 24-timers klokke. Numeriske H/M/S/MS-verdier og funksjonene HOUR(), MINUTE(), SECONDS() og MILLISECONDS() er gyldige parametere for TIMEVALUE().
Bruk TIMEVALUE(value)-funksjonen til å returnere Klokkeslett-verdien for en dato/klokkeslett-type, tekst, flettefelt eller uttrykk. Trekk for eksempel ut klokkeslettet fra en ClosedDate Date/Time-verdi med TIMEVALUE(ClosedDate).
Konvertere mellom dato og tekst
Hvis du vil inkludere en dato som en del av en streng, pakker du inn datoverdien i TEXT()-funksjonen for å konvertere den til tekst. Hvis du for eksempel vil returnere dagens dato som tekst, skal du bruke:
"Today's date is " & TEXT( TODAY() )Dette returnerer datoen på formatet "ÅÅÅÅ-MM-DD" i stedet for i landets standardformat. Du kan endre formatet ved først å trekke ut dagen, måneden og året fra datoen, og deretter kombinere dem igjen i ønsket format. Eksempel:
"Today's date is " & TEXT( MONTH( date ) ) & "/" & TEXT( DAY( date ) ) & "/" & TEXT( YEAR( date ) ) ) Du kan også konvertere tekst til en dato, slik at du kan bruke strengeverdien sammen med dine andre datofelt og -formler. Hvis du vil at tekst skal formateres som ÅÅÅÅ-MM-DD. Skal du bruke denne formelen for å få returnert datoverdien:
DATEVALUE( "YYYY-MM-DD" )Konvertere mellom dato/klokkeslett og dato
Du kan inkludere dato/klokkeslett-verdier i en streng med TEXT()-funksjonen, men du må være forsiktig med tidssoner. Vurder for eksempel denne formelen:
"The current date and time is " & TEXT( NOW() )I denne formelen er NOW() forskjøvet til GMT. Vanligvis konverteres NOW() til brukerens tidssone når den vises, men fordi den er konvertert til tekst, skjer ikke konverteringen. Så hvis du bruker denne formelen den 1. august kl. 17.00 San Francisco-tid (GMT-7), blir resultatet: Aktuell dato og tid er 2013–08–02 00:00:00Z".
Når du konverterer dato/klokkeslett til tekst, tas Z med på slutten for å indikere GMT. TEXT( date/time ) returnerer Z hvis feltet er tomt. Så hvis dato/klokkeslett-verdien du arbeider med, er tom, må 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/klokkeslett-verdi, bruker du DATETIMEVALUE() som overføres i en streng i formatet ÅÅÅÅ-MM-DD HH:MM:SS. Denne metoden returnerer dato/klokkeslett-verdien i GMT.
Konvertere mellom klokkeslett og tekst
Hvis du vil inkludere klokkeslett som en del av en streng, pakker du klokkeslettverdien i TEXT()-funksjonen for å konvertere den til tekst. Hvis du for eksempel vil returnere det gjeldene klokkeslettet som tekst, bruker du
"The time is " & TEXT( TIMENOW() )Denne funksjonen returnerer klokkeslettet i formatet "TT:MM:SS.MS".
Du kan også konvertere tekst til en klokkeslettdatatype, slik at du kan bruke strengeverdien sammen med dine andre klokkeslettfelt og formler. Formater teksten din som "TT:MM:SS.MS" med et 24-timers format. Bruk TIMEVALUE()-funksjonen:
TIMEVALUE("17:30:45.125")Et notat om dato/klokkeslett og tidssoner
Dato- og dato/klokkeslett-verdier lagres i GMT. Når en post lagres, justeres feltverdier fra brukerens tidssone til GMT, og de justeres deretter tilbake til seerens tidssone når de vises i postopplysningssider og rapporter. For datokonverteringer er ikke dette noe problem fordi konvertering av dato/klokkeslett til dato resulterer i samme datoverdi.
Når du arbeider med dato/klokkeslett-felt og -verdier, utføres konverteringen alltid i GMT, ikke i brukerens tidssone. Hvis du subtraherer et standard dato/klokkeslett-felt fra et annet, blir det ingen problemer fordi begge feltene er i samme tidssone. Når en av verdiene i beregningen er en konvertering fra en tekst- eller datoverdi til en dato/klokkeslett-verdi, får du et annet resultat.
Anta at en bruker i San Francisco taster inn verdien 12:00 den 2. august i et tilpasset dato/klokkeslett-felt kalt Date_Time_c. Denne verdien lagres som 2013-08-02 07:00:00Z fordi tidsforskjellen i sommertid i Stillehavskysten er GMT-7. Kl. 12:00 PDT den 1. august viser brukeren posten, og følgende formel kjøres:
Date_Time_c - NOW()I beregningen er NOW() 2013-08-01 19:00:00Z og trekkes deretter fra 2013-08-02 07:00:00Z for å returnere det forventede resultatet 0,5 (12 timer).
Anta at i stedet for NOW(), konverterer formelen strengen 2013-08-01 12:00:00 til en dato/klokkeslett-verdi:
Date_Time_c - DATETIMEVALUE( "2013-08-01 12:00:00" )I dette tilfellet er DATETIMEVALUE(
“2013–08–01 12:00:00” ) 2013-08-01 12:00:00Z og returnerer resultatet 0.79167, eller 19 timer.
Det finnes ingen måte for å bestemme en brukers tidssone i en formel. Hvis alle brukerne dine er i samme tidssone, kan du justere tidssoneforskjellen ved å legge til eller trekke fra tidsforskjellen mellom brukerens tidssone og GMT, til dine konverterte verdier. Men fordi tidssoner kan påvirkes av sommertid, og fordi start- og sluttdatoer for sommertid er forskjellige hvert år, er dette vanskelig å håndtere i en formel. Du bør bruke Apex til transaksjoner som krever konvertering mellom dato/klokkeslett-verdier og tekst- eller datoverdier.
