TimeSpan.ToString Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu.
Przeciążenia
ToString(String, IFormatProvider) |
Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu przy użyciu określonego formatu i informacji o formatowaniu specyficznym dla kultury. |
ToString(String) |
Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu przy użyciu określonego formatu. |
ToString() |
Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu. |
ToString(String, IFormatProvider)
- Źródło:
- TimeSpan.cs
- Źródło:
- TimeSpan.cs
- Źródło:
- TimeSpan.cs
Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu przy użyciu określonego formatu i informacji o formatowaniu specyficznym dla kultury.
public:
virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ formatProvider);
public string ToString (string format, IFormatProvider formatProvider);
public string ToString (string? format, IFormatProvider? formatProvider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, formatProvider As IFormatProvider) As String
Parametry
- formatProvider
- IFormatProvider
Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.
Zwraca
Reprezentacja ciągu bieżącej TimeSpan wartości zgodnie z parametrami format
i formatProvider
.
Implementuje
Wyjątki
Parametr format
nie jest rozpoznawany lub nie jest obsługiwany.
Przykłady
Poniższy przykład wywołuje metodę ToString(String, IFormatProvider) , aby sformatować dwa interwały czasowe. Przykład wywołuje metodę dwa razy dla każdego ciągu formatu, najpierw wyświetla ją przy użyciu konwencji kultury en-US, a następnie wyświetla ją przy użyciu konwencji kultury fr-FR.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
TimeSpan[] intervals = { new TimeSpan(38, 30, 15),
new TimeSpan(16, 14, 30) };
CultureInfo[] cultures = { new CultureInfo("en-US"),
new CultureInfo("fr-FR") };
string[] formats = {"c", "g", "G", @"hh\:mm\:ss" };
Console.WriteLine("{0,12} Format {1,22} {2,22}\n",
"Interval", cultures[0].Name, cultures[1].Name);
foreach (var interval in intervals) {
foreach (var fmt in formats)
Console.WriteLine("{0,12} {1,10} {2,22} {3,22}",
interval, fmt,
interval.ToString(fmt, cultures[0]),
interval.ToString(fmt, cultures[1]));
Console.WriteLine();
}
}
}
// The example displays the following output:
// Interval Format en-US fr-FR
//
// 1.14:30:15 c 1.14:30:15 1.14:30:15
// 1.14:30:15 g 1:14:30:15 1:14:30:15
// 1.14:30:15 G 1:14:30:15.0000000 1:14:30:15,0000000
// 1.14:30:15 hh\:mm\:ss 14:30:15 14:30:15
//
// 16:14:30 c 16:14:30 16:14:30
// 16:14:30 g 16:14:30 16:14:30
// 16:14:30 G 0:16:14:30.0000000 0:16:14:30,0000000
// 16:14:30 hh\:mm\:ss 16:14:30 16:14:30
open System
open System.Globalization
let intervals =
[| TimeSpan(38, 30, 15)
TimeSpan(16, 14, 30) |]
let cultures =
[| CultureInfo "en-US"
CultureInfo "fr-FR" |]
let formats = [| "c"; "g"; "G"; @"hh\:mm\:ss" |]
printfn $"""{"Interval",12} Format {cultures[0].Name,22} {cultures[1].Name,22}\n"""
for interval in intervals do
for fmt in formats do
printfn $"{interval,12} {fmt,10} {interval.ToString(fmt, cultures[0]),22} {interval.ToString(fmt, cultures[1]),22}"
printfn ""
// The example displays the following output:
// Interval Format en-US fr-FR
//
// 1.14:30:15 c 1.14:30:15 1.14:30:15
// 1.14:30:15 g 1:14:30:15 1:14:30:15
// 1.14:30:15 G 1:14:30:15.0000000 1:14:30:15,0000000
// 1.14:30:15 hh\:mm\:ss 14:30:15 14:30:15
//
// 16:14:30 c 16:14:30 16:14:30
// 16:14:30 g 16:14:30 16:14:30
// 16:14:30 G 0:16:14:30.0000000 0:16:14:30,0000000
// 16:14:30 hh\:mm\:ss 16:14:30 16:14:30
Imports System.Globalization
Module Example
Public Sub Main()
Dim intervals() As TimeSpan = { New TimeSpan(38, 30, 15),
New TimeSpan(16, 14, 30) }
Dim cultures() As CultureInfo = { New CultureInfo("en-US"),
New CultureInfo("fr-FR") }
Dim formats() As String = {"c", "g", "G", "hh\:mm\:ss" }
Console.WriteLine("{0,12} Format {1,22} {2,22}",
"Interval", cultures(0).Name, cultures(1).Name)
Console.WriteLine()
For Each interval In intervals
For Each fmt In formats
Console.WriteLine("{0,12} {1,10} {2,22} {3,22}",
interval, fmt,
interval.ToString(fmt, cultures(0)),
interval.ToString(fmt, cultures(1)))
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' Interval Format en-US fr-FR
'
' 1.14:30:15 c 1.14:30:15 1.14:30:15
' 1.14:30:15 g 1:14:30:15 1:14:30:15
' 1.14:30:15 G 1:14:30:15.0000000 1:14:30:15,0000000
' 1.14:30:15 hh\:mm\:ss 14:30:15 14:30:15
'
' 16:14:30 c 16:14:30 16:14:30
' 16:14:30 g 16:14:30 16:14:30
' 16:14:30 G 0:16:14:30.0000000 0:16:14:30,0000000
' 16:14:30 hh\:mm\:ss 16:14:30 16:14:30
Uwagi
Parametr format
może być dowolnym prawidłowym specyfikatorem formatu standardowego lub niestandardowego dla TimeSpan wartości. Jeśli format
wartość jest równa String.Empty lub ma null
wartość , zwracana wartość bieżącego TimeSpan obiektu jest formatowana za pomocą specyfikatora formatu wspólnego ("c"). Jeśli format jest inną wartością FormatException, metoda zgłasza wartość .
Ważne
Ciągi formatu niestandardowego dla TimeSpan wartości nie zawierają separatora daty lub godziny. Jeśli chcesz uwzględnić te elementy w ciągu formatu, musisz traktować je jako literały znaków. Zobacz przykład ilustracji i zobacz temat Custom TimeSpan Format Strings (Niestandardowe ciągi formatu timeSpan), aby uzyskać więcej informacji.
Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:
Aby uzyskać więcej informacji na temat ciągów formatu dla TimeSpan wartości, zobacz Ciągi formatu Standard TimeSpan i Niestandardowe ciągi formatu TimeSpan.
Aby uzyskać więcej informacji na temat obsługi formatowania na platformie .NET, zobacz Typy formatowania.
Parametr formatProvider
jest implementacją IFormatProvider , która dostarcza informacje specyficzne dla kultury dotyczące formatu zwracanego ciągu. Parametr formatProvider
może być dowolnym z następujących:
CultureInfo Obiekt reprezentujący kulturę, której konwencje formatowania mają być odzwierciedlone w zwracanym ciągu. Obiekt DateTimeFormatInfo zwracany przez CultureInfo.DateTimeFormat właściwość definiuje formatowanie zwracanego ciągu.
DateTimeFormatInfo Obiekt, który definiuje formatowanie zwracanego ciągu.
Obiekt niestandardowy, który implementuje IFormatProvider interfejs. Metoda IFormatProvider.GetFormat zwraca DateTimeFormatInfo obiekt, który dostarcza informacje o formatowaniu.
Jeśli formatProvider
parametr ma null
wartość , DateTimeFormatInfo używany jest obiekt skojarzony z bieżącą kulturą. Jeśli format
jest ciągiem formatu niestandardowego, formatProvider
parametr jest ignorowany.
Zobacz też
Dotyczy
ToString(String)
- Źródło:
- TimeSpan.cs
- Źródło:
- TimeSpan.cs
- Źródło:
- TimeSpan.cs
Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu przy użyciu określonego formatu.
public:
System::String ^ ToString(System::String ^ format);
public string ToString (string format);
public string ToString (string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String
Parametry
Zwraca
Reprezentacja ciągu bieżącej TimeSpan wartości w formacie określonym przez format
parametr .
Wyjątki
Parametr format
nie jest rozpoznawany lub nie jest obsługiwany.
Przykłady
W poniższym przykładzie użyto ciągów formatu standardowego i niestandardowego TimeSpan , aby wyświetlić reprezentację ciągu każdego elementu w tablicy TimeSpan wartości
TimeSpan[] spans = {
TimeSpan.Zero,
new TimeSpan(-14, 0, 0, 0, 0),
new TimeSpan(1, 2, 3),
new TimeSpan(0, 0, 0, 0, 250),
new TimeSpan(99, 23, 59, 59, 999),
new TimeSpan(3, 0, 0),
new TimeSpan(0, 0, 0, 0, 25)
};
string[] fmts = { "c", "g", "G", @"hh\:mm\:ss", "%m' min.'" };
foreach (TimeSpan span in spans)
{
foreach (string fmt in fmts)
Console.WriteLine("{0}: {1}", fmt, span.ToString(fmt));
Console.WriteLine();
}
// The example displays the following output:
// c: 00:00:00
// g: 0:00:00
// G: 0:00:00:00.0000000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
//
// c: -14.00:00:00
// g: -14:0:00:00
// G: -14:00:00:00.0000000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
//
// c: 01:02:03
// g: 1:02:03
// G: 0:01:02:03.0000000
// hh\:mm\:ss: 01:02:03
// %m' min.': 2 min.
//
// c: 00:00:00.2500000
// g: 0:00:00.25
// G: 0:00:00:00.2500000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
//
// c: 99.23:59:59.9990000
// g: 99:23:59:59.999
// G: 99:23:59:59.9990000
// hh\:mm\:ss: 23:59:59
// %m' min.': 59 min.
//
// c: 03:00:00
// g: 3:00:00
// G: 0:03:00:00.0000000
// hh\:mm\:ss: 03:00:00
// %m' min.': 0 min.
//
// c: 00:00:00.0250000
// g: 0:00:00.025
// G: 0:00:00:00.0250000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
let spans =
[| TimeSpan.Zero
TimeSpan(-14, 0, 0, 0, 0)
TimeSpan(1, 2, 3)
TimeSpan(0, 0, 0, 0, 250)
TimeSpan(99, 23, 59, 59, 999)
TimeSpan(3, 0, 0)
TimeSpan(0, 0, 0, 0, 25) |]
let fmts = [| "c"; "g"; "G"; @"hh\:mm\:ss"; "%m' min.'" |]
for span in spans do
for fmt in fmts do
printfn $"{fmt}: {span.ToString fmt}"
printfn ""
// The example displays the following output:
// c: 00:00:00
// g: 0:00:00
// G: 0:00:00:00.0000000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
//
// c: -14.00:00:00
// g: -14:0:00:00
// G: -14:00:00:00.0000000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
//
// c: 01:02:03
// g: 1:02:03
// G: 0:01:02:03.0000000
// hh\:mm\:ss: 01:02:03
// %m' min.': 2 min.
//
// c: 00:00:00.2500000
// g: 0:00:00.25
// G: 0:00:00:00.2500000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
//
// c: 99.23:59:59.9990000
// g: 99:23:59:59.999
// G: 99:23:59:59.9990000
// hh\:mm\:ss: 23:59:59
// %m' min.': 59 min.
//
// c: 03:00:00
// g: 3:00:00
// G: 0:03:00:00.0000000
// hh\:mm\:ss: 03:00:00
// %m' min.': 0 min.
//
// c: 00:00:00.0250000
// g: 0:00:00.025
// G: 0:00:00:00.0250000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
Module Example
Public Sub Main()
Dim spans() As TimeSpan = { TimeSpan.Zero, New TimeSpan(-14, 0, 0, 0, 0),
New TimeSpan(1, 2, 3),
New TimeSpan(0, 0, 0, 0, 250),
New TimeSpan(99, 23, 59, 59, 999),
New TimeSpan(3, 0, 0),
New TimeSpan(0, 0, 0, 0, 25) }
Dim fmts() As String = { "c", "g", "G", "hh\:mm\:ss", "%m' min.'" }
For Each span As TimeSpan In spans
For Each fmt As String In fmts
Console.WriteLine("{0}: {1}", fmt, span.ToString(fmt))
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' c: 00:00:00
' g: 0:00:00
' G: 0:00:00:00.0000000
' hh\:mm\:ss: 00:00:00
' %m' min.': 0 min.
'
' c: -14.00:00:00
' g: -14:0:00:00
' G: -14:00:00:00.0000000
' hh\:mm\:ss: 00:00:00
' %m' min.': 0 min.
'
' c: 01:02:03
' g: 1:02:03
' G: 0:01:02:03.0000000
' hh\:mm\:ss: 01:02:03
' %m' min.': 2 min.
'
' c: 00:00:00.2500000
' g: 0:00:00.25
' G: 0:00:00:00.2500000
' hh\:mm\:ss: 00:00:00
' %m' min.': 0 min.
'
' c: 99.23:59:59.9990000
' g: 99:23:59:59.999
' G: 99:23:59:59.9990000
' hh\:mm\:ss: 23:59:59
' %m' min.': 59 min.
'
' c: 03:00:00
' g: 3:00:00
' G: 0:03:00:00.0000000
' hh\:mm\:ss: 03:00:00
' %m' min.': 0 min.
'
' c: 00:00:00.0250000
' g: 0:00:00.025
' G: 0:00:00:00.0250000
' hh\:mm\:ss: 00:00:00
' %m' min.': 0 min.
Uwagi
Parametr format
może być dowolnym prawidłowym specyfikatorem formatu standardowego lub niestandardowego dla TimeSpan wartości. Jeśli format
wartość jest równa String.Empty lub ma null
wartość , zwracana wartość bieżącego TimeSpan obiektu jest formatowana za pomocą specyfikatora formatu wspólnego ("c"). Jeśli format
jest inną wartością FormatException, metoda zgłasza wartość .
Jeśli format
jest to standardowy ciąg formatu, format zwracanego ciągu jest definiowany przez konwencje formatowania bieżącej kultury.
Ważne
Ciągi formatu niestandardowego dla TimeSpan wartości nie zawierają separatora daty lub godziny. Jeśli chcesz uwzględnić te elementy w ciągu formatu, musisz traktować je jako literały znaków. Zobacz przykład ilustracji i zobacz temat Custom TimeSpan Format Strings (Niestandardowe ciągi formatu timeSpan), aby uzyskać więcej informacji.
Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:
Aby uzyskać więcej informacji na temat ciągów formatu dla TimeSpan wartości, zobacz Ciągi formatu Standard TimeSpan i Niestandardowe ciągi formatu TimeSpan.
Aby uzyskać więcej informacji na temat obsługi formatowania na platformie .NET, zobacz Typy formatowania.
Zobacz też
Dotyczy
ToString()
- Źródło:
- TimeSpan.cs
- Źródło:
- TimeSpan.cs
- Źródło:
- TimeSpan.cs
Konwertuje wartość bieżącego TimeSpan obiektu na równoważną reprezentację ciągu.
public:
override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Zwraca
Reprezentacja ciągu bieżącej TimeSpan wartości.
Przykłady
Poniższy przykład przedstawia ciągi zwracane przez wywołanie ToString metody z liczbą TimeSpan wartości. Należy pamiętać, że chociaż przykład nie wywołuje ToString metody bezpośrednio, jest wywoływany przez Console.WriteLine metodę podczas próby przekonwertowania wartości na jej reprezentację TimeSpan ciągu.
TimeSpan span;
// Initialize a time span to zero.
span = TimeSpan.Zero;
Console.WriteLine(span);
// Initialize a time span to 14 days.
span = new TimeSpan(-14, 0, 0, 0, 0);
Console.WriteLine(span);
// Initialize a time span to 1:02:03.
span = new TimeSpan(1, 2, 3);
Console.WriteLine(span);
// Initialize a time span to 250 milliseconds.
span = new TimeSpan(0, 0, 0, 0, 250);
Console.WriteLine(span);
// Initialize a time span to 99 days, 23 hours, 59 minutes, and 59.999 seconds.
span = new TimeSpan(99, 23, 59, 59, 999);
Console.WriteLine(span);
// Initialize a time span to 3 hours.
span = new TimeSpan(3, 0, 0);
Console.WriteLine(span);
// Initialize a timespan to 25 milliseconds.
span = new TimeSpan(0, 0, 0, 0, 25);
Console.WriteLine(span);
// The example displays the following output:
// 00:00:00
// -14.00:00:00
// 01:02:03
// 00:00:00.2500000
// 99.23:59:59.9990000
// 03:00:00
// 00:00:00.0250000
// Initialize a time span to zero.
let span = TimeSpan.Zero
printfn $"{span}"
// Initialize a time span to 14 days.
let span = TimeSpan(-14, 0, 0, 0, 0)
printfn $"{span}"
// Initialize a time span to 1:02:03.
let span = TimeSpan(1, 2, 3)
printfn $"{span}"
// Initialize a time span to 250 milliseconds.
let span = TimeSpan(0, 0, 0, 0, 250)
printfn $"{span}"
// Initialize a time span to 99 days, 23 hours, 59 minutes, and 59.999 seconds.
let span = TimeSpan(99, 23, 59, 59, 999)
printfn $"{span}"
// Initialize a time span to 3 hours.
let span = TimeSpan(3, 0, 0)
printfn $"{span}"
// Initialize a timespan to 25 milliseconds.
let span = TimeSpan(0, 0, 0, 0, 25)
printfn $"{span}"
// The example displays the following output:
// 00:00:00
// -14.00:00:00
// 01:02:03
// 00:00:00.2500000
// 99.23:59:59.9990000
// 03:00:00
// 00:00:00.0250000
Module ToString
Public Sub Main()
Dim span As TimeSpan
' Initialize a time span to zero.
span = TimeSpan.Zero
Console.WriteLine(span)
' Initialize a time span to 14 days.
span = New TimeSpan(-14, 0, 0, 0, 0)
Console.WriteLine(span)
' Initialize a time span to 1:02:03.
span = New TimeSpan(1, 2, 3)
Console.WriteLine(span)
' Initialize a time span to 250 milliseconds.
span = New TimeSpan(0, 0, 0, 0, 250)
Console.WriteLine(span)
' Initialize a time span to 99 days, 23 hours, 59 minutes, and 59.9999999 seconds.
span = New TimeSpan(99, 23, 59, 59, 999)
Console.WriteLine(span)
' Initialize a time span to 3 hours.
span = New TimeSpan(3, 0, 0)
Console.WriteLine(span)
' Initialize a timespan to 25 milliseconds.
span = New TimeSpan(0, 0, 0, 0, 25)
Console.WriteLine(span)
End Sub
End Module
' The example displays the following output:
' 00:00:00
' -14.00:00:00
' 01:02:03
' 00:00:00.2500000
' 99.23:59:59.9990000
' 03:00:00
' 00:00:00.0250000
Uwagi
Zwrócony ciąg jest sformatowany za pomocą specyfikatora formatu "c" i ma następujący format:
[-] [d.] hh:mm:ss[.fffffff]
Elementy w nawiasach kwadratowych ([ i ]) mogą nie być uwzględnione w zwracanym ciągu. Dwukropki i kropki (: i.) to znaki literału. Elementy niesłowne są wymienione w poniższej tabeli. Zwróć uwagę, że ciąg zwracany przez metodę ToString() nie jest uwzględniany w kulturze.
Element | Opis |
---|---|
"-" | Znak minus, który wskazuje ujemny interwał czasu. Dla dodatniego przedziału czasu nie jest uwzględniany żaden znak. |
"d" | Liczba dni w interwale czasu. Ten element zostanie pominięty, jeśli interwał czasu jest krótszy niż jeden dzień. |
"hh" | Liczba godzin w interwale czasu, od 0 do 23. |
"mm" | Liczba minut w interwale czasu, od 0 do 59. |
"ss" | Liczba sekund w interwale czasu, od 0 do 59. |
"fffffff" | Ułamkowe sekundy w przedziale czasu. Ten element zostanie pominięty, jeśli interwał czasu nie zawiera sekund ułamkowych. Jeśli są obecne, sekundy ułamkowe są zawsze wyrażane przy użyciu siedmiu cyfr dziesiętnych. |
Uwagi dotyczące wywoływania
Dodano obsługę wartości formatowania TimeSpan w .NET Framework 4. Jednak ToString() przeciążenie metody pozostaje niewrażliwe na kulturę. Jego zachowanie pozostaje niezmienione w porównaniu z poprzednimi wersjami .NET Framework. Aby kontrolować formatowanie TimeSpan wartości, wywołaj przeciążenie ToString(String) lub ToString(String, IFormatProvider) .
Zobacz też
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla