Standart TimeSpan Biçim dizeleriStandard TimeSpan format strings

Standart TimeSpan biçim dizesi, biçimlendirme işleminden kaynaklanan bir TimeSpan değerinin metin temsilini tanımlamak için tek bir biçim belirticisi kullanır.A standard TimeSpan format string uses a single format specifier to define the text representation of a TimeSpan value that results from a formatting operation. Boşluk da dahil olmak üzere birden fazla karakter içeren herhangi bir biçim dizesi, özel bir TimeSpan biçim dizesi olarak yorumlanır.Any format string that contains more than one character, including white space, is interpreted as a custom TimeSpan format string. Daha fazla bilgi için bkz. Özel TimeSpan Biçim dizeleri .For more information, see Custom TimeSpan format strings .

TimeSpan değerlerinin dize temsilleri, TimeSpan.ToString yönteminin aşırı yüklemelerinin yanı sıra String.Formatgibi bileşik biçimlendirmeyi destekleyen yöntemler tarafından üretilir.The string representations of TimeSpan values are produced by calls to the overloads of the TimeSpan.ToString method, as well as by methods that support composite formatting, such as String.Format. Daha fazla bilgi için bkz. biçimlendirme türleri ve Bileşik biçimlendirme.For more information, see Formatting Types and Composite Formatting. Aşağıdaki örnek biçimlendirme işlemlerinde standart biçim dizelerinin kullanımını gösterir.The following example illustrates the use of standard format strings in formatting operations.

using System;

public class Example
{
   public static void Main()
   {
      TimeSpan duration = new TimeSpan(1, 12, 23, 62);
      string output = "Time of Travel: " + duration.ToString("c");
      Console.WriteLine(output);
      
      Console.WriteLine("Time of Travel: {0:c}", duration); 
   }
}
// The example displays the following output:
//       Time of Travel: 1.12:24:02
//       Time of Travel: 1.12:24:02
Module Example
   Public Sub Main()
      Dim duration As New TimeSpan(1, 12, 23, 62)
      Dim output As String = "Time of Travel: " + duration.ToString("c")
      Console.WriteLine(output)
      
      Console.WriteLine("Time of Travel: {0:c}", duration) 
   End Sub
End Module
' The example displays the following output:
'       Time of Travel: 1.12:24:02
'       Time of Travel: 1.12:24:02

Standart TimeSpan biçim dizeleri, TimeSpan.ParseExact ve TimeSpan.TryParseExact yöntemleri tarafından, ayrıştırma işlemleri için gereken giriş dizeleri biçimini tanımlamak için de kullanılır.Standard TimeSpan format strings are also used by the TimeSpan.ParseExact and TimeSpan.TryParseExact methods to define the required format of input strings for parsing operations. (Ayrıştırma bir değerin dize temsilini bu değere dönüştürür.) Aşağıdaki örnek, ayrıştırma işlemlerinde standart biçim dizelerinin kullanımını gösterir.(Parsing converts the string representation of a value to that value.) The following example illustrates the use of standard format strings in parsing operations.

using System;

public class Example
{
   public static void Main()
   {
      string value = "1.03:14:56.1667";
      TimeSpan interval;
      try {
         interval = TimeSpan.ParseExact(value, "c", null);
         Console.WriteLine("Converted '{0}' to {1}", value, interval);
      }   
      catch (FormatException) {
         Console.WriteLine("{0}: Bad Format", value);
      }   
      catch (OverflowException) {
         Console.WriteLine("{0}: Out of Range", value);
      }
      
      if (TimeSpan.TryParseExact(value, "c", null, out interval))
         Console.WriteLine("Converted '{0}' to {1}", value, interval);
      else
         Console.WriteLine("Unable to convert {0} to a time interval.", 
                           value);
   }
}
// The example displays the following output:
//       Converted '1.03:14:56.1667' to 1.03:14:56.1667000
//       Converted '1.03:14:56.1667' to 1.03:14:56.1667000
Module Example
   Public Sub Main()
      Dim value As String = "1.03:14:56.1667"
      Dim interval As TimeSpan
      Try
         interval = TimeSpan.ParseExact(value, "c", Nothing)
         Console.WriteLine("Converted '{0}' to {1}", value, interval)
      Catch e As FormatException
         Console.WriteLine("{0}: Bad Format", value)
      Catch e As OverflowException
         Console.WriteLine("{0}: Out of Range", value)
      End Try
      
      If TimeSpan.TryParseExact(value, "c", Nothing, interval) Then
         Console.WriteLine("Converted '{0}' to {1}", value, interval)
      Else
         Console.WriteLine("Unable to convert {0} to a time interval.", 
                           value)
      End If                
   End Sub
