Aracılığıyla paylaş

Standart tarih ve saat biçimi dizeleri

Standart tarih ve saat biçim dizesi, bir saat ve tarih değerinin metin gösterimini tanımlamak için biçim tanımlayıcısı olarak tek bir karakter kullanır. Boşluk da dahil olmak üzere birden fazla karakter içeren herhangi bir tarih ve saat biçim dizesi, özel tarih ve saat biçim dizesi olarak yorumlanır. Biçimlendirme işleminden kaynaklanan metin gösterimini tanımlamak için standart veya özel biçim dizesi kullanılabilir.

Biçim tanımlayıcıları tablosu

Aşağıdaki tabloda standart tarih ve saat biçimi tanımlayıcıları açıklanmaktadır.

Biçim belirteci Açıklama Örnekler
"d" Kısa Tarih Modeli

Daha fazla bilgi: Kısa tarih ("d") biçim belirticisi.		 2009-06-15T13:45:30 -> 15/6/2009 (tr-TR)

2009-06-15T13:45:30 -> 15/06/2009 (fr-FR)

2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D" Uzun tarih deseni.

Daha fazla bilgi: Uzun tarih ("D") biçim tanımlayıcısı.		 2009-06-15T13:45:30 -> Pazartesi, 15 Haziran 2009 (tr-TR)

2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU)

2009-06-15T13:45:30 -> Pazartesi, 15. Juni 2009 (de-DE)
f Tam tarih veya saat deseni (süre).

Daha fazla bilgi: Tam tarih kısa saati ("f") biçim tanımlayıcısı.		 2009-06-15T13:45:30 -> Pazartesi, 15 Haziran 2009 13:45 (EN-US)

2009-06-15T13:45:30 -> 15 Haziran 2009 13:45 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F" Tam tarih veya saat deseni (uzun süre).

Daha fazla bilgi: Tam tarih uzun saati ("F") biçim tanımlayıcısı.		 2009-06-15T13:45:30 -> 15 Haziran 2009 Pazartesi 13:45:30 (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μ (el-GR)
"g" Genel tarih veya saat deseni (süre).

Daha fazla bilgi: Genel tarih kısa saati ("g") biçim tanımlayıcısı.		 2009-06-15T13:45:30 -> 15/6/2009 13:45 (en-US)

15.06.2009T13:45:30 -> 15.06.2009 13:45 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G" Genel tarih veya saat deseni (uzun süre).

Daha fazla bilgi: Genel tarih uzun saati ("G") biçim tanımlayıcısı.		 2009-06-15T13:45:30 -> 15/6/2009 13:45:30 (EN-US)

2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES)

15.06.2009T13:45:30 -> 15.06.2009 13:45:30 (zh-CN)
"M", "m" Ay/gün deseni.

Daha fazla bilgi: Ay ("M", "m") biçim tanımlayıcısı.		 2009-06-15T13:45:30 -> 15 Haziran (tr-TR)

2009-06-15T13:45:30 -> 15. Haziran (da-DK)

2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o" gidiş dönüş tarih/saat deseni.

Daha fazla bilgi: Gidiş dönüş ("O", "o") biçim tanımlayıcısı.		 2009-06-15T13:45:30 (Yerel) --> 2009-06-15T13:45:30.0000000-07:00

2009-06-15T13:45:30 (Utc) --> 2009-06-15T13:45:30.0000000+00:00

2009-06-15T13:45:30 (Belirtilmemiş) --> 2009-06-15T13:45:30.00000000
"R", "r" Desen: RFC1123

Daha fazla bilgi: RFC1123 ("R", "r") biçim tanımlayıcısı.		 2009-06-15T13:45:30 -> Mon, 15 Haziran 2009 13:45:30 GMT
s Sıralanabilir tarih veya saat deseni.

Daha fazla bilgi: Sıralanabilir ("s") biçim tanımlayıcısı.		 2009-06-15T13:45:30 (Yerel) -> 2009-06-15T13:45:30

