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.

Çoğu sütunda kullanılabilen standart özelliklere ek olarak, tarih ve saat sütunları iki ek özelliğe sahiptir:

• Saat dilimi ayarlaması: Saat dilimleri için değerlerin ayarlanıp ayarlanmayacağı.
• Biçim: Değerin saat bölümünün görüntülenip görüntülenmeyeceği.

Saat dilimi ayarlaması

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, Tarih ve saat biçimi için 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. Bu, Yalnızca Tarih biçimi için varsayılan davranıştır.

Windows, Android, iOS veya macOS'ta sistem saat dilimini değil, kullanıcının saat dilimini kişisel seçeneklerle ayarlayın. Bununla birlikte, sistem saat dilimi JavaScript Tarihleriyle çalışan istemci komut dosyalarını etkileyebilir.

Biçim

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.

Uyarı

BiçimYalnızca Tarih olduğunda kullanıcılar saat bölümünü değiştirebilir. Örneğin, Web API çağrılarını kullanarak veya zaman bölümüne sahip bir denetim kullanarak. Bu davranış, saat bölümünün hiç depolanmadığı Yalnızca TarihDavranışından farklıdır.

Kullanım yönergeleri

Saat dilimi bilgisi gerekli olmadığında (örneğin, otel giriş saatleri gibi) saat dilimi bağımsız kullanın. Bu seçimle tüm saat dilimlerindeki kullanıcılar aynı tarih ve saat değerini görür.

Tarih'i yalnızca doğum günleri veya yıldönümleri gibi günün saati ve saat dilimiyle ilgili bilgiler gerekli olmadığında kullanın. Bu seçimle tüm saat dilimlerindeki kullanıcılar tam olarak aynı tarih değerini görür.

Yalnızca Tarih ile bağımsız saat dilimi, sütunu yalnızca Tarih olarak ayarlamakla hemen hemen 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 temelli bir uygulamada tarih belirlediğinde, saat bölümü otomatik olarak saat diliminin gece yarısına ayarlar. 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 2023-10-15 davranışı için ). UTC-8 Saat dilimindeki kullanıcılar model temelli uygulamada veya biçimlendirilmiş değer için Web API'si isteği ile bunları görürler:

Davranış	Biçim	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çim	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çim	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'te saat 02:00'de başladı ve saati bir saat ileri 03:00'e taşıdı. İ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'te saat 02:00'de sona erer ve saati bir saat geriye doğru 1:00'e taşı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 2023-10-15 davranışı için ). Tüm saat dilimlerindeki kullanıcılar bu değerleri şu değer için bir Web API isteğiyle alır:

Davranış	Biçim	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çim	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çim	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çim	Javascript dateValue.toString()
Yalnızca tarih	-	2023-10-15 00:00 (tarayıcı saat dilimi)

Uyarı

JavaScript tarih değerleri, tarayıcının cihaz işletim sistemi ayarlarından gelen saat diliminden etkilenir.

Kullanıcı yerel davranışı için İstemci API'sinin sonucunu UTC değeri olarak yorumla. Date.getUTCDate() veya Date.getUTCHours() kullanarak çalışabilirsiniz. Kullanıcının gördüğünü almak için getTimeZoneOffsetMinutes uygulayın. Veya kullanmayın Date.getDate()Date.getHours() çünkü bu işlevler tarayıcının saat dilimindeki değeri gösterir.

Saat diliminden bağımsız ve Yalnızca tarih davranışı için İstemci API'sinin sonucunu tarayıcının saat diliminde bir değer olarak yorumla. Date.getDate() veya Date.getHours() kullanarak çalışabilirsiniz. Date.getUTCDate() veya Date.getUTCHours() kullanmayın çünkü herhangi bir saat dilimi için ayarlama yapmak zorunda değilsiniz.

Kullanıcının saat diliminde davranışını değiştirme

Yönetilen çözümün yayımcısı yerel davranışı değiştirmeyi engellemediği sürece, mevcut özel tarih sütunlarının davranışını Yalnızca Kullanıcı yerel 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ütununun davranışını değiştirmeden önce, davranışı değiştirmenin bir sonucu olarak sorun olmadığından emin olmak için iş kuralları, iş akışları, hesaplanmış sütunlar veya toplama sütunları gibi sütunun tüm bağımlılıklarını gözden geçirin. 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

User local ile Date sütunu içeren bir çözümü içeri aktardığınızda, davranışı Yalnızca Tarih veya Saat diliminden bağımsız olarak değiştirebilirsiniz.

Uyarı

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ü yükseltme veya güncelleştirme

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 saaten Daha Eski
• Son X Saat
• Sonraki X Saat

Ayrıca bkz.

Model temelli uygulamalarda tarih ve saat sorunlarını giderme
Sütunları oluştur ve düzenle
El ile hesaplamaları otomatikleştirmek için hesaplanan sütunları tanımlama
Yönetilen sütun özellikleri
Yönetilen Özellikler
Blog: Dataverse'te saat dilimleriyle çalışma
Kod kullanarak tarih ve saat sütunu davranışını ve biçimini yapılandırma