End Module
' The example displays the following output:
'       Converted '1.03:14:56.1667' to 1.03:14:56.1667000
'       Converted '1.03:14:56.1667' to 1.03:14:56.1667000

Aşağıdaki tabloda standart zaman aralığı biçim belirticileri listelenmektedir.The following table lists the standard time interval format specifiers.

Biçim belirteciFormat specifier NameName AçıklamaDescription ÖrneklerExamples
,"c" Sabit (Sabit) biçimConstant (invariant) format Bu tanımlayıcı kültüre duyarlı değildir.This specifier is not culture-sensitive. [-][d'.']hh':'mm':'ss['.'fffffff]formu alır.It takes the form [-][d'.']hh':'mm':'ss['.'fffffff].

("T" ve "T" biçim dizeleri aynı sonuçları üretir.)(The "t" and "T" format strings produce the same results.)

Daha fazla bilgi: sabit ("c") Biçim belirleyicisi.More information: The Constant ("c") Format Specifier.
TimeSpan.Zero -> 00:00:00TimeSpan.Zero -> 00:00:00

New TimeSpan(0, 0, 30, 0) -> 00:30:00New TimeSpan(0, 0, 30, 0) -> 00:30:00

New TimeSpan(3, 17, 25, 30, 500) -> 3.17:25:30.5000000New TimeSpan(3, 17, 25, 30, 500) -> 3.17:25:30.5000000
"g""g" Genel kısa biçimGeneral short format Bu belirtici yalnızca gerekli olanları verir.This specifier outputs only what is needed. Kültüre duyarlıdır ve [-][d':']h':'mm':'ss[.FFFFFFF]formu alır.It is culture-sensitive and takes the form [-][d':']h':'mm':'ss[.FFFFFFF].

Daha fazla bilgi: genel kısa ("g") Biçim belirleyicisi.More information: The General Short ("g") Format Specifier.
New TimeSpan(1, 3, 16, 50, 500)-> 1:3: 16:50.5 (en-US)New TimeSpan(1, 3, 16, 50, 500) -> 1:3:16:50.5 (en-US)

New TimeSpan(1, 3, 16, 50, 500)-> 1:3: 16:50, 5 (fr-FR)New TimeSpan(1, 3, 16, 50, 500) -> 1:3:16:50,5 (fr-FR)

New TimeSpan(1, 3, 16, 50, 599)-> 1:3: 16:50.599 (en-US)New TimeSpan(1, 3, 16, 50, 599) -> 1:3:16:50.599 (en-US)

New TimeSpan(1, 3, 16, 50, 599)-> 1:3: 16:50599 (fr-FR)New TimeSpan(1, 3, 16, 50, 599) -> 1:3:16:50,599 (fr-FR)
"G""G" Genel uzun biçimGeneral long format Bu belirtici her zaman gün ve yedi kesirli basamak verir.This specifier always outputs days and seven fractional digits. Kültüre duyarlıdır ve [-]d':'hh':'mm':'ss.fffffffformu alır.It is culture-sensitive and takes the form [-]d':'hh':'mm':'ss.fffffff.

Daha fazla bilgi: genel uzun ("G") Biçim belirleyicisi.More information: The General Long ("G") Format Specifier.
New TimeSpan(18, 30, 0)-> 0:18:30:00.0000000 (en-US)New TimeSpan(18, 30, 0) -> 0:18:30:00.0000000 (en-US)