2009-06-15T13:45:30 (Utc) -> 2009-06-15T13:45:30
t Kısa bir süre deseni.

Daha fazla bilgi: Kısa süre ("t") biçim tanımlayıcısı.		 2009-06-15T13:45:30 -> 13:45 (en-US)

2009-06-15T13:45:30 -> 13:45 (hr-HR)

2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T" Uzun süre deseni.

Daha fazla bilgi: Uzun süre ("T") biçim tanımlayıcısı.		 2009-06-15T13:45:30 -> 1:45:30 ÖS (en-US)

2009-06-15T13:45:30 -> 13:45:30 (sa-hr)

2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u" Evrensel sıralanabilir tarih/saat deseni.

Daha fazla bilgi: Evrensel sıralanabilir ("u") biçim tanımlayıcısı.		 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z
"Y", "y" Yıl ay deseni.

Daha fazla bilgi: Yıl ayı ("Y") biçim belirticisi.		 2009-06-15T13:45:30 -> Haziran 2009 (tr-TR)

2009-06-15T13:45:30 -> Haziran 2009 (da-DK)

2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Başka bir tek karakter Bilinmeyen tanımlayıcı. Çalışma zamanı ifadesi hatası oluşturur.

Standart biçim dizeleri nasıl çalışır?

Bir biçimlendirme işleminde, standart biçim dizesi aslında bir özel biçim dizesi için diğer addır. Bir özel biçim dizesine başvururken diğer ad kullanmanın yararı, diğer ad değişmez iken özel biçim dizesinin kendisinin değişebilmesidir. Bu, tarih ve saat değerleri genellikle kültüre göre değiştiği için önemlidir. Örneğin, "d" standart biçim dizesi bir tarih ve saat değerinin kısa tarih deseni kullanılarak görüntüleneceğini belirtir. Sabit kültür için bu desen "MM/dd/yyyy" şeklindedir. fr-FR kültürü için "dd/MM/yyyy" şeklindedir. ja-JP kültürü için "yyyy/MM/dd" şeklindedir.

Eğer bir biçimlendirme işleminde standart format dizesi belirli bir kültürün özel biçim dizesiyle eşleniyorsa, uygulamanız özel biçim dizeleri aşağıdaki şekillerden birinde kullanılan belirli kültürü tanımlayabilir:

  • Varsayılan (veya geçerli( kültürü kullanabilirsiniz. Aşağıdaki örnek geçerli kültürün kısa tarih biçimini kullanarak bir tarih görüntüler. Bu durumda geçerli kültür en-US değeridir.

    let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d"])
        //Displays 3/15/2024
    }
in
    Source

  • Tarihi belirli bir kültürün kurallarına göre biçimlendirmek için kullanılan bir kültürü geçirebilirsiniz. Aşağıdaki örnek pt-BR kültürünün kısa tarih biçimini kullanarak bir tarih görüntüler.

    let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d", Culture = "pt-BR"])
        //Displays 15/03/2024
   }
in
    Source

Bazı durumlarda, standart biçim dizesi sabit olan daha uzun bir özel biçim dizesi için uygun bir kısaltma görevi görür. Dört standart biçim dizesi bu kategoriye girer: "O" (veya "o"), "R" (veya "r"), "s" ve "u". Bu dizeler sabit kültür tarafından tanımlanan özel biçim dizelerine karşılık gelir. Kültürler arası aynı olan tarih ve saat değerlerinin dize temsillerini oluştururlar. Aşağıdaki tablo bu dört standart tarih ve saat biçim dizesi hakkında bilgi verir.

