तारीख और समय फ़ील्ड

तारीख और समय फ़ील्ड

यह मार्गदर्शिका दिखाती है कि Aspose.Words FOSS for .NET में कैलेंडर-समझदार तिथि और समय फ़ील्ड क्लासों के साथ कैसे काम किया जाए — FieldDate, FieldCreateDate, FieldPrintDate, और FieldSaveDate — जो Word के DATE, CREATEDATE, PRINTDATE, और SAVEDATE फ़ील्ड क्रमशः। प्रत्येक क्लास व्युत्पन्न होती है Field और लागू करती है IFieldWithCalendar; आधार के लिए Field object model स्वयं (अपडेटिंग, अनलिंकिंग, हटाना, और किसी भी फ़ील्ड को फ़ॉर्मेट करना), देखें फ़ील्ड्स के साथ काम करना गाइड।

चार तारीख और समय फ़ील्ड क्लासेज़

FieldDate DATE फ़ील्ड को लागू करता है। FieldCreateDate CREATEDATE को लागू करता है, वह तारीख जब दस्तावेज़ बनाया गया था। FieldPrintDate PRINTDATE को लागू करता है, वह तारीख जब दस्तावेज़ अंतिम बार प्रिंट किया गया था। FieldSaveDate SAVEDATE को लागू करता है, वह तारीख जब दस्तावेज़ अंतिम बार सहेजा गया था। चारों Field की उपक्लासेज़ हैं और IFieldCodeTokenInfoProvider और IFieldWithCalendar को लागू करती हैं, इसलिए वे Field के GetFieldCode(), Update(), Unlink(), Remove(), और फॉर्मेटिंग (Format) सदस्यों को अपने नीचे वर्णित कैलेंडर स्विच के साथ साझा करती हैं।

ग़ैर-ग्रेगोरियन कैलेंडर का चयन करना

चारों क्लासों में से प्रत्येक UseLunarCalendar (bool) को उजागर करती है ताकि परिणाम को हिजरी लूनर या हिब्रू लूनर कैलेंडर का उपयोग करके रेंडर किया जा सके, UseSakaEraCalendar (bool) सका युग कैलेंडर के लिए, और UseUmAlQuraCalendar (bool) उम-अल-क़ुरा कैलेंडर के लिए। संबंधित प्रॉपर्टी को true पर सेट करें, फिर Update() को कॉल करने से पहले, ताकि फ़ील्ड अपने परिणाम को डिफॉल्ट ग्रेगोरियन कैलेंडर के बजाय उस कैलेंडर सिस्टम का उपयोग करके पुनः गणना करे।

FieldDate का Application-Format Switch

FieldDate अतिरिक्त रूप से UseLastFormat (bool) को उजागर करता है, जो नियंत्रित करता है कि जब एक नया DATE फ़ील्ड डाला जाता है तो फ़ील्ड होस्टिंग एप्लिकेशन द्वारा अंतिम बार उपयोग किए गए फ़ॉर्मेट का उपयोग करे या नहीं। FieldCreateDate, FieldPrintDate, और FieldSaveDate इस प्रॉपर्टी को उजागर नहीं करते हैं।

टिप्स और सर्वोत्तम प्रथाएँ

• कैलेंडर स्विच (UseLunarCalendar, UseSakaEraCalendar, या UseUmAlQuraCalendar) सेट करें और फिर फ़ील्ड पर Update() कॉल करें — केवल प्रॉपर्टी बदलने से Result का पुनर्गणना नहीं होता।
• किसी दिए गए फ़ील्ड इंस्टेंस पर केवल एक कैलेंडर स्विच को true पर सेट करें; एक से अधिक को मिलाने से अस्पष्ट परिणाम मिलता है।
• उपयोग करें Field.Format (एक FieldFormat, कवर किया गया है फ़ील्ड परिणाम फ़ॉर्मेटिंग गाइड) इन कैलेंडर स्विचों के साथ-साथ परिणाम पर लागू संख्यात्मक या तिथि/समय फ़ॉर्मेटिंग चित्र को भी नियंत्रित करने के लिए।
• उस क्लास को चुनें जो आपके आवश्यक सेमांटिक से मेल खाती हो — FieldSaveDate और FieldPrintDate दस्तावेज़ में रिकॉर्ड किए गए टाइमस्टैम्प पढ़ते हैं, जबकि FieldDate वह तिथि दर्शाता है जब फ़ील्ड अपडेट किया जाता है।

सामान्य समस्याएँ

FAQ

FieldDate और FieldCreateDate के बीच क्या अंतर है?

FieldDate DATE फ़ील्ड को लागू करता है (हर अपडेट पर वर्तमान तिथि में पुनर्गणना करता है); FieldCreateDate CREATEDATE को लागू करता है (दस्तावेज़ के बनाए जाने की तिथि)।

मैं तिथि फ़ील्ड को हिजरी लूनर कैलेंडर का उपयोग करने के लिए कैसे सेट करूँ?

UseLunarCalendar = true को FieldDate, FieldCreateDate, FieldPrintDate, या FieldSaveDate इंस्टेंस पर सेट करें, फिर Update() को कॉल करें।

इन चार क्लासों में से कौनसी दस्तावेज़ के अंतिम सहेजे जाने का समय ट्रैक करती है?

FieldSaveDate, जो SAVEDATE फ़ील्ड को लागू करता है।

क्या ये क्लासें कस्टम फ़ॉर्मैटिंग चित्रों को समर्थन देती हैं, केवल कैलेंडर स्विच नहीं?

हाँ — प्रत्येक एक Format संपत्ति (FieldFormat) बेस फ़ील्ड इन्फ्रास्ट्रक्चर से विरासत में मिली; देखें फ़ील्ड परिणाम स्वरूपण के लिए गाइड NumericFormat and DateTimeFormat.

API Reference सारांश

यह भी देखें

• Aspose.Words for .NET — Enterprise Documentation