New TimeSpan(18, 30, 0)-> 0:18:30:00, 0000000 (fr-FR)New TimeSpan(18, 30, 0) -> 0:18:30:00,0000000 (fr-FR)

Sabit ("c") Biçim belirleyicisiThe Constant ("c") Format Specifier

"C" biçim belirticisi aşağıdaki biçimde bir TimeSpan değerin dize gösterimini döndürür:The "c" format specifier returns the string representation of a TimeSpan value in the following form:

[-] [d.] SS:dd:SS[. fffffff][-][d.]hh:mm:ss[.fffffff]

Köşeli ayraçlar ([ve]) içindeki öğeler isteğe bağlıdır.Elements in square brackets ([ and ]) are optional. Nokta (.) ve iki nokta (:) değişmez simgeler.The period (.) and colon (:) are literal symbols. Aşağıdaki tabloda kalan öğeler açıklanmaktadır.The following table describes the remaining elements.

ÖğeElement AçıklamaDescription
- Negatif bir zaman aralığını belirten isteğe bağlı bir eksi işareti.An optional negative sign, which indicates a negative time interval.
dd Önünde sıfır olmayan, isteğe bağlı gün sayısı.The optional number of days, with no leading zeros.
hhhh "00" ile "23" arasında değişen saat sayısı.The number of hours, which ranges from "00" to "23".
mmmm "00" ile "59" arasında değişen dakika sayısı.The number of minutes, which ranges from "00" to "59".
ssss "0" ile "59" arasında değişen saniye sayısı.The number of seconds, which ranges from "0" to "59".
ffffffffffffff Saniyenin isteğe bağlı kesirli kısmı.The optional fractional portion of a second. Değeri "0000001" (bir Tick veya saniyenin 1 10-milimetre Onth) arasında "9999999" (9.999.999 10-milionon saniyenin veya bir saniyeden daha az bir değer) arasında değişebilir.Its value can range from "0000001" (one tick, or one ten-millionth of a second) to "9999999" (9,999,999 ten-millionths of a second, or one second less one tick).

"G" ve "G" biçim Belirticilerinin aksine, "c" Biçim belirleyicisi kültüre duyarlı değildir.Unlike the "g" and "G" format specifiers, the "c" format specifier is not culture-sensitive. Bu, sabit bir TimeSpan değerin dize gösterimini üretir ve bu, .NET Framework 4 ' den önce .NET Framework önceki tüm sürümleri için ortaktır.It produces the string representation of a TimeSpan value that is invariant and that is common to all previous versions of the .NET Framework before the .NET Framework 4. "c", varsayılan TimeSpan biçim dizesidir; TimeSpan.ToString() yöntemi, "c" biçim dizesini kullanarak bir zaman aralığı değeri biçimlendirir."c" is the default TimeSpan format string; the TimeSpan.ToString() method formats a time interval value by using the "c" format string.

Not

TimeSpan Ayrıca "c" standart biçim dizesiyle aynı davranışa benzer olan "t" ve "T" standart biçim dizelerini de destekler.TimeSpan also supports the "t" and "T" standard format strings, which are identical in behavior to the "c" standard format string.

Aşağıdaki örnek iki TimeSpan nesnesini örneklemektedir, aritmetik işlemler gerçekleştirmek için bunları kullanır ve sonucu görüntüler.The following example instantiates two TimeSpan objects, uses them to perform arithmetic operations, and displays the result. Her durumda, "c" biçim belirticisini kullanarak TimeSpan değerini göstermek için bileşik biçimlendirme kullanır.In each case, it uses composite formatting to display the TimeSpan value by using the "c" format specifier.

using System;