Standart biçim dizeleri Tanımlandığı Özel biçim dizesi
"O" veya "o" Hiçbiri yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK
"R" ya da "r" IETF RFC 1123 belirtimi ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
s ISO 8601 yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u" Yıl, ay, gün, saat, dakika ve saniye için baştaki sıfırları kullandığından sıralanabilir yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Standart biçim dizeleri ayrıştırma işlemlerinde de kullanılabilir ve ayrıştırma işleminin başarılı olması için belirli bir desene tam olarak uyması için bir giriş dizesi gerekir. Birçok standart biçim dizesi birden çok özel biçim dizesiyle eşlendiği için tarih ve saat değeri çeşitli biçimlerde gösterilebilir ve ayrıştırma işlemi yine de başarılı olur.

Aşağıdaki bölümlerde Date, DateTime, DateTimeZone ve Time değerleri için standart biçim tanımlayıcıları açıklanmaktadır.

Tarih biçimleri

Bu grup aşağıdaki biçimleri içerir:

Kısa tarih ("d") biçim tanımlayıcısı

"d" standart biçim tanımlayıcısı, belirli bir kültür tarafından tanımlanan özel bir tarih biçimini temsil eder. Örneğin, sabit kültür tarafından döndürülen özel biçim metni "AA/gg/yyyy" şeklindedir.

Aşağıdaki örnekte bir tarih değeri görüntülemek için "d" biçim tanımlayıcısı kullanılır.

let
    Source =
    {
        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = ""]),
        // Displays 04/10/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "en-US"]),
        // Displays 4/10/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "en-NZ"]),
        // Displays 10/4/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "de-DE"])
        // Displays 10.4.2024
    }
in
    Source

Tabloya geri dön

Uzun tarih ("D") biçim tanımlayıcısı

"D" standart biçim tanımlayıcısı, belirli bir kültür tarafından tanımlanan özel bir tarih biçimini temsil eder. Örneğin, sabit kültür için özel biçim dizesi "dddd, dd MMMM yyyy" değeridir.

Aşağıdaki örnek bir tarih ve saat değerini görüntülemek için "D" biçim tanımlayıcısını kullanır.

let
    Source =
    {
        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = ""]),
        // Displays Wednesday, 10 April, 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "pt-BR"]),
        // Displays quarta-feira, 10 de abril de 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "es-MX"])
        // Displays miércoles, 10 de abril de 2024
    }
in
    Source

Tabloya geri dön

Tarih ve saat biçimleri

Bu grup aşağıdaki biçimleri içerir:

Tam tarih kısa saati ("f") biçim tanımlayıcısı

"f" standart biçim tanımlayıcısı uzun tarih ("D") ve kısa saat ("t") desenlerinin bir boşlukla ayrılarak birleştirilmiş şeklini temsil eder.

Sonuç dizesi, belirli bir kültürün biçimlendirme bilgilerinden etkilenir.

Aşağıdaki örnek bir tarih ve saat değerini görüntülemek için "f" biçim tanımlayıcısını kullanır.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "f", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "f", Culture = "fr-FR"])
        // Displays mercredi 10 avril 2024 06:30
    }
in
    Source

Tabloya geri dön

Tam tarih uzun saati ("F") biçim tanımlayıcısı

"F" standart biçim tanımlayıcısı, belirli bir kültür tarafından tanımlanan özel bir tarih ve saat biçimini temsil eder. Örneğin, sabit kültür için özel biçim dizesi "dddd, dd MMMM yyyy HH:mm:ss" değeridir.

Sonuç dizesi, belirli bir kültürün biçimlendirme bilgilerinden etkilenir.

Aşağıdaki örnek bir tarih ve saat değerini görüntülemek için "F" biçim tanımlayıcısını kullanır.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = ""]),
        // Displays Wednesday, 10 April, 2024 06:30:00

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = "fr-FR"])
        // Displays mercredi 10 avril 2024 06:30:00
    }
in
    Source

Tabloya geri dön

Genel tarih kısa saati ("g") biçim tanımlayıcısı

"g" standart biçim tanımlayıcısı kısa tarih ("d") ve kısa saat ("t") desenlerinin bir boşlukla ayrılarak birleştirilmiş şeklini temsil eder. Sonuçta elde edilen metin, belirli bir kültürün biçimlendirme bilgilerinden etkilenir.

