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 डेटा प्रकार और दिनांकों और समय के साथ कार्य करना भी देखें।

सिंटैक्स

DateAdd( DateTime, Addition [, Units ] )

• DateTime - आवश्यक. वह दिनांक/समय मान जिस पर संचालन करना है.
• Addition - आवश्यक. DateTime में जोड़ी जाने वाली इकाइयों में संख्या.
• Units - वैकल्पिक. जोड़ने के लिए इकाइयों का प्रकार: समय इकाई.मिलीसेकंड, समय इकाई.सेकंड, समय इकाई.मिनट, समय इकाई.घंटे, समय इकाई.दिन, समय इकाई.महीने, समय इकाई.तिमाही, या समय इकाई.वर्ष. यदि निर्दिष्ट नहीं किया गया है, तो TimeUnit.Days का उपयोग किया जाता है।

DateDiff( StartDateTime, EndDateTime [, Units ] )

• StartDateTime - आवश्यक. शुरुआती दिनांक/समय मान.
• EndDateTime - आवश्यक. समाप्ति दिनांक/समय मान.
• Units - वैकल्पिक. घटाने के लिए इकाइयों का प्रकार: समय इकाई.मिलीसेकंड, समय इकाई.सेकंड, समय इकाई.मिनट, समय इकाई.घंटे, समय इकाई.दिन, समय इकाई.महीने, समय इकाई.तिमाही, या समय इकाई.वर्ष. यदि निर्दिष्ट नहीं किया गया है, तो 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( अब(), 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( Now(), DateValue("1/1/2014") )	TimeUnit.Days की डिफ़ॉल्ट इकाइयों में दो इकाइयों के बीच का अंतर लौटाता है	170
DateDiff( अब(), DateValue("1/1/2014"), TimeUnit.Months )	TimeUnit.Months में दो मानों के बीच का अंतर लौटाता है	6
DateDiff( अभी(), आज(), TimeUnit.मिनट )	वर्तमान दिनांक/समय और वर्तमान दिनांक के बीच का अंतर केवल मिनटों में (कोई समय नहीं) दिखाता है. चूंकि NowToday के बाद है, इसलिए परिणाम ऋणात्मक होगा.	-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.Minutes )

ऑफ़सेट को जोड़ने के बजाय घटाने के लिए, TimeZoneOffset से पहले ऋणात्मक चिह्न पर ध्यान दें.

परिणाम देखने के लिए, dd-mm-yyyy hh:mm के साथ Text फ़ंक्शन का उपयोग करें, जिसका परिणाम 15-07-2013 13:02 होगा, बशर्ते आप प्रशांत डेलाइट समय में हों.