Funktsioonid DateAdd, DateDiff ja TimeZoneOffset

Function	Kehtib järgmiste puhul
DateAdd	Lõuendirakendused Dataverse valemiveerud Töölauavood Mudelipõhised rakendused Power Platform CLI
KuupäevDiff	Lõuendirakendused Dataverse valemiveerud Töölauavood Mudelipõhised rakendused Power Platform CLI
TimeZoneOffset	Lõuendirakendused Töölauavood Mudelipõhised rakendused Power Platform CLI

Lisab või leiab erinevuse kuupäeva/aja väärtustes ja teisendab kohaliku aja ja UTC vahel.

Kirjeldus

Funktsioon DateAdd lisab kuupäeva/kellaaja väärtusele ühikute arvu. Tulemuseks on uus kuupäeva/kellaaja väärtus. Negatiivse väärtuse määramisel saate ka lahutada kuupäeva/kellaaja väärtusest ühikute arvu.

Funktsioon DateDiff tagastab kahe kuupäeva/kellaaja väärtuste vahe. Tulemuseks on täisarv ühikuid.

Mõlema funktsiooni puhul võivad ühikud olla TimeUnit.Milliseconds,TimeUnit.Seconds,TimeUnit.Minutes,TimeUnit.Hours,TimeUnit.Days,TimeUnit.Months,TimeUnit.Quarters või TimeUnit.Years. Vaikimisi kasutavad mõlemad funktsioonid ühikutena väärtust TimeUnit.Days .

Funktsioon TimeZoneOffset tagastab kasutaja kohaliku aja ja UTC (koordineeritud maailmaaja) vahelise minutite arvu.

Saate kasutada funktsioone DateAdd koos funktsiooniga TimeZoneOffset, et teisendada kasutaja kohalik aeg UTC-ks (koordineeritud maailmaajaks) ja vastupidi. Funktsiooni TimeZoneOffset lisamine muudab kohaliku aja UTC-ks ja selle lahutamine (negatiivse lisamine) teisendab UTC kohalikuks ajaks.

Lisateavet leiate ka teemadest Kuupäev, kellaaeg ja DateTime ningkuupäevade ja kellaaegadega töötamine.

Süntaks

DateAdd( DateTime, Addition [, Units ] )

• DateTime – nõutav. Kuupäeva/kellaaja väärtus, millega töötada.
• Lisamine – nõutav. Arv Ühikutes, lisamiseks andmetüübile DateTime.
• Ühikud – valikuline. Lisatavate ühikute tüüp: TimeUnit.Milliseconds,TimeUnit.Seconds,TimeUnit.Minutes,TimeUnit.Hours,TimeUnit.Days,TimeUnit.Months,TimeUnit.Quarters või TimeUnit.Years. Kui pole määratud, kasutatakse TimeUnit.Days .

DateDiff( StartDateTime, EndDateTime [, Units ] )

• StartDateTime – nõutav. Alguse kuupäeva ja kellaja väärtus.
• EndDateTime – nõutav. Lõpu kuupäeva ja kellaja väärtus.
• Ühikud – valikuline. Lahutatavate ühikute tüüp: TimeUnit.Milliseconds,TimeUnit.Seconds,TimeUnit.Minutes,TimeUnit.Hours,TimeUnit.Days,TimeUnit.Months,TimeUnit.Quarters või TimeUnit.Years. Kui pole määratud, kasutatakse TimeUnit.Days .

TimeZoneOffset( [ DateTime ] )

• DateTime – valikuline. Kuupäeva/kellaaja väärtus, mille jaoks soovite tagastada erinevuse. Vaikimisi kasutatakse praegust kuupäeva/kellaaega.

Näited

Kõik need näited eeldavad, et praegune kuupäev ja kellaaeg on 15. juuli 2013, 1:02 PM.

Lihtne DateAdd

