DateAdd, DateDiff eta TimeZoneOffset funtzioak

Function	Honi dagokio
DataGehitu	Oihal-aplikazioak Dataverse formula-zutabeak Mahaigaineko fluxuak Ereduetan oinarritutako aplikazioak Power Platform CLI
DataDif	Oihal-aplikazioak Dataverse formula-zutabeak Mahaigaineko fluxuak Ereduetan oinarritutako aplikazioak Power Platform CLI
TimeZoneOffset	Canvas aplikazioak Mahaigaineko fluxuak Modeloetan oinarritutako aplikazioak Power Platform CLI

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

Deskribapenak

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

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

Bi funtzioetarako, unitateak TimeUnit.Milliseconds, TimeUnit.Seconds, izan daitezke. TimeUnit.Minutes, TimeUnit.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters, edo TimeUnit.Years. Lehenespenez, bi funtzioek TimeUnit.Days unitate gisa erabiltzen dute.

Timezoneoffset funtzioak erabiltzailearen tokiko orduaren eta UTCren (ordu unibertsal koordinatua) arteko minutu kopurua itzultzen du.

Erabil dezakezu DateAdd nirekin Timezoneoffset erabiltzailearen tokiko ordua eta UTC (Denbora Unibertsala Koordinatua) bihurtzeko. Gehitzen Timezoneoffset tokiko ordua UTC bihurtuko du eta kenketak eginez (ezezkoa gehituta) UTC ordutik tokira itzuliko da.

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

Sintaxia

DateAdd( DateTime, Gehiketa [, Unitateak ] )

• DateTime - Beharrezkoa. Data funtzionatzeko data / ordua.
• Batuketa - Beharrezkoa. Zenbakia Unitateak, gehitzeko DateTime.
• Unitateak - Aukerakoa. Gehitu beharreko Unitate mota: TimeUnit.Milliseconds, TimeUnit.Seconds, TimeUnit.Minutes, TimeUnit.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. Kendu beharreko Unitate mota: TimeUnit.Milliseconds, TimeUnit.Seconds, TimeUnit.Minutes, TimeUnit.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters, edo DenboraUnitatea.Urteak. Zehazten ez bada, TimeUnit.Days erabiltzen dira.

TimeZoneOffset( [ DateTime ] )

• DateTime - Hautazkoa. 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.

Data sinplea Gehitu

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"
Testua(DataGehitu(Orain(), 4, DenboraUnitatea.Orduak), "dd-mm-yyyy hh:mm" )	Gehitu lau ordu uneko data eta ordura.	"2013-07-15 17:02"
Testua(DataGehitu(Gaur(), 1, DenboraUnitatea.Hilabeteak), "dd-mm-yyyy hh:mm" )	Hilabete bat gehitzen du uneko datara, denborarik gabe gaur ez du denbora osagairik itzultzen.	"2013-08-15 00:00"
Testua(DataGehitu(Orain(), -30, DenboraUnitatea.Minutu), "dd-mm-yyyy hh:mm" )	Uneko ordutik eta minutuetatik 30 minutu kenduta.	"2013-07-15 12:32"

DateDiff sinplea

Formula	Deskribapenak	Emaitza
DateDiff( Orain(), DateValue("2014/01/01") )	Bi unitateen arteko aldea ematen du TimeUnit.Days unitate lehenetsietan	170
DataDiff(Orain(), DateValue("1/1/2014"), TimeUnit.Months )	Bi balioen arteko aldea ematen du TimeUnit.Months	6
DataDiff(Orain(), Gaur(), 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

DateDiff funtzioak kentzen ari 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
DataDiff(DenboraBalioa("09:45:00"), DenboraBalioa("10:15:36"), DenboraUnitatea.Orduak)	Minutu / segundoei ez zaie jaramonik egiten, aldea ordurako denboran oinarritzen da.	1
DataDiff(DenboraBalioa("09:45:00"), DenboraBalioa("10:15:36"), DenboraUnitatea.Minutu)/60	Minutuak aldean erabiltzen dira, eta emaitza 60rekin zatitzen da orduetan aldea izateko.	0.5
DataDiff(DenboraBalioa("09:45:00"), DenboraBalioa("10:15:36"), DenboraUnitatea.Segundoak)/3600	Minutuak eta segundoak aldean erabiltzen dira, eta emaitza 3600-rekin zatitzen da orduetan aldea izateko.	0.51

UTC bihurtzea

UTC (Ordutegi Unibertsala Koordinatua) bihurtzeko, gehitu Timezoneoffset emandako denboragatik.

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

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

Timezoneoffset lehenetsitako uneoro, beraz, ez duzu argumentu bat 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 (ezezkoa 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:

• DataGehitu(Hasierakoordua, −TimeZoneOffset(Hasierakoordua), TimeUnit.Minutes)

Kontuan izan aurretik zeinu negatiboa Timezoneoffset kenketa kendu eta gehitu beharrean.

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