Aspose.Words FOSS
.NET
מדריך למפתחים
שדות תאריך ושעה

שדות תאריך ושעה

שדות תאריך ושעה

מדריך זה מראה כיצד לעבוד עם מחלקות השדה לתאריך ולזמן המודע ללוח השנה ב-Aspose.Words FOSS עבור .NET — FieldDate, FieldCreateDate, FieldPrintDate, ו FieldSaveDate — שמיישמות את של Word’s DATE, CREATEDATE, PRINTDATE, ו SAVEDATE שדות בהתאמה. כל מחלקה נגזרת מ- Field ומממשת IFieldWithCalendar; עבור הבסיס Field מודל האובייקט עצמו (עדכון, ניתוק, הסרה, ועיצוב של כל שדה), ראה את עבודה עם שדות מדריך.

ארבעת מחלקות השדות של תאריך ושעה

FieldDate מיישמת את השדה DATE. FieldCreateDate מיישמת את CREATEDATE, תאריך יצירת המסמך. FieldPrintDate מיישמת את PRINTDATE, תאריך ההדפסה האחרונה של המסמך. FieldSaveDate מיישמת את SAVEDATE, תאריך השמירה האחרונה של המסמך. כל ארבעת המחלקות הן תתי-מחלקות של Field ומממשות את IFieldCodeTokenInfoProvider ו-IFieldWithCalendar, ולכן הן חולקות את Field’s GetFieldCode(), Update(), Unlink(), Remove(), ואת חברי העיצוב (Format) יחד עם מתגי הלוח השנה שלהם המתוארים להלן.

בחירת לוח שנה שאינו גרגוריאני

כל אחת מארבעת המחלקות חושפת את UseLunarCalendar (bool) כדי להציג את התוצאה באמצעות לוח השנה ההיג’רי הלונרי או הלוח היהודי הלונרי, את UseSakaEraCalendar (bool) עבור לוח השנה של תקופת סאקה, ואת UseUmAlQuraCalendar (bool) עבור לוח השנה אום-אל-קורה. קבע את המאפיין המתאים ל-true לפני קריאה ל-Update() כדי שהשדה יחשב מחדש את תוצאתו באמצעות מערכת הלוח השנה הזו במקום לוח השנה הגרגוריאני ברירת המחדל.

מתג היישום-פורמט של FieldDate

FieldDate חושף בנוסף את UseLastFormat (bool), שמבקר האם השדה משתמש בפורמט שבשימוש אחרון על ידי היישום המארח כאשר משולב שדה DATE חדש. FieldCreateDate, FieldPrintDate ו-FieldSaveDate אינם חושפים מאפיין זה.

טיפים ושיטות מומלצות

  • הגדר מתג לוח שנה (UseLunarCalendar, UseSakaEraCalendar או UseUmAlQuraCalendar) ולאחר מכן קרא ל-Update() על השדה — שינוי המאפיין בלבד אינו מחשב מחדש את Result.
  • הגדר רק מתג לוח שנה אחד ל-true במופע שדה נתון; שילוב של יותר מאחד יוצר תוצאה מעורפלת.
  • השתמש Field.Format (a FieldFormat, מכוסה ב- עיצוב תוצאות השדה מדריך) לצד מתגי היומן האלה כדי גם לשלוט בתצורת המספר או בתמונה של עיצוב תאריך/שעה המוחלת על התוצאה.
  • בחר את המחלקה המתאימה למשמעות שאתה צריך — FieldSaveDate ו-FieldPrintDate קוראים חותמות זמן שנרשמו במסמך, בעוד FieldDate משקפת את התאריך שבו השדה מתעדכן.

בעיות נפוצות

בעיהסיבהתיקון
החלפת לוח השנה אינה משפיעה על התוצאה המוצגתהשדה לא חושב מחדש לאחר שהמאפיין הוגדרקרא Update() על מופע השדה לאחר שהגדרת UseLunarCalendar, UseSakaEraCalendar או UseUmAlQuraCalendar
UseLastFormat אינו מתקמפל בFieldPrintDate או בFieldSaveDateהמאפיין הזה קיים רק בFieldDateהשתמש בFieldDate להתנהגות application-format-follows, או הגדר את Format במפורש על המחלקות האחרות
התוצאה מציגה מערכת לוח שנה שגויהיותר ממתג לוח שנה אחד הוגדר ל-true באותו שדההגדר רק אחד מ-UseLunarCalendar, UseSakaEraCalendar, UseUmAlQuraCalendar לכל מופע שדה

FAQ

מה ההבדל בין FieldDate ל-FieldCreateDate?

FieldDate מיישם את השדה DATE (מתחדש לתאריך הנוכחי בכל עדכון); FieldCreateDate מיישם את CREATEDATE (התאריך שבו נוצר המסמך).

איך לגרום לשדה תאריך להשתמש בלוח השנה ההיג’רי הלונרי?

הגדר את UseLunarCalendar = true על המופע של FieldDate, FieldCreateDate, FieldPrintDate או FieldSaveDate, ואז קרא ל-Update().

איזו מבין ארבעת המחלקות עוקבת אחרי מתי המסמך נשמר לאחרונה?

FieldSaveDate, שמיישמת את השדה SAVEDATE.

האם המחלקות האלה תומכות בתמונות פורמט מותאם אישית, ולא רק במתגי לוח השנה?

כן — כל אחד חושף a Format מאפיין (FieldFormat) יורש מתשתית השדה הבסיסית; ראה את עיצוב תוצאות שדה מדריך ל NumericFormat and DateTimeFormat.

API Reference סיכום

Class/Methodתיאור
FieldDateמממש את השדה DATE
FieldCreateDateמממש את השדה CREATEDATE
FieldPrintDateמממש את השדה PRINTDATE
FieldSaveDateמממש את השדה SAVEDATE
UseLunarCalendarמציג את התוצאה באמצעות לוח השנה הלונרי של ההיג’רי או הלונרי של העברי
UseSakaEraCalendarמציג את התוצאה באמצעות לוח השנה של Saka Era
UseUmAlQuraCalendarמציג את התוצאה באמצעות לוח השנה של Um-al-Qura
FieldDate.UseLastFormatמשתמש בפורמט שבו השתמשה לאחרונה האפליקציה המארחת עבור שדה DATE חדש
IFieldWithCalendarממשק שמיושם על ידי כל ארבעת המחלקות לתוצאות שדה מודעות ללוח שנה

ראה גם

 עברית