Valem	Kirjeldus	Tulem
Text( DateAdd( Now(), 3 ), "dd-mm-yyyy hh:mm" )	Liidab praegusele kuupäevale ja kellaajale kolm päeva (vaikimisi ühikud).	"18-07-2013 13:02"
text( DateAdd( Now(), 4, TimeUnit.Hours ), "dd-mm-yyyy hh:mm" )	Saate praegusele kuupäevale ja kellaajale lisada neli tundi.	"15-07-2013 17:02"
text( DateAdd( Today(), 1, TimeUnit.Months ), "dd-mm-yyyy hh:mm" )	Lisab tänasele kuupäevale ühe kuu, ilma ajata Täna ei tagasta ajakomponenti.	"15-08-2013 00:00"
text( DateAdd( Now(), -30, TimeUnit.Minutes ), "dd-mm-yyyy hh:mm" )	Lahutab 30 minutit praegusest kuupäevast ja kellaajast.	"15-07-2013 12:32"

Lihtne DateDiff

Valem	Kirjeldus	Tulem
DateDiff( Now(), DateValue("1/1/2014") )	Annab vastuseks kahe ühiku vaikeühikutes TimeUnit.Days	170
DateDiff( Now(), DateValue("01.01.2014"), TimeUnit.Months )	Annab vastuseks kahe väärtuse ( TimeUnit.Months).	6
DateDiff( Now(), Today(), TimeUnit.Minutes )	Tagastab praeguse kuupäeva/kellaaja ja praeguse kuupäeva (mitte kellaaja) vahe ainult minutites. Kuna Praegu on hilisem kui Täna, on tulemus negatiivne.	-782

Murdarvuliste tulemustega kuupäevade erinevus

Funktsioon DateDiff tagastab ainult täisarvu lahutatud ühikuid ja täpsus on määratud ühikus. Kui soovite erinevust arvutada suurema täpsusega, kasutage väiksemat ühikut ja teisendage tulemus sobivalt, nagu allpool toodud näidetes.

Valem	Kirjeldus	Tulemus
DateDiff( TimeValue("09:45:00"), TimeValue("10:15:36"), TimeUnit.Hours )	Minutit/sekundit eiratakse, erinevus põhineb kellaajal kuni tunnini.	1
DateDiff( TimeValue("09:45:00"), TimeValue("10:15:36"), TimeUnit.Minutes )/60	Minutit kasutatakse erinevuses ja tulemus on jagatud 60-ga, nii et erinevus tundides on erinev.	0.5
DateDiff( TimeValue("09:45:00"), TimeValue("10:15:36"), TimeUnit.Seconds )/3600	Minutit ja sekundit kasutatakse erinevuses ja tulemus on jagatud 3600-ga, nii et erinevus tundides on erinev.	0.51

Teisendamine UTC-ks

Selleks et teisendada UTC-ks (koordineeritud maailmaaeg), lisage TimeZoneOffset antud kellaaja jaoks.

Kujutlege näiteks praegust kuupäeva ja kellaaega 15. juulil 2013, 13:02 Vaikse ookeani suveaeg (PDT, UTC-7). Praeguse kellaaja määramiseks UTC-s tehke järgmist.

• DateAdd( Now(), TimeZoneOffset(), TimeUnit.Minutes )

TimeZoneOffset vaikeväärtused praegusele kellaajale, seega pole teil vaja seda argumenti edastada.

Tulemuse nägemiseks kasutage gunktsiooni Text vorminguga dd-mm-yyyy hh:mm, mis naaseb 15-07-2013 20:02.

Teisendamine UTC-st

UTC-ist teisendamiseks lahutage TimeZoneOffset (lisades negatiivse) antud aja jaoks.

Näiteks kujutlege UTC kuupäev ja kellaaeg 15. juuli 2013, 20:02 on salvestatud muutujas nimega StartTime. Kasutaja ajavööndi kellaaja kohandamiseks tehke järgmist.

• DateAdd( Algusaeg,TimeZoneOffset −( Algusaeg ), TimeUnit.Minutes )

Pange tähele negatiivset märki enne funktsiooni TimeZoneOffset, et lahutada erinevus, mitte liita.

Tulemuse nägemiseks kasutage funktsiooni Text vormingus dd-mm-yyyy hh:mm, mille tulemuseks on 15-07-2013 13:02, kui teil on Vaikse ookeani suveaeg.