DateAdd, DateDiffeta TimeZoneOffset funtzioak

Funtzioak	Honi dagokio
DateAdd DateDiff	Mihise-aplikazioak Copilot Studio Mahaigaineko fluxuak Dataverse formula zutabeak Model-driven apps Power Platform CLI Dataverse funtzioak Power Pages
TimeZoneOffset	Mihise-aplikazioak Copilot Studio Mahaigaineko fluxuak Ereduetan oinarritutako aplikazioak Power Platform CLI Dataverse funtzioak Power Pages

Function	Honi dagokio
DateAdd
DateDiff
TimeZoneOffset

Data / orduko balioen aldea gehitu edo aurkitzen du eta tokiko orduaren eta UTCren arteko bihurtzen da.

Deskribapenak

Funtzioak DateAdd unitate kopuru bat gehitzen dio data/ordu balio bati. Emaitza data / orduaren balio berria da. Data / ordu balio batetik unitate kopuru bat ere kendu dezakezu, balio negatiboa zehaztuz.

Funtzioak DateDiff data/ordu bi balioen arteko aldea itzultzen du. Emaitza unitate kopuru oso bat da.

Bi funtzioetarako, unitateek egin dezakete be TimeUnit.Milliseconds, TimeUnit.Seconds, TimeUnit.Minutes, Ti meUnit.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters, edo DenboraUnitatea.Urteak. Lehenespenez, bi funtzioek TimeUnit.Days unitate gisa erabiltzen dute.

Funtzioak TimeZoneOffset erabiltzailearen ordu lokalaren eta UTC (Coordinated Universal Time) arteko minutu kopurua itzultzen du.

Erabiltzailearen ordu lokalaren eta UTC (Coordinated Universal Time) artean bihurtzeko erabil DateAddTimeZoneOffset dezakezu. Gehitzeak TimeZoneOffset ordu lokal bat UTC bihurtuko du, eta kenduz (negatiboa gehituz) UTCtik ordu lokalera bihurtuko da.

Ikusi ere Data, Ordua eta DateTime datu motak eta data eta orduekin lan egitea informazio gehiagorako.

Sintaxia

DateAdd( DateTime, Addition [, Units ] )

• DateTime - Beharrezkoa. Data funtzionatzeko data / ordua.
• Gehigarria - Beharrezkoa. Zenbakia Unitateak, gehitzeko DateTime.
• Unitateak - Aukerakoa. Unitateak mota gehitu: TimeUnit.Milliseconds, TimeUnit.Seconds, TimeUnit.Minutes, T imeUnit.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters, edo DenboraUnitatea.Urteak. Zehazten ez bada, TimeUnit.Days erabiltzen dira.

DateDiff( StartDateTime, EndDateTime [, Unitateak ] )

• StartDateTime - Beharrezkoa. Data/orduaren balioa hasteko.
• EndDateTime - Beharrezkoa. Data/orduaren balioa amaitzeko.
• Unitateak - Aukerakoa. Unitateak mota kendu: DenboraUnitatea.Milisegundoak, DenboraUnitatea.Segunduak, DenboraUnitatea.Minutuak, TimeUn it.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters, edo DenboraUnitatea.Urteak. Zehazten ez bada, TimeUnit.Days erabiltzen dira.

TimeZoneOffset( [ DateTime ] )

• DateTime - Aukerakoa. Offset-a itzultzeko data / ordua. Berez, uneko data / ordua erabiltzen da.

Adibideak

Adibide hauetan guztietan, demagun oraingo data eta ordua direla 2013ko uztailaren 15a, 13:02.

Sinplea DateAdd

