Dátum és idő mezők

Dátum- és időmezők

Ez az útmutató bemutatja, hogyan dolgozhatunk a naptár-tudatos dátum- és időmező osztályokkal a Aspose.Words FOSS-ban a .NET számára — FieldDate, FieldCreateDate, FieldPrintDate, és FieldSaveDate — amelyek megvalósítják a Word DATE, CREATEDATE, PRINTDATE, és SAVEDATE mezőket, rendre. Minden osztály származik a Field és megvalósítja IFieldWithCalendar; az alap Field objektummodell magát (frissítés, leválasztás, eltávolítás és bármely mező formázása), lásd a Munka a mezőkkel útmutató.

A négy dátum- és időmező osztály

FieldDate megvalósítja a DATE mezőt. FieldCreateDate megvalósítja a CREATEDATE mezőt, amely a dokumentum létrehozásának dátuma. FieldPrintDate megvalósítja a PRINTDATE mezőt, amely a dokumentum legutóbbi nyomtatásának dátuma. FieldSaveDate megvalósítja a SAVEDATE mezőt, amely a dokumentum legutóbbi mentésének dátuma. Mind a négy a Field alosztálya, és a IFieldCodeTokenInfoProvider és IFieldWithCalendar implementálja, így megosztják a Field GetFieldCode(), Update(), Unlink(), Remove() és a formázási (Format) tagjait, valamint az alább leírt saját naptárkapcsolóikat.

Nem gregorián naptár kiválasztása

A négy osztály egyike is megjeleníti a UseLunarCalendar (bool) tulajdonságot, amely a hijri hold- vagy héber holdnaptár használatával jeleníti meg az eredményt, a UseSakaEraCalendar (bool) a Saka korszak naptárához, és a UseUmAlQuraCalendar (bool) az Um-al-Qura naptárhoz. Állítsa be a megfelelő tulajdonságot true értékre, mielőtt meghívná a Update() metódust, hogy a mező újraszámolja az eredményt az adott naptárrendszerrel a alapértelmezett gregorián naptár helyett.

FieldDate alkalmazás-formátum kapcsolója

FieldDate továbbá láthatóvá teszi a UseLastFormat (bool) tulajdonságot, amely szabályozza, hogy a mező a házigazda alkalmazás által legutóbb használt formátumot használja-e, amikor egy új DATE mező kerül beszúrásra. FieldCreateDate, FieldPrintDate és FieldSaveDate nem teszik elérhetővé ezt a tulajdonságot.

Tippek és legjobb gyakorlatok

• Állíts be egy naptárkapcsolót (UseLunarCalendar, UseSakaEraCalendar vagy UseUmAlQuraCalendar), majd hívd meg a Update() függvényt a mezőn – a tulajdonság önmagában történő módosítása nem számolja újra a Result értékét.
• Az adott mezőpéldányon csak egy naptárkapcsolót állíts be true értékre; több kombinálása nem egyértelmű eredményt okoz.
• Használja Field.Format (a FieldFormat, amely a Mező eredmény formázása útmutató) együtt ezekkel a naptárkapcsolókkal, hogy a numerikus vagy dátum/idő formázási képet is irányítsa, amely az eredményre lesz alkalmazva.
• Válaszd ki a szükséges szemantikai osztályt – a FieldSaveDate és a FieldPrintDate a dokumentumban rögzített időbélyegeket olvassák, míg a FieldDate azt a dátumot tükrözi, amikor a mező frissül.

Gyakori problémák

FAQ

Mi a különbség a FieldDate és a FieldCreateDate között?

FieldDate megvalósítja a DATE mezőt (újraszámolja a jelenlegi dátumra minden frissítéskor); FieldCreateDate megvalósítja a CREATEDATE mezőt (a dokumentum létrehozásának dátuma).

Hogyan tudok egy dátummezőt a Hijri holdnaptár használatára beállítani?

Állítsa be a UseLunarCalendar = true értéket a FieldDate, FieldCreateDate, FieldPrintDate vagy FieldSaveDate példányon, majd hívja meg a Update() függvényt.

A négy osztály közül melyik követi nyomon, hogy a dokumentum mikor lett legutóbb mentve?

FieldSaveDate, amely megvalósítja a SAVEDATE mezőt.

Támogatják ezek az osztályok az egyedi formázási képeket, nem csak a naptárkapcsolókat?

Igen — mindegyik egyet tesz elérhetővé Format tulajdonság (FieldFormat) öröklődik az alapmező infrastruktúrából; lásd a Mezőeredmény formázása útmutató NumericFormat and DateTimeFormat.

API Reference Összefoglaló

Lásd még:

• Aspose.Words for .NET — Enterprise Documentation