DateAdd, DateDiff, और TimeZoneOffset फ़ंक्शंस
इस पर लागू होता है:
कैनवास ऐप्स Dataverse सूत्र कॉलम डेस्कटॉप मॉडल-संचालित ऐप्स Power Platform सीएलआई
दिनांक/समय मान में अंतर जोड़ता है या खोजता है और उसे स्थानीय समय और UTC के बीच रूपांतरित करता है.
वर्णन
DateAdd फ़ंक्शन इकाइयों की संख्या को दिनांक/समय मान में जोड़ता है. परिणाम एक नया दिनांक/समय मान है. आप ऋणात्मक मान निर्दिष्ट करके दिनांक/समय मान से इकाइयों की संख्या घटा सकते हैं.
DateDiff फ़ंक्शन दो दिनांक/समय मानों के बीच का अंतर दिखाता है. परिणाम इकाइयों की एक पूर्णांक संख्या है.
दोनों कार्यों के लिए, इकाइयाँ टाइमयूनिट.मिलीसेकंड, टाइमयूनिट.सेकंड, टाइमयूनिट.मिनट, टाइमयूनिट.घंटे, टाइमयूनिट.दिन , टाइमयूनिट.महीने , टाइमयूनिट.क्वार्टर, या टाइमयूनिट.वर्ष होसकती हैं। डिफ़ॉल्ट रूप से, दोनों फ़ंक्शन इकाइयों के रूप में TimeUnit.Days का उपयोग करते हैं।
TimeZoneOffset फ़ंक्शन उपयोगकर्ता के स्थानीय समय और UTC (समन्वित वैश्विक समय) के बीच मिनटों की संख्या दिखाता है.
आप उपयोगकर्ता के स्थानीय समय और UTC (समन्वित वैश्विक समय) के बीच रूपांतरित करने के लिए TimeZoneOffset के साथ DateAdd का उपयोग कर सकते हैं. TimeZoneOffset को जोड़ना स्थानीय समय को UTC में रूपांतरित करेगा और उसे घटाना (ऋणात्मक जोड़कर) UTC को स्थानीय समय में रूपांतरित करेगा.
अधिक जानकारी के लिए दिनांक, समय, और दिनांक समय डेटा प्रकार और दिनांक और समय के साथ कार्य करना भी देखें .
सिंटैक्स
DateAdd( DateTime, Addition [, Units ] )
- DateTime - आवश्यक. वह दिनांक/समय मान जिस पर संचालन करना है.
- Addition - आवश्यक. DateTime में जोड़ी जाने वाली इकाइयों में संख्या.
- Units - वैकल्पिक. जोड़ने के लिए इकाइयों का प्रकार: TimeUnit.मिलीसेकंड , TimeUnit.सेकंड, TimeUnit.Minutes, TimeUnit.घंटे, TimeUnit.days , TimeUnit.Month , TimeUnit.क्वार्टर, या TimeUnit.वर्ष। यदि निर्दिष्ट नहीं है, तो TimeUnit.Days का उपयोग किया जाता है।
DateDiff( StartDateTime, EndDateTime [, Units ] )
- StartDateTime - आवश्यक. शुरुआती दिनांक/समय मान.
- EndDateTime - आवश्यक. समाप्ति दिनांक/समय मान.
- Units - वैकल्पिक. घटाने के लिए इकाइयों का प्रकार: TimeUnit.मिलीसेकंड , TimeUnit.सेकंड, TimeUnit.मिनट, TimeUnit.घंटे , TimeUnit.दिन, TimeUnit.महीने , TimeUnit.क्वार्टर, या TimeUnit.वर्ष। यदि निर्दिष्ट नहीं है, तो TimeUnit.Days का उपयोग किया जाता है।
TimeZoneOffset( [ DateTime ] )
- DateTime - वैकल्पिक. वह दिनांक समय मान, जिसके लिए ऑफ़सेट वापस करना है. डिफ़ॉल्ट रूप से, वर्तमान दिनांक/समय का उपयोग किया जाता है.
उदाहरण
इन सभी उदाहरणों में, मान लें कि वर्तमान दिनांक और समय 15 जुलाई 2013, 1:02 अपराह्न है.
साधारण DateAdd
| सूत्र | वर्णन | परिणाम |
|---|---|---|
| Text( DateAdd( Now(), 3 ), "dd-mm-yyyy hh:mm" ) |
वर्तमान दिनांक और समय में तीन दिन (डिफ़ॉल्ट इकाइयाँ) जोड़ता है. | "18-07-2013 13:02" |
| पाठ (DateAdd (now(), 4, TimeUnit.Hours), "dd-mm-yyyy hh:mm" ) |
वर्तमान दिनांक और समय में चार घंटे जोड़ें. | "15-07-2013 17:02" |
| पाठ (DateAdd(Today(), 1, TimeUnit.Months), "dd-mm-yyyy hh:mm" ) |
वर्तमान दिनांक में एक महीना जोड़ता है, बिना समय के आज समय घटक नहीं दिखाता है. | "15-08-2013 00:00" |
| पाठ (DateAdd (अब(), -30, TimeUnit.minutes ), "dd-mm-yyyy hh:mm" ) |
वर्तमान दिनांक और समय से 30 मिनट घटाता है. | "15-07-2013 12:32" |
साधारण DateDiff
| सूत्र | वर्णन | परिणाम |
|---|---|---|
| DateDiff( Now(), DateValue("1/1/2014") ) | TimeUnit.Days की डिफ़ॉल्ट इकाइयों में दो इकाइयों के बीच के अंतर को लौटाता है | 170 |
| DateDiff (Now(), DateValue ("1/1/2014"), TimeUnit.Months) | TimeUnit.Months में दो मानों के बीच अंतर देता है | 6 |
| DateDiff (Now(), Today(), TimeUnit.Minutes ) | वर्तमान दिनांक/समय और वर्तमान दिनांक के बीच का अंतर केवल मिनटों में (कोई समय नहीं) दिखाता है. चूंकि NowToday के बाद है, इसलिए परिणाम ऋणात्मक होगा. | -782 |
भिन्नात्मक परिणामों के साथ दिनांकों का अंतर
फ़ंक्शन DateDiff घटाई जा रही इकाइयों की केवल एक पूर्णांक संख्या देता है और परिशुद्धता निर्दिष्ट इकाई में दी जाती है. उच्च परिशुद्धता वाले अंतर की गणना करने के लिए, एक छोटी इकाई का उपयोग करें और परिणाम को उचित रूप से रूपांतरित करें, जैसे नीचे दिए गए उदाहरणों में दिखाया गया है.
| सूत्र | विवरण | परिणाम |
|---|---|---|
| DateDiff (TimeValue("09:45:00"), TimeValue ("10:15:36"), TimeUnit.Hours) | मिनट/सेकंड को नजरअंदाज किया जाता है, अंतर घंटे तक के समय पर आधारित होता है. | 1 |
| DateDiff ("TimeValue("09:45:00"), TimeValue ("10:15:36"), TimeUnit.Minutes)/60 | मिनटों का अंतर में उपयोग किया जाता है और घंटों में अंतर लाने के लिए परिणाम को 60 से विभाजित किया जाता है. | 0.5 |
| DateDiff ( TimeValue ("09:45:00"), TimeValue ("10:15:36"), TimeUnit.Seconds)/3600 | मिनटों और सेकंड का अंतर में उपयोग किया जाता है; घंटों में अंतर लाने के लिए परिणाम को 3600 से विभाजित किया जाता है. | 0.51 |
UTC में रूपांतरित करना
UTC (समन्वित वैश्विक समय) में रूपांतरित करने के लिए, दिए गए समय हेतु TimeZoneOffset जोड़ें.
उदाहरण के लिए, कल्पना करें कि वर्तमान दिनांक और समय प्रशांत डेलाइट समय (PDT, UTC-7) में 15 जुलाई 2013, 1:02 अपराह्न है. UTC में वर्तमान समय निर्धारित करने के लिए, निम्न का उपयोग करें:
- DateAdd (Now(), TimeZoneOffset(), TimeUnit.Minutes )
TimeZoneOffset डिफ़ॉल्ट रूप से वर्तमान समय है, इसलिए आपको इस पर तर्क पास करने की आवश्यकता नहीं होती.
परिणाम देखने के लिए, dd-mm-yyyy hh:mm के साथ Text फ़ंक्शन का उपयोग करें, जो 15-07-2013 20:02 देगा.
UTC से रूपांतरित करना
UTC से रूपांतरित करने के लिए, दिए गए समय के लिए TimeZoneOffset घटाएँ (ऋणात्मक जोड़कर).
उदाहरण के लिए, कल्पना करें कि UTC दिनांक और समय 15 जुलाई 2013, 8:02 अपराह्नStartTime नामक चर में संग्रहित है. उपयोगकर्ता के समय क्षेत्र के लिए समय समायोजित करने हेतु, निम्न का उपयोग करें:
- DateAdd (StartTime, −TimeZoneOffset(StartTime), TimeUnit.Minutes )
ऑफ़सेट को जोड़ने के बजाय घटाने के लिए, TimeZoneOffset से पहले ऋणात्मक चिह्न पर ध्यान दें.
परिणाम देखने के लिए, dd-mm-yyyy hh:mm के साथ Text फ़ंक्शन का उपयोग करें, जिसका परिणाम 15-07-2013 13:02 होगा, बशर्ते आप प्रशांत डेलाइट समय में हों.