DateAdd, DateDiffja TimeZoneOffset funktsioonid

Funktsioone	Kehtib järgmiste puhul
DateAdd DateDiff	Lõuendirakendused Copilot Studio töölauavood Dataverse formula columns Mudelipõhised rakendused Power Platform CLI Dataverse functions Power Pages
TimeZoneOffset	Lõuendirakendused Copilot Studio töölauavood Mudelipõhised rakendused Power Platform CLI Dataverse funktsioonid Power Pages

Function	Kehtib järgmiste puhul
DateAdd
DateDiff
TimeZoneOffset

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

Kirjeldus

Funktsioon DateAdd liidab kuupäeva-/kellaajaväärtusele arvu ühikuid. 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-/kellaajaväärtuse. 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 minutid kasutaja kohaliku kellaaja ja UTC (koordineeritud maailmaaeg) vahel.

Selle abil DateAddTimeZoneOffset saate teisendada kasutaja kohaliku aja ja UTC (koordineeritud maailmaaeg) vahel. Liitmisel TimeZoneOffset teisendatakse kohalik aeg UTC-ks ja selle lahutamine (negatiivse lisamine) teisendatakse UTC-st 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-aaaa 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-aaaa hh:mm" )	Saate praegusele kuupäevale ja kellaajale lisada neli tundi.	"15-07-2013 17:02"
Text( DateAdd( Today(), 1, TimeUnit.Months ), "dd-mm-aaaa 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-aaaa hh:mm" )	Lahutab 30 minutit praegusest kuupäevast ja kellaajast.	"15-07-2013 12:32"

Lihtne DateDiff

Valem	Kirjeldus	Tulem
DateDiff( Now(), DateValue("1.01.2014") )	Annab vastuseks kahe ühiku vaikeühikutes TimeUnit.Days	170
DateDiff( Now(), DateValue("1.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 lahutatavate ühikute täisarvu 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	Tulem
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

UTC-ks teisendamiseks (koordineeritud maailmaaeg) lisage TimeZoneOffset vastav aeg.

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 vaikimisi praegusele ajale, nii et te ei pea seda argumenti edastama.

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

Teisendamine UTC-st

UTC-st teisendamiseks lahutage TimeZoneOffset (lisades negatiivse) antud aja kohta.

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( StartTime, −TimeZoneOffset( StartTime ), TimeUnit.minutes )

Nihke lahutamiseks pöörake enne TimeZoneOffset negatiivset märki, mitte liitke seda.

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.