Sonuç dizesi, belirli bir kültürün biçimlendirme bilgilerinden etkilenir.

Aşağıdaki örnek bir tarih ve saat değerini görüntülemek için "g" biçim tanımlayıcısını kullanır.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = ""]),
        // Displays 04/10/2024 06:30

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = "en-US"]),
        // Displays 4/10/2024 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = "fr-BE"])
        // Displays 10-04-24 06:30
    }
in
    Source

Tabloya geri dön

Genel tarih uzun saati ("G") biçim tanımlayıcısı

"G" standart biçim tanımlayıcısı kısa tarih ("d") ve uzun saat ("T") desenlerinin bir boşlukla ayrılarak birleştirilmiş şeklini temsil eder. Sonuçta elde edilen metin, belirli bir kültürün biçimlendirme bilgilerinden etkilenir.

Sonuç dizesi, belirli bir kültürün biçimlendirme bilgilerinden etkilenir.

Aşağıdaki örnek bir tarih ve saat değerini görüntülemek için "G" biçim tanımlayıcısını kullanır.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = ""]),
        // Displays 04/10/2024 06:30:00

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = "en-US"]),
        // Displays 4/10/2024 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = "nl-BE"])
        // Displays 10/04/2024 6:30:00
    }
in
    Source

Tabloya geri dön

Gidiş dönüş ("O", "o") biçim tanımlayıcısı

"O" veya "o" standart biçim tanımlayıcısı, saat dilimi bilgilerini koruyan ve ISO 8601'e uygun bir sonuç dizesi yayan bir desen kullanan özel bir tarih ve saat biçimi dizesini temsil eder. DateTimeZone değerleri için, bu biçim belirtici metindeki tarih, saat ve saat dilimi değerlerini korumak üzere tasarlanmıştır.

"O" veya "o" standart biçim tanımlayıcısı "yyyy'-'MM'-'dd'T'HH':'mm':'ss'' öğesine karşılık gelir. fffffffxxx" DateTimeZone değerleri için özel biçim dizesi. Bu metinde, tireler, iki nokta üst üste ve "T" harfi gibi tek tek karakterleri sınırlandıran tek tırnak işaretleri çiftleri, tek tek karakterin değiştirilemeyen bir değişmez değer olduğunu gösterir. Kesme işaretleri çıkış dizesinde görünmez.

"O" veya "o" standart biçim tanımlayıcısı (ve "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffxxx" özel biçimi), ISO 8601'in DateTimeZone değerlerini korumak için saat dilimi bilgilerini temsil etme yollarından yararlanır:

  • DateTimeZone.ToLocal tarih ve saat değerlerinin saat dilimi bileşeni UTC'den uzaklıktır (örneğin, +01:00, -07:00).

  • DateTimeZone.ToUtc tarih ve saat değerlerinin saat dilimi bileşeni UTC'yi temsil etmek için +00,00 kullanır.

"O" veya "o" standart biçim tanımlayıcısı uluslararası bir standarda uygun olduğundan, tanımlayıcıyı kullanan biçimlendirme veya ayrıştırma işlemi her zaman sabit kültürü ve Gregoryen takvimi kullanır.

Aşağıdaki örnek, ABD Pasifik Saat dilimindeki bir sistemde bir dizi DateTimeZone değeri görüntülemek için "o" biçim tanımlayıcısını kullanır.

let
    date1 = #datetimezone(2024, 6, 15, 13, 45, 30, 0, 0),
    Source =
    {
        Text.Format("#{0} (Unspecified) --> #{1}", {date1, DateTimeZone.ToText(date1, [Format = "O"])}),
        Text.Format("#{0} (Utc) --> #{1}", {date1, DateTimeZone.ToText(DateTimeZone.ToUtc(date1), [Format = "O"])}),
        Text.Format("#{0} (Local) --> #{1}", {date1, DateTimeZone.ToText(DateTimeZone.ToLocal(date1), [Format = "O"])})
    }
