Tarih/saat seçici

Tarih ve saat verilerini toplamak için bir takvim ve giriş alanı oluşturur. Yerelleştirilen takvimleri, kapalı tarihleri ve farklı sunum seçeneklerini destekler.

Yalnızca Android ya da iOS işletim sistemlerini çalıştıran mobil aygıtlarda Tarih/saat seçici görünümü, işletim sistemine (OS) dahil olan yerel tarih ve saat seçiciyi gösterir. Bu davranış, kullanıcıların farklı tarih ve saat seçicileri gördükleri anlamına gelir. Örneğin, Android işletim sisteminde bir kullanıcı Google Chrome ile bir görev üzerinde çalışabilir ve bu nedenle yerel Android tarih ve saat seçicisini görebilir. Kullanıcı daha sonra Apple iPhone' a geçiş yaparsa, bunun yerine yerel iOS tarih ve saat seçicisini görür.

Tarih UTC saat olarak saklansa da, gösterilen tarih ve saat kullanıcının sisteminin saat dilimine göre ayarlanır.

Kısıtlamalar ve sınırlamalar

Kullanıcı, tam tarih olmayan ya da geçerli bir biçimde olmayan bir içerik girerse, kullanıcı bir düğmeye tıklama gibi bir sınır olayını tetiklediğinde bağlı veri öğesi boş olur. Akış sayfaya geri dönerse, görünüm boştur. Aynı veri öğesine bağlı diğer görünümler de boştur.

Yerel tarih ve saat seçicilerin kullanılması, aşağıdaki özellikler gibi bazı yapılandırma özelliklerinin geçerli olmadığı anlamına gelir:

  • Geçersiz kılınan hafta günleri
  • Seçilemeyecek tarihler
  • Seçilemeyecek tarih başlangıcı
  • Seçilemeyecek tarih sonu
  • Hafta başlangıcı
  • Takvim tipi ( İbranice ya da İslami seçildiğinde)
  • Tarih Seçici tipi ( İç seçildiğinde)
Tablo görünümünde metin girişi olarak bir Tarih/saat seçici kullandığınızda, tablo hücresinde Tarih/saat seçici açılan açılır görüntülenir. Seçiciyi tablonun üstünde göstermek için beliren pencereleri göster Tablo yapılandırma özelliğini seçin. Daha fazla bilgi için bkz. Tablo.

Veri bağ tanımı

Genel özellikler sekmesinde görünüm için veri bağ tanımını ayarlayın ya da değiştirin. Veri bağ tanımı, değer güncellemelerini görüntülemek ve depolamak için kullanılacak ilk tarih ve saati içerir. Veri tipi: Date.

Yapılandırma özellikleri

Yapılandırmaaltında, görünüme ilişkin görünüm ve davranış özelliklerini ayarlayın ya da değiştirin.

Ekran Boyutu
Özellik adının yanında Ekran Boyutları simgesi Ekran Boyutları simgesi olan bir yapılandırma özelliği, her ekran boyutu için farklı değerlere sahip olabilir. Bir değer ayarlamazsanız, ekran boyutu sonraki daha büyük ekran boyutunun değerini varsayılan değeri olarak devralır.
Tema tanımlamaları
Tema tanımlamaları, bir görünümün renklerini ve biçemlerini belirler ve görünüşünü belirler. Tema düzenleyicisinde görünümlerin görünümünü önizleyebilirsiniz. Bkz. Temalar.
Tarih/saat seçicisi için görünüm yapılandırma özellikleri aşağıdaki tabloda gösterilir:
Tablo 1. Tarih/saat seçici için görünüm yapılandırma özellikleri
Görünüş yapılandırma özelliği Açıklama Veri tipi
Tarih Alıcı tipi Ekran Boyutları simgesi Tarih saat seçici için görüntülenen takvim tipi:
  • Metin Girişi: Bu takvim görüntüsü bir metin giriş kutusu içerir ve başlangıçta takvimi gizler. Metin kutusu tıklatıldığında takvim görüntülenir.
  • İç: Bu takvim görüntüsü bir iç takvim içerir ve metin giriş kutusunu gizler.

Varsayılan değer Metin Girişi' dir.

