Tarih ve Saat Alanları
Tarih ve Saat Alanları
Bu kılavuz, Aspose.Words FOSS için .NET takvim-bilincine sahip tarih ve saat alan sınıflarıyla nasıl çalışılacağını gösterir — FieldDate, FieldCreateDate, FieldPrintDate, ve FieldSaveDate — Word’ün uyguladığı DATE, CREATEDATE, PRINTDATE, ve SAVEDATE alanlarını sırasıyla. Her sınıf şunlardan türetilir Field ve uygular IFieldWithCalendar; temel Field nesne modeli kendisi (güncelleme, bağlantıyı kaldırma, silme ve herhangi bir alanı biçimlendirme), bkz. Alanlarla Çalışma kılavuz.
Dört Tarih ve Saat Alan Sınıfı
FieldDate, DATE alanını uygular. FieldCreateDate, CREATEDATE‘i, belgenin oluşturulduğu tarihi uygular. FieldPrintDate, PRINTDATE‘i, belgenin en son yazdırıldığı tarihi uygular. FieldSaveDate, SAVEDATE‘i, belgenin en son kaydedildiği tarihi uygular. Dörtünün tamamı Field‘in alt sınıflarıdır ve IFieldCodeTokenInfoProvider ve IFieldWithCalendar‘ı uygular, bu yüzden Field‘in GetFieldCode(), Update(), Unlink(), Remove() ve biçimlendirme (Format) üyelerini, aşağıda açıklanan kendi takvim anahtarlarıyla birlikte paylaşırlar.
Gregoryen Olmayan Bir Takvim Seçme
Dört sınıftan her biri, sonucu Hicri Lunar veya İbranice Lunar takvimle görüntülemek için UseLunarCalendar (bool), Saka Çağı takvimi için UseSakaEraCalendar (bool) ve Um-al-Qura takvimi için UseUmAlQuraCalendar (bool) ortaya çıkarır. Update()‘i çağırmadan önce ilgili özelliği true olarak ayarlayın; böylece alan, varsayılan Gregoryen takvim yerine o takvim sistemini kullanarak sonucunu yeniden hesaplar.
FieldDate’ın Uygulama-Biçim Anahtarı
FieldDate ayrıca UseLastFormat (bool) özelliğini ortaya çıkarır; bu, yeni bir DATE alanı eklendiğinde alanın, barındırma uygulaması tarafından en son kullanılan biçimi kullanıp kullanmayacağını kontrol eder. FieldCreateDate, FieldPrintDate ve FieldSaveDate bu özelliği ortaya çıkarmaz.
İpuçları ve En İyi Uygulamalar
- Bir takvim anahtarı (
UseLunarCalendar,UseSakaEraCalendarveyaUseUmAlQuraCalendar) ayarlayın ve ardından alandaUpdate()çağırın — yalnızca özelliği değiştirmekResult‘yi yeniden hesaplamaz. - Belirli bir alan örneğinde yalnızca bir takvim anahtarını
trueolarak ayarlayın; birden fazla anahtarın birleştirilmesi belirsiz bir sonuç üretir. - Kullan
Field.Format(aFieldFormat, kapsanan Alan Sonuç Biçimlendirme kılavuz) bu takvim anahtarlarıyla birlikte, sonuca uygulanan sayısal veya tarih/saat biçimlendirme desenini de kontrol etmek için. - İhtiyacınız olan anlamsal yapıya uygun sınıfı seçin —
FieldSaveDateveFieldPrintDatebelgede kaydedilen zaman damgalarını okur,FieldDateise alanın güncellendiği tarihi yansıtır.
Yaygın Sorunlar
| Sorun | Neden | Düzeltme |
|---|---|---|
| Takvim anahtarı, gösterilen sonuca etki etmiyor | Özellik ayarlandıktan sonra alan yeniden hesaplanmadı | UseLunarCalendar, UseSakaEraCalendar veya UseUmAlQuraCalendar ayarlandıktan sonra alan örneği üzerinde Update() çağırın |
UseLastFormat, FieldPrintDate veya FieldSaveDate üzerinde derlenmiyor | Bu özellik yalnızca FieldDate üzerinde mevcuttur | Uygulama-format-follows davranışı için FieldDate kullanın, ya da diğer sınıflarda Format değerini açıkça ayarlayın |
| Sonuç yanlış takvim sistemini gösteriyor | Aynı alanda birden fazla takvim geçişi true olarak ayarlandı | Her alan örneği için sadece UseLunarCalendar, UseSakaEraCalendar, UseUmAlQuraCalendar’den birini ayarlayın |
FAQ
FieldDate ile FieldCreateDate arasındaki fark nedir?
FieldDate, DATE alanını uygular (her güncellemede mevcut tarihe yeniden hesaplar); FieldCreateDate, CREATEDATE uygular (belgenin oluşturulduğu tarih).
Bir tarih alanının Hijri Lunar takvimini kullanmasını nasıl ayarlarım?
UseLunarCalendar = true‘ı FieldDate, FieldCreateDate, FieldPrintDate veya FieldSaveDate örneğinde ayarlayın, ardından Update()‘ı çağırın.
Dört sınıftan hangisi bir belgenin en son ne zaman kaydedildiğini izler?
FieldSaveDate, SAVEDATE alanını uygulayan.
Bu sınıflar takvim geçişlerinin yanı sıra özelleştirilmiş biçimlendirme resimlerini de destekliyor mu?
Evet — her biri bir Format özellik (FieldFormat) temel alan altyapısından devralınmıştır; bkz. Alan Sonuç Biçimlendirme kılavuzu NumericFormat and DateTimeFormat.
API Reference Özet
| Sınıf/Yöntem | Açıklama |
|---|---|
FieldDate | DATE alanını uygular |
FieldCreateDate | CREATEDATE alanını uygular |
FieldPrintDate | PRINTDATE alanını uygular |
FieldSaveDate | SAVEDATE alanını uygular |
UseLunarCalendar | Sonucu Hijri Lunar veya Hebrew Lunar takvimini kullanarak render eder |
UseSakaEraCalendar | Sonucu Saka Era takvimini kullanarak render eder |
UseUmAlQuraCalendar | Sonucu Um-al-Qura takvimini kullanarak render eder |
FieldDate.UseLastFormat | Barındırma uygulaması tarafından yeni bir DATE alanı için son kullanılan biçimi kullanır |
IFieldWithCalendar | Takvim farkındalıklı alan sonuçları için dört sınıfın tümü tarafından uygulanan arayüz |