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