public class Example
{
   public static void Main()
   {
      TimeSpan interval1, interval2;
      interval1 = new TimeSpan(7, 45, 16);
      interval2 = new TimeSpan(18, 12, 38);
      
      Console.WriteLine("{0:c} - {1:c} = {2:c}", interval1, 
                        interval2, interval1 - interval2);
      Console.WriteLine("{0:c} + {1:c} = {2:c}", interval1, 
                        interval2, interval1 + interval2);
      
      interval1 = new TimeSpan(0, 0, 1, 14, 365);
      interval2 = TimeSpan.FromTicks(2143756);  
      Console.WriteLine("{0:c} + {1:c} = {2:c}", interval1, 
                        interval2, interval1 + interval2);
   }
}
// The example displays the following output:
//       07:45:16 - 18:12:38 = -10:27:22
//       07:45:16 + 18:12:38 = 1.01:57:54
//       00:01:14.3650000 + 00:00:00.2143756 = 00:01:14.5793756
Module Example
   Public Sub Main()
      Dim interval1, interval2 As TimeSpan
      interval1 = New TimeSpan(7, 45, 16)
      interval2 = New TimeSpan(18, 12, 38)
      
      Console.WriteLine("{0:c} - {1:c} = {2:c}", interval1, 
                        interval2, interval1 - interval2)
      Console.WriteLine("{0:c} + {1:c} = {2:c}", interval1, 
                        interval2, interval1 + interval2)
      
      interval1 = New TimeSpan(0, 0, 1, 14, 365)
      interval2 = TimeSpan.FromTicks(2143756)      
      Console.WriteLine("{0:c} + {1:c} = {2:c}", interval1, 
                        interval2, interval1 + interval2)
   End Sub
End Module
' The example displays the following output:
'       07:45:16 - 18:12:38 = -10:27:22
'       07:45:16 + 18:12:38 = 1.01:57:54
'       00:01:14.3650000 + 00:00:00.2143756 = 00:01:14.5793756

Genel kısa ("g") Biçim belirleyicisiThe General Short ("g") Format Specifier

"G" TimeSpan Biçim Belirleyicisi, yalnızca gerekli öğeleri ekleyerek bir TimeSpan değerin dize gösterimini bir kompakt biçimde döndürür.The "g" TimeSpan format specifier returns the string representation of a TimeSpan value in a compact form by including only the elements that are necessary. Aşağıdaki biçimdedir:It has the following form:

[-] [d:] h:mm:SS[. FFFFFFF][-][d:]h:mm:ss[.FFFFFFF]

Köşeli ayraçlar ([ve]) içindeki öğeler isteğe bağlıdır.Elements in square brackets ([ and ]) are optional. İki nokta (:) sabit bir simgedir.The colon (:) is a literal symbol. Aşağıdaki tabloda kalan öğeler açıklanmaktadır.The following table describes the remaining elements.

ÖğeElement AçıklamaDescription
- Negatif bir zaman aralığını belirten isteğe bağlı bir eksi işareti.An optional negative sign, which indicates a negative time interval.
dd Önünde sıfır olmayan, isteğe bağlı gün sayısı.The optional number of days, with no leading zeros.
hh "0" ile "23" arasında, önünde sıfır olmadan değişen saat sayısı.The number of hours, which ranges from "0" to "23", with no leading zeros.
mmmm "00" ile "59" arasında değişen dakika sayısı..The number of minutes, which ranges from "00" to "59"..
ssss "00" ile "59" arasında değişen saniye sayısı..The number of seconds, which ranges from "00" to "59"..
.. Kesirli saniye ayırıcısı.The fractional seconds separator. Kullanıcı geçersiz kılmaları olmadan belirtilen kültürün NumberDecimalSeparator özelliğine eşdeğerdir.It is equivalent to the specified culture's NumberDecimalSeparator property without user overrides.
FFFFFFFFFFFFFF Kesirli saniyeler.The fractional seconds. Olabildiğince az basamak görüntülenir.As few digits as possible are displayed.

"G" biçim belirticisi gibi, "g" biçim belirticisi yerelleştirilmiştir.Like the "G" format specifier, the "g" format specifier is localized. Kesirli saniye ayırıcısı, geçerli kültürü veya belirtilen kültürün NumberDecimalSeparator özelliğini temel alır.Its fractional seconds separator is based on either the current culture or a specified culture's NumberDecimalSeparator property.

