DateAdd, DateDiff eta TimeZoneOffset funtzioak
Function | Honi dagokio |
---|---|
DataGehitu | Mihise-aplikazioak Dataverse formula-zutabeak Mahaigaineko fluxuak Ereduetan oinarritutako aplikazioak Power Platform CLI |
DataDif | Mihise-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
DataGehitu( DateTime, Gehiketa [, Unitateak ])
- DateTime - Beharrezkoa. Data funtzionatzeko data / ordua.
- Gehigarria - Beharrezkoa. Zenbakia Unitateak, gehitzeko DateTime.
- Unitateak - Aukerakoa. Gehitu beharreko Unitate mota: TimeUnit.Milliseconds, TimeUnit.Seconds, Denbora.Minutuak, Ordu.Unitatea, 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.Millisegundo, 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 - 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.
Data sinplea Gehitu
Formula | Deskribapenak | Emaitza |
---|---|---|
Testua(DataGehitu(Orain(), 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 |
---|---|---|
DataDiff(Orain(), DateValue("1/1/2014")) | 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 uneko ordua da lehenetsia, beraz, ez diozu argumenturik eman 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.