महत्वपूर्ण iCalendar RFC 2445 विवरण

Aspose iCalendar ऑब्जेक्ट मॉडल के बारे में

Aspose.Email में Aspose द्वारा प्रदान की गई सभी क्लासेस शामिल हैं iCalendar component RecurrencePattern और RecurrenceRule Aspose की केंद्रीय क्लासेस हैं iCalendar, और संबंधित RFC 2445 तत्वों के ठोस कार्यान्वयन प्रदान कर सकते हैं।

यह RecurrencePattern क्लास पूरे पुनरावृत्ति पैटर्न को दर्शाती है। आप डिफ़ॉल्ट कन्स्ट्रक्टर का उपयोग करके शून्य से नया पुनरावृत्ति पैटर्न बना सकते हैं या मौजूदा पैटर्न को लोड कर सकते हैं CalendarRecurrence. यह RecurrenceRule क्लास पुनरावृत्ति पैटर्न के RRULE या EXRULE भाग को दर्शाती है। RecurrenceRule iCalendar मानक में उनके समकक्षों से सीधे मैप करने वाले कई गुणों को उजागर करता है। उदाहरण के लिए, ByMonth iCalendar में BYMONTH के अनुरूप है और इसी प्रकार। ByMonth आदि के मानों को जाँचकर या सेट करके आप RecurrenceRule गुण जो आप पुनरावृत्ति नियम का विश्लेषण या संशोधित करने के लिए उपयोग कर सकते हैं। अधिक जानकारी और कोड नमूने देखने के लिए देखें RecurrencePattern और RecurrenceRule API संदर्भ में।

महत्वपूर्ण iCalendar RFC 2445 विवरण

इस अनुभाग में निम्नलिखित विषय शामिल हैं:

  • तारीख और समय फ़ॉर्मेट।
  • DATE.
  • स्थानीय समय के साथ DATE‑TIME।
  • UTC समय के साथ DATE‑TIME।
  • स्थानीय समय और टाइम ज़ोन के साथ DATE‑TIME।
  • BYWEEKNO ISO 8601 अनुपालन प्रदान करता है

तारीख और समय फ़ॉर्मेट

तिथियों, या तिथियों के साथ जुड़े समय को पुनरावृत्ति पैटर्न निर्दिष्ट करते समय DTSTART, UNTIL, EXDATE और RDATE तत्वों में उपयोग किया जा सकता है। iCalendar DATE वैल्यू टाइप को परिभाषित करता है जो कैलेंडर तिथि वाले मानों की पहचान करता है और DATE‑TIME टाइप को परिभाषित करता है जो सटीक कैलेंडर तिथि और समय दर्शाते हैं। DATE‑TIME मानों को तीन रूपों में निर्दिष्ट किया जा सकता है, जिनमें:

  • स्थानीय समय।
  • UTC समय।
  • स्थानीय समय और टाइम ज़ोन।

DATE

iCalendar मानक के अनुसार, DATE मानों को yyyyMMdd फ़ॉर्मेट का पालन करना चाहिए। नीचे दिया गया उदाहरण 14 जुलाई 1997 को दर्शाता है: 19970714

स्थानीय समय के साथ DATE‑TIME

स्थानीय समय रूप वाली तिथि बस एक date-time मान है जिसमें UTC डिज़ाइनator शामिल नहीं होता, और यह किसी टाइम ज़ोन का संदर्भ नहीं देता। उदाहरण के लिए, निम्नलिखित 18 जनवरी 1998 को रात 11 बजे दर्शाता है: DTSTART:19980118T230000. इस प्रकार के date-time मानों को "फ्लोटिंग" कहा जाता है और वे किसी विशेष टाइम ज़ोन से बंधे नहीं होते। इन्हें वही घंटे, मिनट और सेकंड मान दर्शाने के लिए उपयोग किया जाता है, चाहे वर्तमान में कौन सा टाइम ज़ोन देखा जा रहा हो।

UTC समय के साथ DATE‑TIME

UTC समय या अभिकल्पित समय वाली तिथि को लैटिन बड़े अक्षर Z उपसर्ग द्वारा पहचाना जाता है, जो UTC डिज़ाइनator है, और समय मान में जोड़ा जाता है। उदाहरण के लिए, निम्नलिखित 19 जनवरी 1998 को 07:00 UTC दर्शाता है: DTSTART:19980119T070000Z कृपया ध्यान दें कि Aspose iCalendar UTC फ़ॉर्मेट Z उपसर्ग को अनदेखा करता है और समय को स्थानीय समय मानता है। RFC2445 मानक कहता है कि पुनरावृत्ति पैटर्न के UNTIL नियम में निर्दिष्ट समय भाग UTC फ़ॉर्मेट में होना चाहिए। यह एक बहुत अजीब बयान है, और वास्तव में मानक में ऐसे उदाहरण हैं जो गलत गणना किए गए हैं। Aspose iCalendar UNTIL नियम में किसी भी प्रारूप में समय को स्वीकार करता है।

स्थानीय समय और टाइम ज़ोन के साथ DATE‑TIME

टाइम ज़ोन को संदर्भित करने के लिए, DATE-TIME को TZID प्रॉपर्टी के साथ संशोधित किया जाता है। उदाहरण के लिए, निम्नलिखित 19 जनवरी 1998 को न्यूयॉर्क में 2 बजे सुबह को दर्शाता है: DTSTART;TZID=US-Eastern:19980119T020000. कृपया ध्यान दें कि Aspose iCalendar वर्तमान में TZID पैरामीटर को नजरअंदाज करता है और समय को स्थानीय समय के रूप में मानता है।

BYWEEKNO ISO 8601 अनुपालन प्रदान करता है

के साथ अनुपालन होने पर ही BYWEEKNO का उपयोग करें ISO 8601 आवश्यक है। ISO 8601 द्वारा परिभाषित सप्ताह संख्या सामान्य अर्थ की सप्ताह संख्याओं से बहुत भिन्न होती है। ISO 8601 के अनुसार, कैलेंडर वर्ष का पहला सप्ताह वह पहला सप्ताह है जिसमें कम से कम चार दिन होते हैं। यह नियम उस एल्गोरिदम को विशेष बनाता है जो ISO 8601 के अनुपालन की आवश्यकता वाले अनुप्रयोगों के लिए है और इसे अन्य उपयोगों के लिए लगभग लागू नहीं रहने देता। ISO 8601 कुछ यूरोपीय बैंकिंग और वित्तीय अनुप्रयोगों द्वारा समर्थित है। यह टेलीविज़न में विज्ञापन बुक करने के लिए भी उपयोग किया जाता है। BYWEEKNO नियम वर्ष के सप्ताहों को पहचानने वाले संख्याओं की कॉमा‑विभाजित सूची निर्दिष्ट करता है। वैध मान 1 से 53 तक हैं। यह ISO 8601 में परिभाषित सप्ताह क्रमांकन के अनुसार सप्ताहों से मेल खाता है। BYWEEKNO केवल YEARLY नियमों के लिए वैध है।

वर्तमान थ्रेड के लिए लोकेल सेट करने का समर्थन Microsoft Outlook संदेश फाइलों का पार्सिंग