Aşağıdaki örnek iki TimeSpan nesnesini örneklemektedir, aritmetik işlemler gerçekleştirmek için bunları kullanır ve sonucu görüntüler.The following example instantiates two TimeSpan objects, uses them to perform arithmetic operations, and displays the result. Her durumda, "g" biçim belirticisini kullanarak TimeSpan değerini göstermek için bileşik biçimlendirme kullanır.In each case, it uses composite formatting to display the TimeSpan value by using the "g" format specifier. Ayrıca, geçerli sistem kültürünün (Bu örnekte, Ingilizce-Birleşik Devletler veya en-US) ve Fransızca-Fransa (fr-FR) kültürüne ait biçimlendirme kurallarını kullanarak TimeSpan değerini biçimlendirir.In addition, it formats the TimeSpan value by using the formatting conventions of the current system culture (which, in this case, is English - United States or en-US) and the French - France (fr-FR) culture.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      TimeSpan interval1, interval2;
      interval1 = new TimeSpan(7, 45, 16);
      interval2 = new TimeSpan(18, 12, 38);
      
      Console.WriteLine("{0:g} - {1:g} = {2:g}", interval1, 
                        interval2, interval1 - interval2);
      Console.WriteLine(String.Format(new CultureInfo("fr-FR"), 
                        "{0:g} + {1:g} = {2:g}", interval1, 
                        interval2, interval1 + interval2));
      
      interval1 = new TimeSpan(0, 0, 1, 14, 36);
      interval2 = TimeSpan.FromTicks(2143756);      
      Console.WriteLine("{0:g} + {1:g} = {2:g}", interval1, 
                        interval2, interval1 + interval2);
   }
}
// The example displays the following output:
//       7:45:16 - 18:12:38 = -10:27:22
//       7:45:16 + 18:12:38 = 1:1:57:54
//       0:01:14.036 + 0:00:00.2143756 = 0:01:14.2503756
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim interval1, interval2 As TimeSpan
      interval1 = New TimeSpan(7, 45, 16)
      interval2 = New TimeSpan(18, 12, 38)
      
      Console.WriteLine("{0:g} - {1:g} = {2:g}", interval1, 
                        interval2, interval1 - interval2)
      Console.WriteLine(String.Format(New CultureInfo("fr-FR"), 
                        "{0:g} + {1:g} = {2:g}", interval1, 
                        interval2, interval1 + interval2))
      
      interval1 = New TimeSpan(0, 0, 1, 14, 36)
      interval2 = TimeSpan.FromTicks(2143756)      
      Console.WriteLine("{0:g} + {1:g} = {2:g}", interval1, 
                        interval2, interval1 + interval2)
   End Sub
End Module
' The example displays the following output:
'       7:45:16 - 18:12:38 = -10:27:22
'       7:45:16 + 18:12:38 = 1:1:57:54
'       0:01:14.036 + 0:00:00.2143756 = 0:01:14.2503756

Genel uzun ("G") Biçim belirleyicisiThe General Long ("G") Format Specifier

"G" TimeSpan Biçim Belirleyicisi, TimeSpan değerin dize gösterimini, her zaman hem gün hem de kesirli saniyeleri içeren uzun bir biçimde döndürür.The "G" TimeSpan format specifier returns the string representation of a TimeSpan value in a long form that always includes both days and fractional seconds. "G" standart biçim belirticisinden elde edilen dize aşağıdaki biçimdedir:The string that results from the "G" standard format specifier has the following form:

[-] d:SS:dd:SS. fffffff[-]d:hh:mm:ss.fffffff

Köşeli ayraçlar ([ve]) içindeki öğeler isteğe bağlıdır.Elements in square brackets ([ and ]) are optional. İki nokta (:) sabit bir simgedir.The colon (:) is a literal symbol. Aşağıdaki tabloda kalan öğeler açıklanmaktadır.The following table describes the remaining elements.