Formula	Deskribapenak	Emaitza
Text( DateAdd( Now(), 3 ), "dd-mm-yyyy hh:mm" )	Hiru egun (unitate lehenetsiak) uneko data eta ordura gehitzen ditu.	"18-07-2013 13:02"
Text( DateAdd( Now(), 4, TimeUnit.Hours ), "dd-mm-yyyy hh:mm" )	Gehitu lau ordu uneko data eta ordura.	"2013-07-15 17:02"
Text( DateAdd( Today(), 1, TimeUnit.Months ), "dd-mm-yyyy hh:mm" )	Hilabete bat gehitzen du uneko datara, denborarik gabe gaur ez du denbora osagairik itzultzen.	"2013-08-15 00:00"
Text( DateAdd( Now(), -30, TimeUnit.Minutes ), "dd-mm-yyyy hh:mm" )	Uneko ordutik eta minutuetatik 30 minutu kenduta.	"2013-07-15 12:32"

Sinplea DateDiff

Formula	Deskribapenak	Emaitza
DateDiff( Now(), DateValue("2014/01/01") )	Bi unitateen arteko aldea ematen du TimeUnit.Days unitate lehenetsietan	170
DateDiff( Now(), DateValue("1/1/2014"), TimeUnit.Months )	Bi balioen arteko aldea ematen du TimeUnit.Months	6
DateDiff( Now(), Today(), TimeUnit.Minutes )	Uneko data / orduaren eta uneko dataren aldea itzultzen du minututan (ordurik gabe) minututan. Geroztik orain baino beranduago dago gaur emaitza negatiboa izango da.	-782

Daten aldea zatikako emaitzekin

Funtzioak DateDiff kentzen diren unitateen kopuru osoa bakarrik itzultzen du, eta zehaztasuna zehaztutako unitatean ematen da. Aldea zehaztasun handiagoarekin kalkulatzeko, erabili unitate txikiagoa eta bihurtu emaitza modu egokian, beheko adibideetan bezala.

Formula	Deskribapenak	Emaitza
DateDiff( TimeValue("09:45:00"), TimeValue("10:15:36"), TimeUnit.Hours )	Minutu / segundoei ez zaie jaramonik egiten, aldea ordurako denboran oinarritzen da.	1
DateDiff( TimeValue("09:45:00"), TimeValue("10:15:36"), TimeUnit.Minutes )/60	Minutuak aldean erabiltzen dira, eta emaitza 60rekin zatitzen da orduetan aldea izateko.	0.5
DateDiff( TimeValue("09:45:00"), TimeValue("10:15:36"), TimeUnit.Seconds )/3600	Minutuak eta segundoak aldean erabiltzen dira, eta emaitza 3600-rekin zatitzen da orduetan aldea izateko.	0.51

UTC bihurtzea

UTC (Denbora Unibertsal Koordinatua) bihurtzeko, gehitu emandako TimeZoneOffset ordua.

Adibidez, imajinatu uneko data eta ordua 2013ko uztailaren 15a, 1:02 PM Pazifikoko eguneko ordutegian (PDT, UTC-7). UTC uneko ordua zehazteko, erabili:

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

TimeZoneOffset lehenespenez, uneko ordua da, beraz, ez duzu argumenturik pasatu beharrik.

Emaitza ikusteko, erabili Text funtzioa formatuarekin dd-mm-yyyy hh:mm, itzuliko dena 2013-07-15 20:02.

UTC-tik bihurtzea

UTC-tik bihurtzeko, kendu TimeZoneOffset (negatiboa gehituz) emandako denborarako.

Adibidez, imajinatu UTCren data eta ordua 2013ko uztailaren 15a, 20:02 izeneko aldagai batean gordetzen da Hasiera-ordua. Erabiltzailearen denbora-eremua egokitzeko, erabili:

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

Kontuan hartu zeinu negatiboa aurretik TimeZoneOffset desplazamendua kentzeko, gehitu beharrean.

Emaitza ikusteko, erabili Text funtzioa formatuarekin dd-mm-yyyy hh:mm, horren ondorioz 2013-07-15 13:02 Pazifikoko Egunaren ordua bazara.