Tarih ve saat sütununun davranışı ve biçimi
Microsoft Dataverse'de, kullanıcılara tarih ve saat değerlerinin nasıl gösterileceğini ve saat dilimleri için nasıl ayarlandıklarını belirleyebilirsiniz.
Tarih ve saat sütunları için iki seçenek kullanılabilir.
- Davranış: Saat dilimlerinin değerlerinin ayarlanıp ayarlanmayacağı.
- Biçim: Değerin saat bölümünün görüntülenip görüntülenmeyeceği.
Davranış
Dataverse tüm tarih ve saat değerlerini UTC saat diliminde depolar. Uygulamanız kullanıcılar tarafından girilen değerleri veya işleme değerlerini görüntülediğinde Dataverse ve model temelli uygulamalar bu Davranış seçenekleriyle kullanıcının saat dilimi için ayarlayabilir.
- Kullanıcının saat dilimi: Kullanıcının saat dilimine ilişkin değerleri ayarlayın. Bu varsayılan davranıştır. Bunu bir kez başka bir davranışa değiştirebilirsiniz.
- Saat diliminden bağımsız: Saat dilimi dönüştürmesi yapılmaz.
- Yalnızca tarih Saat dilimi dönüştürmesi yapılmaz. Saat diliminden bağımsız'dan farklı olarak, saat bölümü depolanmaz.
Kullanıcının saat dilimi Windows, Android, iOS veya macOS'ta sistem saat diliminde değil kişisel seçeneklerde ayarlanır. Bununla birlikte, sistem saat dilimi JavaScript Tarihleriyle çalışan istemci komut dosyalarını etkileyebilir.
Biçimlendir
Davranışı Yalnızca Tarih olmadığı sürece, tüm tarih ve saat sütunlarının bir saat bölümü vardır. Biçim: değerin saat bölümünün görüntülenip görüntülenmeyeceğini belirler.
- Tarih ve saat: Değerin tarihini ve saatini görüntüler.
- Yalnızca tarih: Yalnızca değerin tarih bölümünü görüntüler.
Not
Biçim Yalnızca Tarih olduğunda kullanıcılar saat bölümünü değiştirebilir. Örneğin, Web API'si çağrıları ile veya zaman bölümüne sahip bir denetim kullanarak. Bu, zaman diliminin hiç depolanmadığı Yalnızca Tarih Davranışı'ndan farklıdır.
Kullanım yönergeleri
Otele giriş saati gibi saat dilimi bilgilerinin gerekli olmadığı durumlarda Saat diliminden bağımsız davranışını kullanabilirsiniz. Bu seçimle tüm saat dilimlerindeki kullanıcılar aynı tarih ve saat değerini görür.
Günün saati ve saat dilimi hakkındaki bilgilerin gerekli olmadığı doğum günleri ve yıldönümleri gibi durumlar için Yalnızca tarih davranışını kullanın. Bu seçimle tüm saat dilimlerindeki kullanıcılar tam olarak aynı tarih değerini görür.
Yalnızca tarih biçimine sahip Saat diliminden bağımsız davranışı pratikte Yalnızca tarih davranışıyla aynıdır. Gelecekte zaman bölümünün gerekip gerekmeyeceğinden emin değilseniz öncekini kullanın.
Önemli
Yerel kullanıcı davranışına sahip Yalnızca tarih biçiminden kaçının. Farklı saat dilimlerindeki kullanıcılar farklı bir tarih görebilir, bu çoğu senaryoda amaçlanmamaktadır. Kullanıcı model odaklı bir uygulamada tarih belirlediğinde, saat bölümü otomatik olarak saat diliminin gece yarısı olarak ayarlanır. Bu, tarihin diğer kullanıcılar için bir gün önce veya daha sonra görünmesine neden olabilir.
Örnekler
Değerleri görüntüleme
Dataverse 2023-10-15T07:30:00Z depolar (veya Yalnızca tarih davranışı için 2023-10-15). UTC-8 saat dilimindeki kullanıcılar, model yönetimli uygulamada veya biçimlendirilmiş değer için bir Web API isteğiyle şunları görebilir:
| Davranış | Biçimlendir | Değeri görüntüleme |
|---|---|---|
| Kullanıcının saat diliminde | Tarih ve saat | 14 Ekim 2023, 23:30 |
| Kullanıcının saat diliminde | Yalnızca tarih | 14 Ekim 2023 |
| Saat diliminden Bağımsız | Tarih ve saat | 15 Ekim 2023, 7:30 |
| Saat diliminden Bağımsız | Yalnızca tarih | 15 Ekim 2023 |
| Yalnızca tarih | - | 15 Ekim 2023 |
Bir uygulamaya değer girin
UTC-8 saat dilimindeki kullanıcılar model temelli bir uygulamaya October 14th, 2023, 11:30 pm girin. Değer Dataverse'de şu şekilde kaydedilir:
| Davranış | Biçimlendir | Dataverse'de kayıtlı değer |
|---|---|---|
| Kullanıcının saat diliminde | Tarih ve saat | 2023-10-15T07:30:00Z |
| Kullanıcının saat diliminde | Yalnızca tarih | 2023-10-15T07:30:00Z |
| Saat diliminden Bağımsız | Tarih ve saat | 2023-10-14T23:30:00Z |
| Saat diliminden Bağımsız | Yalnızca tarih | 2023-10-14T23:30:00Z |
| Yalnızca tarih | - | 14-10-2023 |
Kullanıcı yalnızca October 14th, 2023 tarihi girerse, saat bölümünün 00:00 olduğu varsayılır.
| Davranış | Biçimlendir | Dataverse'de kayıtlı değer |
|---|---|---|
| Kullanıcının saat diliminde | Yalnızca tarih | 2023-10-14T08:00:00Z |
| Saat diliminden Bağımsız | Yalnızca tarih | 2023-10-14T00:00:00Z |
| Yalnızca tarih | - | 14-10-2023 |
Bir uygulamaya geçersiz değerler girme
Farklı istemcilerin geçersiz girişi işlemek için farklı yolları vardır. Örneğin, Pasifik saat diliminde, yaz saati 12 Mart 2023 tarihinde saat 02:00'de başlar ve saat bir saat ileri alınarak 03:00 yapılır. İlgili günde 02:00 ile 03:00 arasında saat yoktur. Kullanıcılar bu zaman aralığına bir değer girmeye çalıştıklarında uygulamalar aşağıdakilerden birini yapabilir:
- Önceki veya sonraki geçerli saate değiştirmek.
- Bilinen son değere döndürmek.
- Hata iletisi göstermek.
- Kullanıcıların ilk etapta bu saatleri seçememesi için zaman seçicide 02:00 ile 03:00 arasındaki saatleri göstermeyin.
Benzer şekilde, farklı istemcilerin yinelenen zaman aralıklarını işlemek için farklı yolları vardır. Örneğin, Pasifik saat diliminde, yaz saati 5 Kasım 2023 tarihinde saat 02:00'de sona erer ve saat bir saat geri alınarak 01:00 yapılır. İlgili günde 01:00 ile 02:00 arasında saat iki kez yinelenir. 1:30 gibi bir saat, iki saat dilimini de belirtebilir. Bu aralıktaki saatleri açıkça göstermeniz veya girmeniz gerekirse geçici olarak yaz saati uygulamasını kullanmayan bir saat dilimine geçmek en iyisidir.
Web API'siyle ham değerleri alma
Dataverse 2023-10-15T07:30:00Z depolar (veya Yalnızca tarih davranışı için 2023-10-15). Tüm saat dilimlerindeki kullanıcılar, değer için bir Web API isteğiyle bunları alır:
| Davranış | Biçimlendir | Ham değer |
|---|---|---|
| Kullanıcının saat diliminde | Tarih ve saat | 2023-10-15T07:30:00Z |
| Kullanıcının saat diliminde | Yalnızca tarih | 2023-10-15T07:30:00Z |
| Saat diliminden Bağımsız | Tarih ve saat | 2023-10-15T07:30:00Z |
| Saat diliminden Bağımsız | Yalnızca tarih | 2023-10-15T07:30:00Z |
| Yalnızca tarih | - | 15-10-2023 |
İstemci API'siyle değerleri alma
UTC-8 saat dilimindeki kullanıcılar model temelli bir uygulamaya October 14th, 2023, 11:30 pm girin. İstemci API'si işlevleri (formContext.getAttribute(<column name>).getValue() gibi) değeri saat dilimi ayarlamaları uygulanmış olarak döndürür:
| Davranış | Biçimlendir | JavaScript dateValue.toUTCString() |
|---|---|---|
| Kullanıcının saat diliminde | Tarih ve saat | 2023-10-15 07:30 (UTC) |
| Kullanıcının saat diliminde | Yalnızca tarih | 2023-10-15 07:30 (UTC) |
Saat diliminden bağımsız davranışı için, JavaScript Tarih değeri tarayıcının saat dilimindedir:
| Davranış | Biçimlendir | JavaScript dateValue.toString() |
|---|---|---|
| Saat diliminden Bağımsız | Tarih ve saat | 2023-10-14 23:30 (tarayıcı saat dilimi) |
| Saat diliminden Bağımsız | Yalnızca tarih | 2023-10-14 23:30 (tarayıcı saat dilimi) |
JavaScript tarih değerleri her zaman bir saat bileşenine sahiptir. Bu nedenle Yalnızca tarih davranışı 00:00 saat bileşenine sahiptir:
| Davranış | Biçimlendir | JavaScript dateValue.toString() |
|---|---|---|
| Yalnızca tarih | - | 2023-10-15 00:00 (tarayıcı saat dilimi) |
Not
JavaScript tarih değerleri, tarayıcının cihaz işletim sistemi ayarlarından gelen saat diliminden etkilenir.
Kullanıcının saat dilimi davranışı için, İstemci API'si sonucu UTC değeri olarak yorumlanmalıdır. Bununla çalışmak içinDate.getUTCDate() Date.getUTCHours() vb. kullanın. Kullanıcının gördüğünü almak için getTimeZoneOffsetMinutes uygulayın. Değeri tarayıcının saat diliminde göstereceğinden Date.getDate(), Date.getHours() vb. kullanmayın.
Saat diliminden bağımsız ve Yalnızca tarih davranışı için, İstemci API'si sonucu tarayıcının saat diliminde bir değer olarak yorumlanmalıdır. Bununla çalışmak içinDate.getDate() Date.getHours() vb. kullanın. Date.getUTCDate(), Date.getUTCHours() vb. kullanmayın çünkü herhangi bir saat dilimi için ayarlamanız gerekmez.
Kullanıcının saat diliminde davranışını değiştirme
Yönetilen bir çözümün yayımcısı engellemediği sürece, mevcut özel tarih sütunlarının davranışını Kullanıcının Saat Diliminde yerine Yalnızca Tarih veya Saat Diliminden Bağımsız olarak değiştirebilirsiniz. Bu bir kerelik bir değişikliktir.
Sütun davranışını değiştirmek, sütun davranışı değiştirildikten sonra eklenen veya değiştirilen sütun değerlerini etkiler. Var olan sütun değerleri veritabanında UTC saat dilimi biçiminde kalır. Mevcut sütun değerlerinin davranışını UTC'den Yalnızca Tarih'e değiştirmek için, veritabanındaki mevcut tarih ve saat değerlerinin davranışını dönüştürmek üzere geliştiriciden yardım almanız gerekebilir.
Uyarı
Mevcut bir tarih ve saat sütunun davranışını değiştirmeden önce, davranışı değiştirme sonucunda hiçbir sorun oluşmayacağından emin olmak için sütunun iş kuralları, iş akışları, hesaplanan sütunlar veya toplu değer sütunları gibi tüm bağımlıkları gözden geçirmelisiniz. Tarih ve saat sütununun davranışını değiştirdikten sonra değiştirdiğiniz sütuna bağımlı her iş kuralı, iş akışı, hesaplanan sütun ve toplama sütununu açın, bilgileri gözden geçirin ve kaydedin. Böylece, tarih ve saat sütununun en son davranışı ve değeri kullanıldığından emin olabilirsiniz.
Bir çözümü alma işlemi sırasında davranışı değiştirme
Kullanıcının Saat Diliminde davranışını kullanan bir Tarih sütunu içeren bir çözümü içeri aktarırken bu davranışı Yalnızca Tarih veya Saat Diliminden Bağımsız şeklinde değiştirme seçeneğiniz olabilir.
Not
Yalnızca yayımcıysanız, mevcut bir yönetilen Yalnızca tarih veya Yalnızca Tarih ve saat sütununun davranışını değiştirebilirsiniz. Bu alanlarda değişiklik yapabilmek için Yalnıza tarih veya Tarih ve saat sütununu ekleyen çözümde yükseltme yapılması gerekir. Daha fazla bilgi: Çözümü güncelleştirme veya yükseltme
Davranış değiştirmeyi engelleme
Yönetilen bir çözümde özel bir tarih sütunu dağıtıyorsanız CanChangeDateTimeBehavior yönetilen özelliğini False şeklinde ayarlayarak çözümünüzü kullanan kişilerin davranışı değiştirmesini engelleyebilirsiniz. Daha fazla bilgi: Sütunların yönetilen özelliklerini ayarlama
Yalnızca Tarih davranışı için desteklenmeyen tarih ve saat sorgusu işleçleri
Tarih ve saat ile ilgili aşağıdaki sorgu işleçleri Yalnızca Tarih davranışı için geçersizdir. Sorguda bu işleçlerden biri kullanıldığında geçersiz işleç özel durumu hatası tetiklenir.
- X Dakikadan Daha Eski
- X Saatten Daha Eski
- Son X Saat
- Sonraki X Saat
Ayrıca bkz.
Model temelli uygulamalarda tarih ve saat sorunlarını giderme
Sütun oluşturma ve düzenleme
El ile hesaplamaları otomatikleştirmek için hesaplanan sütunları tanımlama
Yönetilen sütun özellikleri
Yönetilen özellikler
Blog: Dataverse içinde saat dilimleriyle çalışma
Kod kullananrak tarih ve saat sütunu davranışını ve biçimini yapılandırma
Not
Belge dili tercihlerinizi bizimle paylaşabilir misiniz? Kısa bir ankete katılın. (lütfen bu anketin İngilizce olduğunu unutmayın)
Anket yaklaşık yedi dakika sürecektir. Kişisel veri toplanmaz (gizlilik bildirimi).