ÖğeElement AçıklamaDescription
- Negatif bir zaman aralığını belirten isteğe bağlı bir eksi işareti.An optional negative sign, which indicates a negative time interval.
dd Önünde sıfır olmayan gün sayısı.The number of days, with no leading zeros.
hhhh "00" ile "23" arasında değişen saat sayısı.The number of hours, which ranges from "00" to "23".
mmmm "00" ile "59" arasında değişen dakika sayısı.The number of minutes, which ranges from "00" to "59".
ssss "00" ile "59" arasında değişen saniye sayısı.The number of seconds, which ranges from "00" to "59".
.. Kesirli saniye ayırıcısı.The fractional seconds separator. Kullanıcı geçersiz kılmaları olmadan belirtilen kültürün NumberDecimalSeparator özelliğine eşdeğerdir.It is equivalent to the specified culture's NumberDecimalSeparator property without user overrides.
ffffffffffffff Kesirli saniyeler.The fractional seconds.

"G" biçim belirticisi gibi, "g" biçim belirticisi yerelleştirilmiştir.Like the "G" format specifier, the "g" format specifier is localized. Kesirli saniye ayırıcısı, geçerli kültürü veya belirtilen kültürün NumberDecimalSeparator özelliğini temel alır.Its fractional seconds separator is based on either the current culture or a specified culture's NumberDecimalSeparator property.

Aşağıdaki örnek iki TimeSpan nesnesini örneklemektedir, aritmetik işlemler gerçekleştirmek için bunları kullanır ve sonucu görüntüler.The following example instantiates two TimeSpan objects, uses them to perform arithmetic operations, and displays the result. Her durumda, "G" biçim belirticisini kullanarak TimeSpan değerini göstermek için bileşik biçimlendirme kullanır.In each case, it uses composite formatting to display the TimeSpan value by using the "G" format specifier. Ayrıca, geçerli sistem kültürünün (Bu örnekte, Ingilizce-Birleşik Devletler veya en-US) ve Fransızca-Fransa (fr-FR) kültürüne ait biçimlendirme kurallarını kullanarak TimeSpan değerini biçimlendirir.In addition, it formats the TimeSpan value by using the formatting conventions of the current system culture (which, in this case, is English - United States or en-US) and the French - France (fr-FR) culture.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      TimeSpan interval1, interval2;
      interval1 = new TimeSpan(7, 45, 16);
      interval2 = new TimeSpan(18, 12, 38);
      
      Console.WriteLine("{0:G} - {1:G} = {2:G}", interval1, 
                        interval2, interval1 - interval2);
      Console.WriteLine(String.Format(new CultureInfo("fr-FR"), 
                        "{0:G} + {1:G} = {2:G}", interval1, 
                        interval2, interval1 + interval2));
      
      interval1 = new TimeSpan(0, 0, 1, 14, 36);
      interval2 = TimeSpan.FromTicks(2143756);      
      Console.WriteLine("{0:G} + {1:G} = {2:G}", interval1, 
                        interval2, interval1 + interval2);
   }
}
// The example displays the following output:
//       0:07:45:16.0000000 - 0:18:12:38.0000000 = -0:10:27:22.0000000
//       0:07:45:16,0000000 + 0:18:12:38,0000000 = 1:01:57:54,0000000
//       0:00:01:14.0360000 + 0:00:00:00.2143756 = 0:00:01:14.2503756
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim interval1, interval2 As TimeSpan
      interval1 = New TimeSpan(7, 45, 16)
      interval2 = New TimeSpan(18, 12, 38)
      
      Console.WriteLine("{0:G} - {1:G} = {2:G}", interval1, 
                        interval2, interval1 - interval2)
      Console.WriteLine(String.Format(New CultureInfo("fr-FR"), 
                        "{0:G} + {1:G} = {2:G}", interval1, 
                        interval2, interval1 + interval2))
      
      interval1 = New TimeSpan(0, 0, 1, 14, 36)
      interval2 = TimeSpan.FromTicks(2143756)      
      Console.WriteLine("{0:G} + {1:G} = {2:G}", interval1, 
                        interval2, interval1 + interval2)
   End Sub
End Module
' The example displays the following output:
'       0:07:45:16.0000000 - 0:18:12:38.0000000 = -0:10:27:22.0000000
'       0:07:45:16,0000000 + 0:18:12:38,0000000 = 1:01:57:54,0000000
'       0:00:01:14.0360000 + 0:00:00:00.2143756 = 0:00:01:14.2503756

Ayrıca bkz.See also