TimeSpan.ToString Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengonversi nilai objek saat ini TimeSpan ke representasi string yang setara.
Overload
| ToString() |
Mengonversi nilai objek saat ini TimeSpan ke representasi string yang setara. |
| ToString(String) |
Mengonversi nilai objek saat ini TimeSpan ke representasi string yang setara dengan menggunakan format yang ditentukan. |
| ToString(String, IFormatProvider) |
Mengonversi nilai objek saat ini TimeSpan ke representasi string yang setara dengan menggunakan format yang ditentukan dan informasi pemformatan khusus budaya. |
ToString()
- Sumber:
- TimeSpan.cs
- Sumber:
- TimeSpan.cs
- Sumber:
- TimeSpan.cs
Mengonversi nilai objek saat ini TimeSpan ke representasi string yang setara.
public:
override System::String ^ ToString();public override string ToString ();override this.ToString : unit -> stringPublic Overrides Function ToString () As StringMengembalikan
Representasi string dari nilai saat ini TimeSpan .
Contoh
Contoh berikut menampilkan string yang dikembalikan dengan memanggil ToString metode dengan sejumlah TimeSpan nilai. Perhatikan bahwa meskipun contoh tidak memanggil metode secara ToString langsung, itu dipanggil oleh Console.WriteLine metode ketika mencoba untuk mengonversi TimeSpan nilai ke representasi stringnya.
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
Keterangan
String yang dikembalikan diformat dengan penentu format "c" dan memiliki format berikut:
[-][d.]hh:mm:ss[.fffffff]
Elemen dalam tanda kurung siku ([ dan ]) mungkin tidak disertakan dalam string yang dikembalikan. Titik dua dan titik (: dan.) adalah karakter harfiah. Elemen non-literal tercantum dalam tabel berikut. Perhatikan bahwa string yang dikembalikan oleh ToString() metode tidak sensitif terhadap budaya.
| Item | Deskripsi |
|---|---|
| "-" | Tanda minus, yang menunjukkan interval waktu negatif. Tidak ada tanda yang disertakan untuk rentang waktu positif. |
| "d" | Jumlah hari dalam interval waktu. Elemen ini dihilangkan jika interval waktu kurang dari satu hari. |
| "hh" | Jumlah jam dalam interval waktu, berkisar antara 0 hingga 23. |
| "mm" | Jumlah menit dalam interval waktu, berkisar antara 0 hingga 59. |
| "ss" | Jumlah detik dalam interval waktu, berkisar antara 0 hingga 59. |
| "fffffff" | Detik pecahan dalam interval waktu. Elemen ini dihilangkan jika interval waktu tidak menyertakan detik pecahan. Jika ada, detik pecahan selalu dinyatakan menggunakan tujuh digit desimal. |
Catatan Bagi Pemanggil
Dukungan untuk nilai pemformatan TimeSpan ditambahkan di .NET Framework 4. Namun, ToString() metode kelebihan beban tetap tidak peka budaya. Perilakunya tetap tidak berubah dari versi .NET Framework sebelumnya. Untuk mengontrol pemformatan TimeSpan nilai, panggil ToString(String) atau ToString(String, IFormatProvider) kelebihan beban.
Lihat juga
Berlaku untuk
ToString(String)
- Sumber:
- TimeSpan.cs
- Sumber:
- TimeSpan.cs
- Sumber:
- TimeSpan.cs
Mengonversi nilai objek saat ini TimeSpan ke representasi string yang setara dengan menggunakan format yang ditentukan.
public:
System::String ^ ToString(System::String ^ format);public string ToString (string format);public string ToString (string? format);override this.ToString : string -> stringPublic Function ToString (format As String) As StringParameter
Mengembalikan
Representasi string dari nilai saat ini TimeSpan dalam format yang ditentukan oleh format parameter .
Pengecualian
Parameter format tidak dikenali atau tidak didukung.
Contoh
Contoh berikut menggunakan string format standar dan kustom TimeSpan untuk menampilkan representasi string dari setiap elemen dalam array TimeSpan nilai
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.
Keterangan
Parameter format dapat berupa penentu format standar atau kustom yang valid untuk TimeSpan nilai. Jika format sama dengan String.Empty atau adalah null, nilai yang dikembalikan dari objek saat ini TimeSpan diformat dengan penentu format umum ("c"). Jika format adalah nilai lain, metode melempar FormatException.
Jika format adalah string format standar, format string yang dikembalikan ditentukan oleh konvensi pemformatan budaya saat ini.
Penting
String format kustom untuk TimeSpan nilai tidak menyertakan pemisah tanggal atau waktu. Jika Anda ingin menyertakan elemen-elemen ini dalam string format, Anda harus memperlakukannya sebagai literal karakter. Lihat contoh untuk ilustrasi, dan lihat topik String Format Rentang Waktu Kustom untuk informasi selengkapnya.
.NET menyediakan dukungan pemformatan ekstensif, yang dijelaskan secara lebih rinci dalam topik pemformatan berikut:
Untuk informasi selengkapnya tentang string format untuk TimeSpan nilai, lihat String Format Rentang Waktu Standar dan String Format Rentang Waktu Kustom.
Untuk informasi selengkapnya tentang dukungan untuk pemformatan di .NET, lihat Jenis Pemformatan.
Lihat juga
Berlaku untuk
ToString(String, IFormatProvider)
- Sumber:
- TimeSpan.cs
- Sumber:
- TimeSpan.cs
- Sumber:
- TimeSpan.cs
Mengonversi nilai objek saat ini TimeSpan ke representasi string yang setara dengan menggunakan format yang ditentukan dan informasi pemformatan khusus budaya.
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 -> stringPublic Function ToString (format As String, formatProvider As IFormatProvider) As StringParameter
- formatProvider
- IFormatProvider
Objek yang memasok informasi pemformatan khusus budaya.
Mengembalikan
Representasi string dari nilai saat ini TimeSpan , seperti yang ditentukan oleh format dan formatProvider.
Penerapan
Pengecualian
Parameter format tidak dikenali atau tidak didukung.
Contoh
Contoh berikut memanggil ToString(String, IFormatProvider) metode untuk memformat dua interval waktu. Contohnya memanggil metode dua kali untuk setiap string format, pertama-tama untuk menampilkannya menggunakan konvensi budaya en-US dan kemudian untuk menampilkannya menggunakan konvensi budaya 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
Keterangan
Parameter format dapat berupa penentu format standar atau kustom yang valid untuk TimeSpan nilai. Jika format sama dengan String.Empty atau adalah null, nilai yang dikembalikan dari objek saat ini TimeSpan diformat dengan penentu format umum ("c"). Jika format adalah nilai lain, metode akan menampilkan FormatException.
Penting
String format kustom untuk TimeSpan nilai tidak menyertakan pemisah tanggal atau waktu. Jika Anda ingin menyertakan elemen-elemen ini dalam string format, Anda harus memperlakukannya sebagai literal karakter. Lihat contoh untuk ilustrasi, dan lihat topik String Format Rentang Waktu Kustom untuk informasi selengkapnya.
.NET menyediakan dukungan pemformatan ekstensif, yang dijelaskan secara lebih rinci dalam topik pemformatan berikut:
Untuk informasi selengkapnya tentang string format untuk TimeSpan nilai, lihat String Format Rentang Waktu Standar dan String Format Rentang Waktu Kustom.
Untuk informasi selengkapnya tentang dukungan untuk pemformatan di .NET, lihat Jenis Pemformatan.
Parameter formatProvider adalah IFormatProvider implementasi yang menyediakan informasi khusus budaya tentang format string yang dikembalikan. Parameter formatProvider dapat berupa salah satu hal berikut:
Objek CultureInfo yang mewakili budaya yang konvensi pemformatannya akan tercermin dalam string yang dikembalikan. Objek DateTimeFormatInfo yang CultureInfo.DateTimeFormat dikembalikan oleh properti menentukan pemformatan string yang dikembalikan.
Objek DateTimeFormatInfo yang menentukan pemformatan string yang dikembalikan.
Objek kustom yang mengimplementasikan IFormatProvider antarmuka. Metodenya IFormatProvider.GetFormat mengembalikan DateTimeFormatInfo objek yang menyediakan informasi pemformatan.
Jika formatProvider adalah null, DateTimeFormatInfo objek yang terkait dengan budaya saat ini digunakan. Jika format adalah string format kustom, formatProvider parameter diabaikan.
Lihat juga
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk