DateAdd, DateDiffin funkcije TimeZoneOffset

Funkcije	Velja za
DateAdd DateDiff	Canvas apps Copilot Studio Desktop flows Dataverse formula columns Model-driven apps Power Platform CLI Dataverse functions Power Pages
TimeZoneOffset	Canvas apps Copilot Studio Desktop flows Model-driven apps Power Platform CLI Dataverse functions Power Pages

Function	Velja za
DateAdd
DateDiff
TimeZoneOffset

Doda vrednost k vrednosti datuma/časa ali ugotovi razliko v vrednostih datuma/časa ter pretvarja med lokalnim časom in UTC.

Opis

Funkcija DateAdd doda število enot vrednosti datuma/ure. Rezultat je nova vrednost datuma/časa. Lahko tudi odštejete število enot od vrednosti datuma/časa, tako da navedete negativno vrednost.

Funkcija DateDiff vrne razliko med dvema vrednostima datuma/ure. Rezultat je celo število enot.

Za obe funkciji lahko enote be TimeUnit.Milliseconds, TimeUnit.Seconds, TimeUnit.Minutes, Ti meUnit.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters, ali TimeUnit.Years. Privzeto obe funkciji kot enoto uporabljata TimeUnit.Days .

Funkcija TimeZoneOffset vrne število minut med lokalnim časom uporabnika in UTC (Coordinated Universal Time).

Uporabite ga lahko DateAdd za pretvorbo TimeZoneOffset med lokalnim časom uporabnika in UTC (Coordinated Universal Time). Dodajanje TimeZoneOffset bo pretvoril lokalni čas v UTC in odštevanje (dodajanje negativne) bo pretvoril iz UTC v lokalni čas.

Glejte tudi Podatkovne vrste Datum, Čas in DatumČas in Delo z datumi in časi za več informacij.

Sintaksa

DateAdd( DateTime, Seštevek [, Enote ] )

• Datum in čas - Zahtevano. Vrednost datuma/časa za operiranje.
• Dodatek - Obvezen. Število v možnosti Enote, ki se prišteje k DateTime.
• Enote - neobvezno. Vrsta enot do dodaj: TimeUnit.Milliseconds, TimeUnit.Seconds, TimeUnit.Minutes, T imeUnit.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters, ali TimeUnit.Years. Če ni navedeno, se uporabi TimeUnit.Days .

DateDiff( StartDateTime, EndDateTime [, Enote ] )

• StartDateTime - Zahtevano. Začetna vrednost datuma/časa.
• EndDateTime - Zahtevano. Končna vrednost datuma/časa.
• Enote - neobvezno. Vrsta enot do odštej: TimeUnit.Milliseconds, TimeUnit.Seconds, TimeUnit.Minutes, TimeUn it.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters, ali TimeUnit.Years. Če ni navedeno, se uporabi TimeUnit.Days .

TimeZoneOffset( [ Datum in ura ] )

• Datum in čas - Izbirno. Vrednost datuma/časa za katero se vrne odmik. Privzeto je uporabljen trenutni datum/čas.

Primeri

V vseh teh primerih domnevamo, da sta trenutni datum in čas 15. julij 2013, 13:02.

Preprost DateAdd

Formula	Opis	Rezultat
Besedilo( DateAdd( Now(), 3 ), "dd-mm-yyyy hh:mm" )	Prišteje tri dni (privzete enote) trenutnemu datumu in času.	"18-07-2013 13:02"
Text( DateAdd( Now(), 4, Timeunit.Hours ), "dd-mm-yyyy hh:mm" )	Prišteje štiri ure trenutnemu datumu in času.	"15-07-2013 17:02"
Text( DateAdd( Today(), 1, TimeUnit.Months ), "dd-mm-yyyy hh:mm" )	Prišteje en mesec trenutnemu datumu, brez časa, kot je Today, ne vrne komponente časa.	"15-08-2013 00:00"
Text( DateAdd( Now(), -30, Timeunit.Minutes ), "dd-mm-yyyy hh:mm" )	Odšteje 30 minut od trenutnega datuma in časa.	"15-07-2013 12:32"

Preprost DateDiff

Formula	Opis	Rezultat
DateDiff( Now(), DateValue("1/1/2014") )	Vrne razliko med obema enotama v privzetih enotah TimeUnit.Days	170
DateDiff( Now(), DateValue("1/1/2014"), TimeUnit.Months )	Vrne razliko med obema vrednostma v TimeUnit.Months	6
DateDiff( Now(), Today(), Timeunit.Minutes )	Vrne vrednost med trenutnim datumom/časom in trenutnim datumom (brez časa) v minutah. Ker je Now pozneje kot Today, bo rezultat negativen.	–782

Razlika datumov z rezultati po delih

Funkcija vrne DateDiff le celo število enot, ki jih odštevate, natančnost pa je podana v navedeni enoti. Za izračun razlike z večjo natančnostjo uporabite manjšo enoto in primerno pretvorite rezultat, kot v spodnjih primerih.

Formula	Opis	Rezultat
DateDiff( TimeValue("09:45:00"), TimeValue("10:15:36"), TimeUnit.Hours )	Minute/sekunde se prezrejo, razlika temelji na času do ure.	1
DateDiff( TimeValue("09:45:00"), TimeValue("10:15:36"), TimeUnit.Minutes )/60	Minute se uporabijo v razliki, rezultat pa se deli s 60, da se dobi razlika v urah.	0.5
DateDiff( TimeValue("09:45:00"), TimeValue("10:15:36"), TimeUnit.Seconds )/3600	Minute in sekunde se uporabijo v razliki, rezultat pa se deli s 3600, da se dobi razlika v urah.	0.51

Pretvorba v UTC

Če želite pretvoriti v UTC (Coordinated Universal Time), dodajte TimeZoneOffset za dani čas.

Na primer, predstavljajmo si, da sta trenutni datum in čas 15. julij 2013, 13:02 v pacifiškem poletnem času (PDT, UTC-7). Za določitev trenutnega časa v UTC uporabite:

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

TimeZoneOffset privzeto na trenutni čas, tako da vam ga ni treba podati argumentu.

Če želite videti rezultat, uporabite funkcijo Text z obliko zapisa dd-mm-yyyy hh:mm, ki vrne 15-07-2013 20:02.

Pretvorba iz UTC

Če želite pretvoriti iz UTC,odštejte TimeZoneOffset (tako, da dodate negativno vrednost) za dani čas.

Na primer, predstavljajte si, da sta datum in čas UTC 15. julij 2013, 8:02 shranjena v spremenljivki, imenovani StartTime. Da prilagodite čas za uporabnikov časovni pas, uporabite:

• DateAdd( Čas začetka, −TimeZoneOffset( StartTime ), TimeUnit.Minutes )

Preden odmik odštejete TimeZoneOffset , ne pozabite na negativni predznaek.

Če želite videti rezultat, uporabite funkcijo Text z obliko zapisa dd-mm-yyyy hh:mm, da nastane 15-07-2013 13:02, če ste v pacifiškem poletnem času.