in
    Source

// The example displays the following output:
//    6/15/2024 1:45:30 PM +00:00 (Unspecified) --> 2024-06-15T13:45:30.0000000+00:00
//    6/15/2024 1:45:30 PM +00:00 (Utc) --> 2024-06-15T13:45:30.0000000+00:00
//    6/15/2024 1:45:30 PM +00:00 (Local) --> 2024-06-15T08:45:30.0000000-07:00

Not

DateTimeZone.ToLocal tarafından döndürülen değer, Power Query'yi yerel bir makinede mi yoksa çevrimiçi mi çalıştırdığınıza bağlıdır. Örneğin, ABD Pasifik Saat dilimindeki bir sistemde yukarıdaki örnekte Power Query Desktop, yerel makinenizde ayarlanan saati okuduğundan Yerel-07:00döndürür. Ancak Power Query Online, utc olarak ayarlanmış bulut sanal makinelerinde ayarlanan süreyi okuduğundan döndürür +00:00 .

Aşağıdaki örnek, biçimlendirilmiş bir dize oluşturmak için "o" biçim tanımlayıcısını kullanır ve ardından bir tarih ve saat ayrıştırma yordamı çağırarak özgün tarih ve saat değerini geri yükler.

let
    // Round-trip a local time
    #"Origin Local Date" = DateTimeZone.ToLocal(
        #datetimezone(2024, 4, 10, 6, 30, 0, 0, 0)
    ),
    #"Local Date Text" = DateTimeZone.ToText(
        #"Origin Local Date", [Format = "o"]
    ),
    #"New Local Date" = DateTimeZone.FromText(#"Local Date Text"),
    #"Local Round Trip" = Text.Format(
        "Round-tripped #{0} Local to #{1} Local.", 
        {
            DateTimeZone.ToText(#"Origin Local Date"), 
            DateTimeZone.ToText(#"New Local Date")
        }
    ),

    // Round-trip a UTC time
    #"Origin UTC Date" = DateTimeZone.ToUtc(
        #datetimezone(2024, 4, 12, 9, 30, 0, 0, 0)
    ),
    #"UTC Date Text" = DateTimeZone.ToText(
        #"Origin UTC Date", [Format = "o"]
    ),
    #"New UTC Date" = DateTimeZone.FromText(#"UTC Date Text"),
    #"UTC Round Trip" = Text.Format(
        "Round-tripped #{0} UTC to #{1} UTC.", 
        {
            DateTimeZone.ToText(#"Origin UTC Date"), 
            DateTimeZone.ToText(#"New UTC Date")
        }
    ),

    // Round-trip an 18 hour offset time
    #"Origin Offset Date" = DateTimeZone.ToLocal(
        #datetimezone(2024, 4, 10, 6, 30, 0, 0, 0) + #duration(0, 18, 0, 0)
    ),
    #"Offset Date Text" = DateTimeZone.ToText(
        #"Origin Offset Date", [Format = "o"]
    ),
    #"New Offset Date" = DateTimeZone.FromText(#"Offset Date Text"),
    #"Offset Round Trip" = Text.Format(
        "Round-tripped #{0} to #{1}.", 
        {
            DateTimeZone.ToText(#"Origin Offset Date"), 
            DateTimeZone.ToText(#"New Offset Date")
        }
    ),

    #"Round Trip Results" = 
        {#"Local Round Trip", #"UTC Round Trip", #"Offset Round Trip"}
in
    #"Round Trip Results"

// The example displays the following output in Power Query Desktop:
//    Round-tripped 4/9/2024 11:30:00 PM -07:00 Local to 4/9/2024 11:30:00 PM -07:00 Local.
//    Round-tripped 4/12/2024 9:30:00 AM +00:00 UTC to 4/12/2024 9:30:00 AM +00:00 UTC.
//    Round-tripped 4/10/2024 5:30:00 PM -07:00 to 4/10/2024 5:30:00 PM -07:00.

// The example displays the following output in Power Query Online:
//    Round-tripped 4/10/2024 6:30:00 AM +00:00 Local to 4/10/2024 6:30:00 AM +00:00 Local.
//    Round-tripped 4/12/2024 9:30:00 AM +00:00 UTC to 4/12/2024 9:30:00 AM +00:00 UTC.
//    Round-tripped 4/11/2024 12:30:00 AM +00:00 to 4/11/2024 12:30:00 AM +00:00.

Tabloya geri dön

RFC1123 ("R", "r") biçim tanımlayıcısı

"R" veya "r" standart biçim tanımlayıcısı, belirli bir kültür tarafından tanımlanmayan özel bir tarih ve saat biçimi dizesini temsil eder. Kullanılan kültürden veya sağlanan biçim sağlayıcısından bağımsız olarak her zaman aynıdır. Özel biçim dizesi "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'" değeridir. Bu standart biçim tanımlayıcısı kullanıldığında biçimlendirme ve ayrıştırma işlemi her zaman sabit kültürü kullanır.

RFC 1123 standardı bir saati Eşgüdümlü Evrensel Saat (UTC) olarak ifade etmesine rağmen, biçimlendirme işlemi biçimlendirilmekte olan tarih ve saatin değerini değiştirmez. Bu nedenle, biçimlendirme işlemini gerçekleştirmeden önce DateTimeZone.ToUtc işlev yöntemini çağırarak DateTime değerini UTC'ye dönüştürmeniz gerekir.

Aşağıdaki örnek, ABD Pasifik Saat Dilimindeki bir sistemde saat ve tarih değerini (UTC'nin yedi saat gerisinde) görüntülemek için "r" biçim tanımlayıcısını kullanır.

let
    date1 = #datetimezone(2024, 4, 10, 6, 30, 0, -7, 0),
    dateOffset = DateTimeZone.ToUtc(date1),
    Source = 
    {
        DateTimeZone.ToText(date1, [Format = "r"]),
        // Displays Wed, 10 Apr 2024 13:30:00 GMT

        DateTimeZone.ToText(dateOffset, [Format = "r"])
        // Displays Wed, 10 Apr 2024 13:30:00 GMT
    }
in
    Source

Tabloya geri dön

Sıralanabilir ("s") biçim tanımlayıcısı

"s" standart biçim tanımlayıcısı, tanımlı bir standardı (ISO 8601) yansıtan ve salt okunur olan özel bir tarih ve saat biçimi dizesini temsil eder. Bu nedenle, kullanılan kültür veya sağlanan biçim sağlayıcısından bağımsız olarak her zaman aynıdır. Özel biçim dizesi "yyyy'-'MM'-'dd'T'HH':'mm':'ss" değeridir. "s" biçim tanımlayıcısının amacı, tarih ve saat değerlerine göre tutarlı olarak artan veya azalan düzende sıralayan sonuç dizeleri üretmektir.

Bu standart biçim tanımlayıcısı kullanıldığında biçimlendirme ve ayrıştırma işlemi her zaman sabit kültürü kullanır.

Aşağıdaki örnek, ABD Pasifik Saat dilimindeki bir sistemde tarih ve saat değerini görüntülemek için "s" biçim tanımlayıcısını kullanır.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "s", Culture = "en-US"])
        // Displays 2024-04-10T06:30:00
    }
