Ana içeriğe geç

Süre

Süre bileşeni, kullanıcıların bir zaman aralığı belirtmesini ve bunu çeşitli birimlerle (gün, saat, dakika vb.) ifade etmesini sağlar.

XML Alanları

XPath Saklanan süreyi tanımlar. Template Kullanıcıya gösterilen ISO-8601 süre biçimini tanımlar; örneğin gün, saat ve dakika için P0DT0H0M . ValidationGroup İlgili grup doğrulandığında sürenin de doğrulamaya katılmasını sağlar. Hints Yardım metnini sağlar ve Rules koşullu biçimlendirme veya doğrulama içerir.

Süre Şablonu

Süre birimleri bir şablon ifadesi kullanılarak tanımlanır. Şablon sağlanmazsa varsayılan şablon P0DT0H0M (sıfır süreyi temsil eden) kullanılır.

Süre İfadesi Biçimi

Süre ifadesi aşağıdaki yapıya uyar:

  1. Şununla başlar: P
  2. Ardından yıl (Y), ay (M) ve gün (D) birimleri gelir (isteğe bağlıdır ve bu sırada belirtilir).
  3. Ardından T gelir (zaman birimleri belirtilmişse).
  4. Ardından saat (H), dakika (M) ve saniye (S) birimleri gelir (isteğe bağlıdır ve bu sırada belirtilir).

Birim Tanımlayıcıları:

  • Y: Yıl
  • M: Ay
  • D: Gün
  • H: Saat
  • M: Dakika
  • S: Saniye

Örnekler

  • P1D: 1 Gün
  • P1M2D: 1 Ay ve 2 Gün
  • P1MT8H: 1 Ay ve 8 Saat
  • PT2H: 2 Saat

Göreli Tarih Belirteçleri

Kullanılabilirliği artırmak için bileşen, standart ISO-8601 süre biçimine ek olarak göreli tarih belirteçlerini de destekler. Bu belirteçler tarihi geçerli tarihe göre değiştirir.

  • YB: Yıl Başlangıcı (yılın başlangıcı)
  • YE: Yıl Sonu (yılın sonu)
  • MB: Ay Başlangıcı (ayın başlangıcı)
  • ME: Ay Sonu (ayın sonu)
  • DB: Gün Başlangıcı (günün başlangıcı)
  • DE: Gün Sonu (günün sonu)

Göreli Tarih Örnekleri

  • P2YB: Geçerli tarihe 2 yıl ekler, ardından tarihi o yılın başlangıcına ayarlar.
  • P1M2DB: Geçerli tarihe 1 ay ve 2 gün ekler, ardından tarihi o günün başlangıcına ayarlar.
  • P1M2DE: Geçerli tarihe 1 ay ve 2 gün ekler, ardından tarihi o günün sonuna ayarlar.

Örnek

1
2
3
4
<Duration XPath="Time" Template="P0DT0H0M" ValidationGroup="">
    <Hints><![CDATA[]]></Hints>
    <Rules />
</Duration>