DatePickerType
Genişlik Tarih Seçici tipi özelliği için Metin Girişi tipi seçildiğinde tarih saat seçicinin genişliği. Genişliği px (piksel), % (yüzde) ya da em birimlerinde belirtebilirsiniz. Örneğin, 200px. Sayısal değerle bir birim tipi belirtilmezse, px varsayılır. Varsayılan olarak genişlik belirtilmez. String
Boyut Ekran Boyutları simgesi Görünümdeki metnin boyutu, etiket metninin boyutu ve metnin çevresindeki dolgu miktarı. Örneğin, metni ve etiketi akıllı telefonlarda daha okunabilir yapmak için, bu yapılandırma seçeneğini Large olarak ayarlayabilir ve küçük ekran boyutunu dengeleyebilirsiniz. TextSizeStyle
Etiket yerleşimi Ekran Boyutları simgesi Tarih saat seçici için etiket yerleştirme konumu. LabelPlacement
Etiket genişliği Büyük ekran simgesi Etiketin genişliği. px (piksel),% (yüzde) ya da em birimleri olarak genişliği belirtebilirsiniz. Örneğin, 50px, %20 ya da 0.4em. Bir birim tipi belirtilmezse px varsayılır. String
Biçim Metin alanına girilen metni görüntülemek ve ayrıştırmak için kullanılan biçim.
Ayırıcılar, boşluk, yalnızca gün ve ay, yalnızca gün, vb. içeren ve doğal dile yakın olan biçimler de içinde olmak üzere çeşitli tarih girişlerini kabul eder.
Örneğin, 17yazarsanız, tarih seçici geçerli ayın ve yılın 17th değerini alır. 5/25girişi için, geçerli yılın ay/günü olduğunu varsayar.
Bu yapılandırma seçeneği yalnızca bir tarayıcının yerel tarih ve saat seçicisi olmadığında geçerlidir.
String
Hafta başlangıcı Her hafta başlayan gün. Varsayılan değer Pazar' dır. DatePickerWeekStart
Geçersiz kılınan hafta günleri Takvimde engellenen haftanın bir ya da daha fazla günü. Varsayılan olarak, hiçbir gün devre dışı bırakılmaz. DatePickerDisabledWeekDays
Bugün düğmesini göster Tarihi bugünün tarihine ayarlayan Bugün düğmesini gösterin ya da gizleyin. Varsayılan olarak düğme görüntülenmez. Boolean
Temizle düğmesini göster Tarih değerini temizleyen Temizle düğmesini gösterin ya da gizleyin. Varsayılan olarak düğme görüntülenmez. Boolean
Yön Tıklatıldığında takvimin yönü. DatePickerOrientation
Renk stili Tarih saat seçicinin renk stili. Renkler, belirtilen temadaki değişkenlere karşılık gelir. Varsayılan değer Varsayılan ' dır (koyu mavi). DatePickerColorStyle
Hafta numarasını göster Ekran Boyutları simgesi Gregoryen takvimler için, yılın hafta sayısını görüntüler. Örneğin, bir Gregoryen yılının son haftası hafta sayısıdır52. Varsayılan olarak, hafta numarası gösterilmez. Boolean
Bugünü Vurgula Bugünün tarihinin takvimde vurgulanıp vurgulanmayacağını belirtir. Varsayılan olarak, bugünün tarihi vurgulanmaz. Boolean
Üstbilgiyi gizle Özel tarih ve saat seçicinin üstündeki üstbilgiyi gizler. Varsayılan olarak, üstbilgi gizlenmez. Boolean
Takvim simgesini göster Metin giriş kutusunda takvim simgesini görüntüler. Boolean
Yıl seçici stili Yıl seçicinin stili, Varsayılan ya da Modern. tableHFStyle
Tarih/saat seçicisi için davranış yapılandırma özellikleri aşağıdaki tabloda gösterilir:
Tablo 2. Tarih/saat seçici için davranış yapılandırma özellikleri
Davranış yapılandırma özelliği Açıklama Veri tipi
Yalnızca özel seçici Özel tarih ve saat seçiciyi her zaman yerel tarih ve saat seçici yerine mobil aygıtlarda görüntüleyin.

Mobil aygıtlarda, yerel tarih ve saat seçiciyi görüntülemek için her zaman ilk girişimde bulunulmuştur. Ancak, aşağıdaki desteklenmeyen yapılandırma özelliklerinden herhangi biri belirtildiğinde özel tarih ve saat seçici görüntülenir:

  • Geçersiz kılınan hafta günleri
  • Seçilemeyecek tarihler
  • Seçilemeyecek tarih başlangıcı
  • Seçilemeyecek tarih sonu
  • Hafta başlangıcı
  • Takvim tipi ( İbranice ya da İslami seçildiğinde)
  • Tarih Seçici tipi ( İç seçildiğinde)

Varsayılan olarak, hem özel tarih ve saat seçici, hem de yerel tarih ve saat seçici uygun olduğunda kullanılır.

Boolean
Zaman seçici ekle Tarih/saat seçici görünümüyle saat seçiciyi görüntüleyin. Varsayılan olarak saat seçici görüntülenmez. Boolean
Takvim tipi Takvim tipi:
  • Gregoryen
  • İbranice
  • İslami

Varsayılan değer Gregoryen' tir.