in
    Source

Tabloya geri dön

Evrensel sıralanabilir ("u") biçim tanımlayıcısı

"u" standart biçim tanımlayıcısı, kullanılan kültürden veya sağlanan biçim sağlayıcısından bağımsız olarak her zaman aynı olan özel bir tarih ve saat biçim dizesini temsil eder. Özel biçim dizesi "yyyy'-'MM'-'dd HH':'mm':'ss'Z'" değeridir. Desen tanımlı bir standardı yansıtır ve özellik salt okunurdur. Bu standart biçim tanımlayıcısı kullanıldığında biçimlendirme ve ayrıştırma işlemi her zaman sabit kültürü kullanır.

Sonuç dizesi bir saati Eşgüdümlü Evrensel Saat (UTC) olarak ifade etmelidir ancak biçimlendirme işlemi sırasında özgün DateTimeZone değerini dönüştürme işlemi yapılmaz. Bu nedenle, DateTimeZone değerini biçimlendirmeden önce DateTimeZone.ToUtc işlevini çağırarak UTC'ye dönüştürmeniz gerekir.

Aşağıdaki örnek bir tarih ve saat değerini görüntülemek için "u" biçim tanımlayıcısını kullanır.

let
    date1 = #datetimezone(2024, 4, 10, 6, 30, 0, -7, 0),
    dateOffset = DateTimeZone.ToUtc(date1),
    Source =
    {
        DateTimeZone.ToText(dateOffset, [Format = "u"]),
        // Displays 2024-04-10 13:30:00Z
    }
in
    Source

Tabloya geri dön

Saat biçimleri

Bu grup aşağıdaki biçimleri içerir:

Kısa süre ("t") biçim tanımlayıcısı

"t" standart biçim tanımlayıcısı, belirtilen kültür tarafından tanımlanan özel bir tarih ve saat biçimi dizesini temsil eder. Örneğin, sabit kültür için özel biçim dizesi "HH:mm" değeridir.

Sonuç dizesi, belirli bir kültürün biçimlendirme bilgilerinden etkilenir.

Aşağıdaki örnek bir tarih ve saat değerini görüntülemek için "t" biçim tanımlayıcısını kullanır.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = ""]),
        // Displays 06:30
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = "en-US"]),
        // Displays 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = "es-ES"])
        // Displays 6:30
    }
in
    Source

Tabloya geri dön

Uzun süre ("T") biçim tanımlayıcısı

"T" standart biçim tanımlayıcısı, belirli bir kültür tarafından tanımlanan özel bir tarih ve saat biçimi dizesini temsil eder. Örneğin, sabit kültür için özel biçim dizesi "HH:mm:ss" değeridir.

Aşağıdaki örnek bir tarih ve saat değerini görüntülemek için "T" biçim tanımlayıcısını kullanır.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = ""]),
        // Displays 06:30:00
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = "en-US"]),
        // Displays 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = "es-ES"])
        // Displays 6:30:00
    }
in
    Source

Tabloya geri dön

Kısmi tarih biçimleri

Bu grup aşağıdaki biçimleri içerir:

Ay ("M", "m") biçim tanımlayıcısı

"M" veya "m" standart biçim tanımlayıcısı, belirli bir kültür tarafından tanımlanan özel bir tarih ve saat biçimi dizesini temsil eder. Örneğin, sabit kültür için özel biçim dizesi "MMMM dd" değeridir.

Aşağıdaki örnek bir tarih ve saat değerini görüntülemek için "m" biçim tanımlayıcısını kullanır.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = ""]),
        // Displays April 10
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = "en-US"]),
        // Displays April 10

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = "ms-MY"])
        // Displays 10 April
    }
in
    Source

Tabloya geri dön

Yıl ayı ("Y", "y") biçim tanımlayıcısı

"Y" veya "y" standart biçim tanımlayıcısı, belirli bir kültür tarafından tanımlanan özel bir tarih biçimi dizesini temsil eder. Örneğin, sabit kültür için özel biçim dizesi "yyyy MMMM" değeridir.

Aşağıdaki örnek bir tarih ve saat değerini görüntülemek için "y" biçim tanımlayıcısını kullanır.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "Y", Culture = ""]),
        // Displays 2024 April
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "Y", Culture = "en-US"]),
        // Displays April 2024

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "y", Culture = "af-ZA"])
        // Displays April 2024
    }
in
    Source

Tabloya geri dön

İlgili içerik

  • Last updated on