CalendarType
Sekme dizini Sekme sırası dizini. Sekme dizinleri 1 'den başlar ve seyrek olarak ayarlanabilir. Örneğin, 1, 5, 10 değerleri kullanılabilir. Sekme dizini özelliği, Sekme tuşuna basarak UI alanları arasında hareket ettiğinizde sekme sırasını denetler. String
Yer tutucu metni Tarih girilmediğinde kullanılacak yer tutucu metni. Genellikle metin, kullanıcının gerektirdiği girişin kısa bir açıklaması ya da örneğidir. Bağlı veri öğesi bir değer içermiyorsa, kullanıcılar alana yazıncaya kadar ipucunu görür. Varsayılan olarak, yer tutucu metni belirtilmez. String
Kullanılabilir başlangıç tarihi Kullanılabilir başlangıç tarihini ve saatini belirtir. Belirtilen kullanılabilir başlangıç tarihinden önceki tüm tarihler engellenecek. Kullanılabilir başlangıç tarihi biçimi, Görünüş özelliklerinde Biçim özelliği tarafından belirtilir. Varsayılan olarak, kullanılabilir bir başlangıç tarihi belirtilmez. Date
Kullanılabilir bitiş tarihi Kullanılabilir bitiş tarihi ve saati. Belirtilen kullanılabilir bitiş tarihinden sonraki tüm tarihler engellenecek. Kullanılabilir bitiş tarihi biçimi, Görünüş özelliklerinde Biçim özelliği tarafından belirtilir. Varsayılan olarak, kullanılabilir bir bitiş tarihi belirtilmez. Date
Seçilemeyecek tarihler Tek bir tarih ya da birden çok ardışık olmayan tarih ya da liste, karartma ile son bulacaktır. Zamanlanamayacak tarihlerin bir listesi sağlanırsa, görünüm yerel tarih ve saat seçici yerine özel tarih ve saat seçiciyi kullanır. Varsayılan olarak, zamanlanamayacak tarih belirtilmez. Date (List)
Seçilemeyecek tarih başlangıcı Karartmak istediğiniz ardışık tarihlerden oluşan bir aralığın başlangıç tarihi. Varsayılan olarak, kapalı başlangıç tarihi belirtilmez. Date
Seçilemeyecek tarih sonu Karartmak istediğiniz ardışık tarihlerden oluşan bir aralığın bitiş tarihi. Varsayılan olarak, kapalı bitiş tarihi belirtilmez. Date
Başlangıç görünümü Takvimin başlaması gereken ayrıntı düzeyi:
  • Ay
  • Yıl
  • Onyıl

Varsayılan değer Ay' dır.

DatePickerStartView
En az görüntüleme kipi Takvimde kullanılacak minimum tarih ayrıntı düzeyleri:
  • Günler
  • Ay
  • Yıllar

Varsayılan değer Günler' dir.

DatePickerMinViewMode
Otomatik kapatma yok Bir tarih seçildiğinde takvimin kapanmayacağını belirtir. Bunun yerine, tarih saat seçici odağı kaybettiğinde takvim kapanır. Varsayılan olarak, bir tarih seçildiğinde takvim otomatik olarak kapanır. Boolean

Örnek

Tıklatılabilir bir takvim düğmesinin olmasını istiyorsanız, Giriş Grubu görünümünün içine bir Tarih/saat seçici görünümü yerleştirebilirsiniz. Giriş Grubu görünümünün özelliklerinde, Düğme tipi özelliğini Simge olarak ayarlayın ve Düğme bilgisi özelliğini takvimolarak ayarlayın. Giriş Grubu görünümüne ilişkin On button click olayında şu dizgiyi yazın:

${Control_ID}._instance.pickerControl.show();

<

Olaylar özelliklerinde görünüm için olay işleyicilerini ayarlayın ya da değiştirin. Olayları programlı olarak ya da kullanıcı görünümle etkileşimde bulunduğunda tetiklenecek şekilde ayarlayabilirsiniz. Olayları tanımlama ve kodlama hakkında bilgi için bkz. Kullanıcı tanımlı olaylar. Tarih/saat seçici aşağıdaki olay işleyici tiplerine sahiptir:

  • On load: Sayfa yüklendiğinde etkinleştirilmiştir. Örneğin:

    var workerStart = ${StartDate}.getDate(); me.setStart(workerStart);

  • On change: Bir değişiklik algılandığında etkinleştirilmiştir. Örneğin:

    return confirm("Are you sure you want to change date?")

  • On day cell render: Bir gün hücresi görüntüsü oluşturulduğunda etkinleştirilmiştir. Tarih, tarih saat seçicide gösterilmeden önce tetiklenir. Örneğin:

    me.setDate("01/01/2015")

Belirli bir olaya bağlı olarak, görünümün etkilerini değiştirmek için JavaScript mantığını kullanabilirsiniz. Olayların görünümlerle kullanılmasına ilişkin ek bilgi için Kullanıcı tanımlı olaylarkonusuna bakın.

yöntemler

Tarih/saat seçici için kullanılabilecek yöntemler hakkında ayrıntılı bilgi için Tarih/saat seçici JavaScript API ' ye bakın.

Ek kaynaklar

Coach ya da sayfa yaratma hakkında bilgi için Coach oluşturmabaşlıklı konuya bakın.
Standart özelliklerle ilgili bilgi için (Genel, Yapılandırma, Konumlandırma, Görünürlükve HTML Öznitelikleri) bkz. Özelliklerin görüntülenmesi.