TimeSpan.ParseExact Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bir zaman aralığının dize gösterimini eşdeğerine TimeSpan dönüştürür. Dize gösteriminin biçimi belirtilen biçimle tam olarak eşleşmelidir.
Aşırı Yüklemeler
ParseExact(String, String[], IFormatProvider, TimeSpanStyles) |
Belirtilen biçimleri, kültüre özgü biçim bilgilerini ve stilleri kullanarak bir zaman aralığının dize gösterimini eşdeğerine TimeSpan dönüştürür. Dize gösteriminin biçimi belirtilen biçimlerinden biriyle tam olarak eşleşmelidir. |
ParseExact(String, String, IFormatProvider, TimeSpanStyles) |
Belirtilen biçimi, kültüre özgü biçim bilgilerini ve stilleri kullanarak bir zaman aralığının dize gösterimini eşdeğerine TimeSpan dönüştürür. Dize gösteriminin biçimi belirtilen biçimle tam olarak eşleşmelidir. |
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, TimeSpanStyles) |
Belirtilen biçimleri, kültüre özgü biçim bilgilerini ve stilleri kullanarak bir zaman aralığının dize gösterimini eşdeğerine TimeSpan dönüştürür. Dize gösteriminin biçimi belirtilen biçimlerinden biriyle tam olarak eşleşmelidir. |
ParseExact(String, String[], IFormatProvider) |
Belirtilen biçim dizeleri dizisini ve kültüre özgü biçim bilgilerini kullanarak bir zaman aralığının dize gösterimini TimeSpan eşdeğerine dönüştürür. Dize gösteriminin biçimi belirtilen biçimlerinden biriyle tam olarak eşleşmelidir. |
ParseExact(String, String, IFormatProvider) |
Belirtilen biçimi ve kültüre özgü biçim bilgilerini kullanarak bir zaman aralığının dize gösterimini TimeSpan eşdeğerine dönüştürür. Dize gösteriminin biçimi belirtilen biçimle tam olarak eşleşmelidir. |
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, TimeSpanStyles) |
Belirtilen biçimi ve kültüre TimeSpan özgü biçim bilgilerini kullanarak bir zaman aralığının karakter aralığını eşdeğerine dönüştürür. Dize gösteriminin biçimi belirtilen biçimle tam olarak eşleşmelidir. |
ParseExact(String, String[], IFormatProvider, TimeSpanStyles)
- Kaynak:
- TimeSpan.cs
- Kaynak:
- TimeSpan.cs
- Kaynak:
- TimeSpan.cs
Belirtilen biçimleri, kültüre özgü biçim bilgilerini ve stilleri kullanarak bir zaman aralığının dize gösterimini eşdeğerine TimeSpan dönüştürür. Dize gösteriminin biçimi belirtilen biçimlerinden biriyle tam olarak eşleşmelidir.
public:
static TimeSpan ParseExact(System::String ^ input, cli::array <System::String ^> ^ formats, IFormatProvider ^ formatProvider, System::Globalization::TimeSpanStyles styles);
public static TimeSpan ParseExact (string input, string[] formats, IFormatProvider formatProvider, System.Globalization.TimeSpanStyles styles);
public static TimeSpan ParseExact (string input, string[] formats, IFormatProvider? formatProvider, System.Globalization.TimeSpanStyles styles);
static member ParseExact : string * string[] * IFormatProvider * System.Globalization.TimeSpanStyles -> TimeSpan
Public Shared Function ParseExact (input As String, formats As String(), formatProvider As IFormatProvider, styles As TimeSpanStyles) As TimeSpan
Parametreler
- input
- String
Dönüştürülecek zaman aralığını belirten bir dize.
- formats
- String[]
gerekli biçimini tanımlayan standart veya özel biçim dizelerinden oluşan bir input
dizi.
- formatProvider
- IFormatProvider
Kültüre özgü biçimlendirme bilgilerini sağlayan nesne.
- styles
- TimeSpanStyles
Girişte bulunabilecek stil öğelerini tanımlayan sabit listesi değerlerinin bit düzeyinde birleşimi.
Döndürülenler
, formatProvider
ve styles
tarafından formats
belirtildiği gibi öğesine karşılık gelen input
bir zaman aralığı.
Özel durumlar
styles
geçersiz TimeSpanStyles bir değerdir.
input
, null
değeridir.
input
geçersiz bir biçime sahip.
input
TimeSpan.MinValue değerinden küçük veya TimeSpan.MaxValue değerinden büyük bir sayıyı temsil eder.
-veya-
içindeki input
gün, saat, dakika veya saniye bileşenlerinden en az biri geçerli aralığının dışındadır.
Örnekler
Aşağıdaki örnek, bir dize dizisinin ParseExact(String, String[], IFormatProvider, TimeSpanStyles) her öğesini bir TimeSpan değere dönüştürmek için yöntemini çağırır. Dizeler genel kısa biçim veya genel uzun biçimde bir zaman aralığını temsil edebilir.
Ayrıca örnek, zaman aralığı ayrıştırma yöntemlerinin tek bir basamağı yorumlama şeklini değiştirir. Normalde, bir tek basamaklı sayı, bir zaman aralığındaki gün sayısı olarak yorumlanır. Bunun yerine, %h
özel biçim dizesi tek bir basamayı saat sayısı olarak yorumlamak için kullanılır. Bu değişikliğin etkili olması için özel biçim dizesinin dizideki %h
formats
diğer biçim dizelerinden önce olması gerektiğini unutmayın. Ayrıca çıkışta, yöntem çağrısında belirtilen bayrağın TimeSpanStyles.AssumeNegative yalnızca bu biçim tanımlayıcısıyla bir dize ayrıştırılırken kullanıldığını unutmayın.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
string[] inputs = { "3", "16:42", "1:6:52:35.0625",
"1:6:52:35,0625" };
string[] formats = { "%h", "g", "G" };
TimeSpan interval;
CultureInfo culture = new CultureInfo("de-DE");
// Parse each string in inputs using formats and the de-DE culture.
foreach (string input in inputs) {
try {
interval = TimeSpan.ParseExact(input, formats, culture,
TimeSpanStyles.AssumeNegative);
Console.WriteLine("{0} --> {1:c}", input, interval);
}
catch (FormatException) {
Console.WriteLine("{0} --> Bad Format", input);
}
catch (OverflowException) {
Console.WriteLine("{0} --> Overflow", input);
}
}
}
}
// The example displays the following output:
// 3 --> -03:00:00
// 16:42 --> 16:42:00
// 1:6:52:35.0625 --> Bad Format
// 1:6:52:35,0625 --> 1.06:52:35.0625000
open System
open System.Globalization
let inputs =
[| "3"; "16:42"; "1:6:52:35.0625"; "1:6:52:35,0625" |]
let formats = [| "%h"; "g"; "G" |]
let culture = CultureInfo "de-DE"
// Parse each string in inputs using formats and the de-DE culture.
for input in inputs do
try
let interval =
TimeSpan.ParseExact(input, formats, culture, TimeSpanStyles.AssumeNegative)
printfn $"{input} --> {interval:c}"
with
| :? FormatException ->
printfn $"{input} --> Bad Format"
| :? OverflowException ->
printfn $"{input} --> Overflow"
// The example displays the following output:
// 3 --> -03:00:00
// 16:42 --> 16:42:00
// 1:6:52:35.0625 --> Bad Format
// 1:6:52:35,0625 --> 1.06:52:35.0625000
Imports System.Globalization
Module Example
Public Sub Main()
Dim inputs() As String = { "3", "16:42", "1:6:52:35.0625",
"1:6:52:35,0625" }
Dim formats() As String = { "%h", "g", "G" }
Dim interval As TimeSpan
Dim culture As New CultureInfo("de-DE")
' Parse each string in inputs using formats and the de-DE culture.
For Each input As String In inputs
Try
interval = TimeSpan.ParseExact(input, formats, culture,
TimeSpanStyles.AssumeNegative)
Console.WriteLine("{0} --> {1:c}", input, interval)
Catch e As FormatException
Console.WriteLine("{0} --> Bad Format", input)
Catch e As OverflowException
Console.WriteLine("{0} --> Overflow", input)
End Try
Next
End Sub
End Module
' The example displays the following output:
' 3 --> -03:00:00
' 16:42 --> 16:42:00
' 1:6:52:35.0625 --> Bad Format
' 1:6:52:35,0625 --> 1.06:52:35.0625000
Açıklamalar
ParseExact(String, String[], IFormatProvider, TimeSpanStyles) yöntemi, baştaki ve sondaki boşluk karakterlerinin yoksayılması dışında parametre tarafından formats
tanımlanan biçimlerden birinde olması gereken bir zaman aralığının dize gösterimini ayrıştırıyor. içinde input
belirtilen formats
biçimlerden birine tam olarak uyması gerektiğinden, kullanıcı tarafından bir dize girişini bir zaman aralığına dönüştürürken her zaman özel durum işlemeyi kullanmalısınız. Özel durum işlemeyi kullanmamayı tercih ederseniz, bunun yerine yöntemini çağırabilirsiniz TryParseExact(String, String[], IFormatProvider, TimeSpanStyles, TimeSpan) .
formats
parametresi, öğeleri tek bir standart biçim belirticiden veya gerekli biçimini tanımlayan bir veya daha fazla özel biçim belirticiden oluşan bir dize dizisidirinput
. Geçerli biçim dizeleri hakkında daha fazla bilgi için bkz. Standart TimeSpan Biçim Dizeleri ve Özel TimeSpan Biçim Dizeleri.
input
ayrıştırma işleminin başarılı olması için bir üyesine formats
tam olarak karşılık olmalıdır. Ayrıştırma işlemi, dizideki ilk öğeden başlayarak içindeki formats
her öğeyle eşleşmeye input
çalışır.
Önemli
yöntemi, ParseExact parametresi tarafından formatProvider
belirtilen kültürün kurallarını yalnızca ayrıştırmak input
için kullanılan biçim dizesinin değeri "g" veya "G" olan standart TimeSpan bir biçim dizesi olması durumunda kullanır. "c", "t" ve "T" standart biçim dizeler sabit kültürün biçimlendirme kurallarını kullanır. Özel biçim dizeleri, giriş dizesinin kesin biçimini tanımlar ve zaman aralığı bileşenlerini ayırmak için değişmez karakterler kullanır.
formatProvider
parametresi, ayrıştırmak input
için kullanılan biçim dizesi standart bir IFormatProvider biçim dizesiyse, döndürülen dizenin biçimi hakkında kültüre özgü bilgiler sağlayan bir uygulamadır.
formatProvider
parametresi aşağıdakilerden biri olabilir:
CultureInfo Biçimlendirme kuralları döndürülen dizeye yansıtılacak olan kültürü temsil eden nesne. DateTimeFormatInfo özelliği tarafından CultureInfo.DateTimeFormat döndürülen nesne, döndürülen dizenin biçimlendirmesini tanımlar.
DateTimeFormatInfo Döndürülen dizenin biçimlendirmesini tanımlayan nesne.
Arabirimini uygulayan IFormatProvider özel bir nesne. yöntemi IFormatProvider.GetFormat , biçimlendirme bilgileri sağlayan bir DateTimeFormatInfo nesne döndürür.
ise formatProvider
null
, DateTimeFormatInfo geçerli kültürle ilişkili nesne kullanılır.
parametresi, styles
özel biçim dizeleri kullanılarak ayrıştırılan dizelerin yorumlanmasını etkiler. Negatif bir zaman aralığı olarak yorumlanıp yorumlanmayacağını input
, yalnızca negatif bir işaret (TimeSpanStyles.None varsa) veya her zaman negatif bir zaman aralığı (TimeSpanStyles.AssumeNegative) olarak yorumlanıp yorumlanmayacağını belirler. Kullanılmazsa TimeSpanStyles.AssumeNegative , format
negatif bir zaman aralığını başarıyla ayrıştırmak için değişmez negatif işareti simgesi ("\-" gibi) içermelidir.
Ayrıca bkz.
Şunlara uygulanır
ParseExact(String, String, IFormatProvider, TimeSpanStyles)
- Kaynak:
- TimeSpan.cs
- Kaynak:
- TimeSpan.cs
- Kaynak:
- TimeSpan.cs
Belirtilen biçimi, kültüre özgü biçim bilgilerini ve stilleri kullanarak bir zaman aralığının dize gösterimini eşdeğerine TimeSpan dönüştürür. Dize gösteriminin biçimi belirtilen biçimle tam olarak eşleşmelidir.
public:
static TimeSpan ParseExact(System::String ^ input, System::String ^ format, IFormatProvider ^ formatProvider, System::Globalization::TimeSpanStyles styles);
public static TimeSpan ParseExact (string input, string format, IFormatProvider formatProvider, System.Globalization.TimeSpanStyles styles);
public static TimeSpan ParseExact (string input, string format, IFormatProvider? formatProvider, System.Globalization.TimeSpanStyles styles);
static member ParseExact : string * string * IFormatProvider * System.Globalization.TimeSpanStyles -> TimeSpan
Public Shared Function ParseExact (input As String, format As String, formatProvider As IFormatProvider, styles As TimeSpanStyles) As TimeSpan
Parametreler
- input
- String
Dönüştürülecek zaman aralığını belirten bir dize.
- format
- String
Gerekli biçimini tanımlayan standart veya özel biçim input
dizesi.
- formatProvider
- IFormatProvider
Kültüre özgü biçimlendirme bilgilerini sağlayan nesne.
- styles
- TimeSpanStyles
içinde bulunabilecek input
stil öğelerini tanımlayan sabit listesi değerlerinin bit düzeyinde birleşimi.
Döndürülenler
, ve styles
tarafından format
formatProvider
belirtildiği gibi öğesine karşılık gelen input
bir zaman aralığı.
Özel durumlar
styles
geçersiz TimeSpanStyles bir değerdir.
input
, null
değeridir.
input
geçersiz bir biçime sahip.
input
TimeSpan.MinValue değerinden küçük veya TimeSpan.MaxValue değerinden büyük bir sayıyı temsil eder.
-veya-
içindeki input
gün, saat, dakika veya saniye bileşenlerinden en az biri geçerli aralığının dışındadır.
Örnekler
Aşağıdaki örnek, çeşitli biçim dizelerini ve kültürlerini kullanarak zaman aralıklarının çeşitli dize gösterimlerini ayrıştırmak için yöntemini kullanır ParseExact(String, String, IFormatProvider) . Ayrıca her dizeyi TimeSpanStyles.AssumeNegative negatif bir zaman aralığı olarak yorumlamak için değerini kullanır. Örnekteki çıktı, stilin TimeSpanStyles.AssumeNegative dönüş değerini yalnızca özel biçim dizeleriyle kullanıldığında etkilediğini gösterir.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
string intervalString, format;
TimeSpan interval;
CultureInfo culture = null;
// Parse hour:minute value with custom format specifier.
intervalString = "17:14";
format = "h\\:mm";
culture = CultureInfo.CurrentCulture;
try {
interval = TimeSpan.ParseExact(intervalString, format,
culture, TimeSpanStyles.AssumeNegative);
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse hour:minute:second value with "g" specifier.
intervalString = "17:14:48";
format = "g";
culture = CultureInfo.InvariantCulture;
try {
interval = TimeSpan.ParseExact(intervalString, format,
culture, TimeSpanStyles.AssumeNegative);
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse hours:minute.second value with custom format specifier.
intervalString = "17:14:48.153";
format = @"h\:mm\:ss\.fff";
culture = null;
try {
interval = TimeSpan.ParseExact(intervalString, format,
culture, TimeSpanStyles.AssumeNegative);
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse days:hours:minute.second value with "G" specifier
// and current (en-US) culture.
intervalString = "3:17:14:48.153";
format = "G";
culture = CultureInfo.CurrentCulture;
try {
interval = TimeSpan.ParseExact(intervalString, format,
culture, TimeSpanStyles.AssumeNegative);
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse days:hours:minute.second value with a custom format specifier.
intervalString = "3:17:14:48.153";
format = @"d\:hh\:mm\:ss\.fff";
culture = null;
try {
interval = TimeSpan.ParseExact(intervalString, format,
culture, TimeSpanStyles.AssumeNegative);
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse days:hours:minute.second value with "G" specifier
// and fr-FR culture.
intervalString = "3:17:14:48,153";
format = "G";
culture = new CultureInfo("fr-FR");
try {
interval = TimeSpan.ParseExact(intervalString, format,
culture, TimeSpanStyles.AssumeNegative);
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse a single number using the "c" standard format string.
intervalString = "12";
format = "c";
try {
interval = TimeSpan.ParseExact(intervalString, format,
null, TimeSpanStyles.AssumeNegative);
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse a single number using the "%h" custom format string.
format = "%h";
try {
interval = TimeSpan.ParseExact(intervalString, format,
null, TimeSpanStyles.AssumeNegative);
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse a single number using the "%s" custom format string.
format = "%s";
try {
interval = TimeSpan.ParseExact(intervalString, format,
null, TimeSpanStyles.AssumeNegative);
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
}
}
// The example displays the following output:
// '17:14' (h\:mm) --> -17:14:00
// '17:14:48' (g) --> 17:14:48
// '17:14:48.153' (h\:mm\:ss\.fff) --> -17:14:48.1530000
// '3:17:14:48.153' (G) --> 3.17:14:48.1530000
// '3:17:14:48.153' (d\:hh\:mm\:ss\.fff) --> -3.17:14:48.1530000
// '3:17:14:48,153' (G) --> 3.17:14:48.1530000
// '12' (c) --> 12.00:00:00
// '12' (%h) --> -12:00:00
// '12' (%s) --> -00:00:12
open System
open System.Globalization
do
// Parse hour:minute value with custom format specifier.
let intervalString = "17:14"
let format = "h\\:mm"
let culture = CultureInfo.CurrentCulture
try
let interval = TimeSpan.ParseExact(intervalString, format, culture, TimeSpanStyles.AssumeNegative)
printfn $"'{intervalString}' ({format}) --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse hour:minute:second value with "g" specifier.
let intervalString = "17:14:48"
let format = "g"
let culture = CultureInfo.InvariantCulture
try
let interval = TimeSpan.ParseExact(intervalString, format, culture, TimeSpanStyles.AssumeNegative)
printfn $"'{intervalString}' ({format}) --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse hours:minute.second value with custom format specifier.
let intervalString = "17:14:48.153"
let format = @"h\:mm\:ss\.fff"
let culture = null
try
let interval = TimeSpan.ParseExact(intervalString, format, culture, TimeSpanStyles.AssumeNegative)
printfn $"'{intervalString}' ({format}) --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse days:hours:minute.second value with "G" specifier
// and current (en-US) culture.
let intervalString = "3:17:14:48.153"
let format = "G"
let culture = CultureInfo.CurrentCulture
try
let interval = TimeSpan.ParseExact(intervalString, format, culture, TimeSpanStyles.AssumeNegative)
printfn $"'{intervalString}' ({format}) --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse days:hours:minute.second value with a custom format specifier.
let intervalString = "3:17:14:48.153"
let format = @"d\:hh\:mm\:ss\.fff"
let culture = null
try
let interval = TimeSpan.ParseExact(intervalString, format, culture, TimeSpanStyles.AssumeNegative)
printfn $"'{intervalString}' ({format}) --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse days:hours:minute.second value with "G" specifier
// and fr-FR culture.
let intervalString = "3:17:14:48,153"
let format = "G"
let culture = new CultureInfo("fr-FR")
try
let interval = TimeSpan.ParseExact(intervalString, format, culture, TimeSpanStyles.AssumeNegative)
printfn $"'{intervalString}' ({format}) --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse a single number using the "c" standard format string.
let intervalString = "12"
let format = "c"
try
let interval = TimeSpan.ParseExact(intervalString, format, null, TimeSpanStyles.AssumeNegative)
printfn $"'{intervalString}' ({format}) --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse a single number using the "%h" custom format string.
let format = "%h"
try
let interval = TimeSpan.ParseExact(intervalString, format, null, TimeSpanStyles.AssumeNegative)
printfn $"'{intervalString}' ({format}) --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse a single number using the "%s" custom format string.
let format = "%s"
try
let interval = TimeSpan.ParseExact(intervalString, format, null, TimeSpanStyles.AssumeNegative)
printfn $"'{intervalString}' ({format}) --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// The example displays the following output:
// '17:14' (h\:mm) --> -17:14:00
// '17:14:48' (g) --> 17:14:48
// '17:14:48.153' (h\:mm\:ss\.fff) --> -17:14:48.1530000
// '3:17:14:48.153' (G) --> 3.17:14:48.1530000
// '3:17:14:48.153' (d\:hh\:mm\:ss\.fff) --> -3.17:14:48.1530000
// '3:17:14:48,153' (G) --> 3.17:14:48.1530000
// '12' (c) --> 12.00:00:00
// '12' (%h) --> -12:00:00
// '12' (%s) --> -00:00:12
Imports System.Globalization
Module Example
Public Sub Main()
Dim intervalString, format As String
Dim interval As TimeSpan
Dim culture As CultureInfo = Nothing
' Parse hour:minute value with custom format specifier.
intervalString = "17:14"
format = "h\:mm"
culture = CultureInfo.CurrentCulture
Try
interval = TimeSpan.ParseExact(intervalString, format,
culture, TimeSpanStyles.AssumeNegative)
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse hour:minute:second value with "g" specifier.
intervalString = "17:14:48"
format = "g"
culture = CultureInfo.InvariantCulture
Try
interval = TimeSpan.ParseExact(intervalString, format,
culture, TimeSpanStyles.AssumeNegative)
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse hours:minute.second value with custom format specifier.
intervalString = "17:14:48.153"
format = "h\:mm\:ss\.fff"
culture = Nothing
Try
interval = TimeSpan.ParseExact(intervalString, format,
culture, TimeSpanStyles.AssumeNegative)
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse days:hours:minute.second value with "G" specifier
' and current (en-US) culture.
intervalString = "3:17:14:48.153"
format = "G"
culture = CultureInfo.CurrentCulture
Try
interval = TimeSpan.ParseExact(intervalString, format,
culture, TimeSpanStyles.AssumeNegative)
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse days:hours:minute.second value with a custom format specifier.
intervalString = "3:17:14:48.153"
format = "d\:hh\:mm\:ss\.fff"
culture = Nothing
Try
interval = TimeSpan.ParseExact(intervalString, format,
culture, TimeSpanStyles.AssumeNegative)
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse days:hours:minute.second value with "G" specifier
' and fr-FR culture.
intervalString = "3:17:14:48,153"
format = "G"
culture = New CultureInfo("fr-FR")
Try
interval = TimeSpan.ParseExact(intervalString, format,
culture, TimeSpanStyles.AssumeNegative)
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse a single number using the "c" standard format string.
intervalString = "12"
format = "c"
Try
interval = TimeSpan.ParseExact(intervalString, format,
Nothing, TimeSpanStyles.AssumeNegative)
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse a single number using the "%h" custom format string.
format = "%h"
Try
interval = TimeSpan.ParseExact(intervalString, format,
Nothing, TimeSpanStyles.AssumeNegative)
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse a single number using the "%s" custom format string.
format = "%s"
Try
interval = TimeSpan.ParseExact(intervalString, format,
Nothing, TimeSpanStyles.AssumeNegative)
Console.WriteLine("'{0}' ({1}) --> {2}", intervalString, format, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
End Sub
End Module
' The example displays the following output:
' '17:14' (h\:mm) --> -17:14:00
' '17:14:48' (g) --> 17:14:48
' '17:14:48.153' (h\:mm\:ss\.fff) --> -17:14:48.1530000
' '3:17:14:48.153' (G) --> 3.17:14:48.1530000
' '3:17:14:48.153' (d\:hh\:mm\:ss\.fff) --> -3.17:14:48.1530000
' '3:17:14:48,153' (G) --> 3.17:14:48.1530000
' '12' (c) --> 12.00:00:00
' '12' (%h) --> -12:00:00
' '12' (%s) --> -00:00:12
Açıklamalar
ParseExact yöntemi, baştaki ve sondaki boşluk karakterlerinin yoksayılması dışında, parametre tarafından format
tanımlanan biçimde olması gereken bir zaman aralığının dize gösterimini ayrıştırıyor.
input
Biçimine tam olarak uyması gerektiğindenformat
, kullanıcı tarafından bir dize girişini bir zaman aralığına dönüştürürken her zaman özel durum işlemeyi kullanmalısınız. Özel durum işlemeyi kullanmamayı tercih ederseniz, bunun yerine yöntemini çağırabilirsiniz TryParseExact(String, String, IFormatProvider, TimeSpanStyles, TimeSpan) .
format
parametresi, tek bir standart biçim tanımlayıcısı veya gerekli biçimini tanımlayan bir veya daha fazla özel biçim tanımlayıcısı içeren bir dizedirinput
. Geçerli biçim dizeleri hakkında daha fazla bilgi için bkz. Standart TimeSpan Biçim Dizeleri ve Özel TimeSpan Biçim Dizeleri.
Önemli
yöntemi, ParseExact parametresi tarafından formatProvider
belirtilen kültürün kurallarını yalnızca değeri "g" veya "G" olan standart TimeSpan bir biçim dizesiyse format
kullanır. "c", "t" ve "T" standart biçim dizeler sabit kültürün biçimlendirme kurallarını kullanır. Özel biçim dizeleri, giriş dizesinin kesin biçimini tanımlar ve zaman aralığı bileşenlerini ayırmak için değişmez karakterler kullanır.
formatProvider
parametresi, standart bir IFormatProvider biçim dizesiyse format
döndürülen dizenin biçimi hakkında kültüre özgü bilgiler sağlayan bir uygulamadır.
formatProvider
parametresi aşağıdakilerden biri olabilir:
CultureInfo Biçimlendirme kuralları döndürülen dizeye yansıtılacak olan kültürü temsil eden nesne. DateTimeFormatInfo özelliği tarafından CultureInfo.DateTimeFormat döndürülen nesne, döndürülen dizenin biçimlendirmesini tanımlar.
DateTimeFormatInfo Döndürülen dizenin biçimlendirmesini tanımlayan nesne.
Arabirimini uygulayan IFormatProvider özel bir nesne. IFormatProvider.GetFormat yöntemi, biçimlendirme bilgileri sağlayan bir DateTimeFormatInfo nesne döndürür.
ise formatProvider
null
, DateTimeFormatInfo geçerli kültürle ilişkili nesne kullanılır.
parametresi, styles
özel biçim dizeleri kullanılarak ayrıştırılan dizelerin yorumlanmasını etkiler. Negatif bir zaman aralığı olarak yorumlanıp yorumlanıp yorumlanmayacağını input
, yalnızca negatif bir işaret (TimeSpanStyles.None varsa) veya her zaman negatif bir zaman aralığı (TimeSpanStyles.AssumeNegative) olarak yorumlanıp yorumlanmayacağını belirler. Kullanılmazsa TimeSpanStyles.AssumeNegative , format
negatif bir zaman aralığını başarıyla ayrıştırmak için değişmez negatif işaret simgesi ("\-" gibi) içermelidir.
Ayrıca bkz.
Şunlara uygulanır
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, TimeSpanStyles)
- Kaynak:
- TimeSpan.cs
- Kaynak:
- TimeSpan.cs
- Kaynak:
- TimeSpan.cs
Belirtilen biçimleri, kültüre özgü biçim bilgilerini ve stilleri kullanarak bir zaman aralığının dize gösterimini eşdeğerine TimeSpan dönüştürür. Dize gösteriminin biçimi belirtilen biçimlerinden biriyle tam olarak eşleşmelidir.
public static TimeSpan ParseExact (ReadOnlySpan<char> input, string[] formats, IFormatProvider? formatProvider, System.Globalization.TimeSpanStyles styles = System.Globalization.TimeSpanStyles.None);
public static TimeSpan ParseExact (ReadOnlySpan<char> input, string[] formats, IFormatProvider formatProvider, System.Globalization.TimeSpanStyles styles = System.Globalization.TimeSpanStyles.None);
static member ParseExact : ReadOnlySpan<char> * string[] * IFormatProvider * System.Globalization.TimeSpanStyles -> TimeSpan
Public Shared Function ParseExact (input As ReadOnlySpan(Of Char), formats As String(), formatProvider As IFormatProvider, Optional styles As TimeSpanStyles = System.Globalization.TimeSpanStyles.None) As TimeSpan
Parametreler
- input
- ReadOnlySpan<Char>
Dönüştürülecek zaman aralığını belirten bir yayılma alanı.
- formats
- String[]
Gerekli biçimini tanımlayan standart veya özel biçim dizelerinden oluşan bir input
dizi.
- formatProvider
- IFormatProvider
Kültüre özgü biçimlendirme bilgilerini sağlayan nesne.
- styles
- TimeSpanStyles
Girişte bulunabilecek stil öğelerini tanımlayan numaralandırma değerlerinin bit düzeyinde birleşimi.
Döndürülenler
, ve styles
tarafından formats
formatProvider
belirtildiği gibi öğesine karşılık gelen input
bir zaman aralığı.
Şunlara uygulanır
ParseExact(String, String[], IFormatProvider)
- Kaynak:
- TimeSpan.cs
- Kaynak:
- TimeSpan.cs
- Kaynak:
- TimeSpan.cs
Belirtilen biçim dizeleri dizisini ve kültüre özgü biçim bilgilerini kullanarak bir zaman aralığının dize gösterimini TimeSpan eşdeğerine dönüştürür. Dize gösteriminin biçimi belirtilen biçimlerinden biriyle tam olarak eşleşmelidir.
public:
static TimeSpan ParseExact(System::String ^ input, cli::array <System::String ^> ^ formats, IFormatProvider ^ formatProvider);
public static TimeSpan ParseExact (string input, string[] formats, IFormatProvider formatProvider);
public static TimeSpan ParseExact (string input, string[] formats, IFormatProvider? formatProvider);
static member ParseExact : string * string[] * IFormatProvider -> TimeSpan
Public Shared Function ParseExact (input As String, formats As String(), formatProvider As IFormatProvider) As TimeSpan
Parametreler
- input
- String
Dönüştürülecek zaman aralığını belirten bir dize.
- formats
- String[]
Gerekli biçimini tanımlayan standart veya özel biçim dizelerinden oluşan bir input
dizi.
- formatProvider
- IFormatProvider
Kültüre özgü biçimlendirme bilgilerini sağlayan nesne.
Döndürülenler
ve formatProvider
tarafından formats
belirtildiği gibi öğesine karşılık gelen input
bir zaman aralığı.
Özel durumlar
input
, null
değeridir.
input
geçersiz bir biçime sahip.
input
TimeSpan.MinValue değerinden küçük veya TimeSpan.MaxValue değerinden büyük bir sayıyı temsil eder.
-veya-
içindeki input
gün, saat, dakika veya saniye bileşenlerinden en az biri geçerli aralığının dışındadır.
Örnekler
Aşağıdaki örnek, bir dize dizisinin ParseExact(String, String[], IFormatProvider) her öğesini bir TimeSpan değere dönüştürmek için yöntemini çağırır. Örnek, Fransızca - Fransa ("fr-FR") kültürünün biçimlendirme kurallarını kullanarak dizeleri yorumlar. Dizeler genel kısa biçim veya genel uzun biçimde bir zaman aralığını temsil edebilir.
Ayrıca örnek, zaman aralığı ayrıştırma yöntemlerinin tek bir basamağı yorumlama şeklini değiştirir. Normalde, bir tek basamaklı sayı, bir zaman aralığındaki gün sayısı olarak yorumlanır. Bunun yerine, %h
özel biçim dizesi tek bir rakamı saat sayısı olarak yorumlamak için kullanılır. Bu değişikliğin etkili olması için özel biçim dizesinin dizideki %h
formats
diğer biçim dizelerinden önce olması gerektiğini unutmayın.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
string[] inputs = { "3", "16:42", "1:6:52:35.0625",
"1:6:52:35,0625" };
string[] formats = { "g", "G", "%h"};
TimeSpan interval;
CultureInfo culture = new CultureInfo("fr-FR");
// Parse each string in inputs using formats and the fr-FR culture.
foreach (string input in inputs) {
try {
interval = TimeSpan.ParseExact(input, formats, culture);
Console.WriteLine("{0} --> {1:c}", input, interval);
}
catch (FormatException) {
Console.WriteLine("{0} --> Bad Format", input);
}
catch (OverflowException) {
Console.WriteLine("{0} --> Overflow", input);
}
}
}
}
// The example displays the following output:
// 3 --> 03:00:00
// 16:42 --> 16:42:00
// 1:6:52:35.0625 --> Bad Format
// 1:6:52:35,0625 --> 1.06:52:35.0625000
open System
open System.Globalization
let inputs = [| "3"; "16:42"; "1:6:52:35.0625"; "1:6:52:35,0625" |]
let formats = [| "g"; "G"; "%h" |]
let culture = CultureInfo "fr-FR"
// Parse each string in inputs using formats and the fr-FR culture.
for input in inputs do
try
let interval = TimeSpan.ParseExact(input, formats, culture)
printfn $"{input} --> {interval:c}"
with
| :? FormatException ->
printfn $"{input} --> Bad Format"
| :? OverflowException ->
printfn $"{input} --> Overflow"
// The example displays the following output:
// 3 --> 03:00:00
// 16:42 --> 16:42:00
// 1:6:52:35.0625 --> Bad Format
// 1:6:52:35,0625 --> 1.06:52:35.0625000
Imports System.Globalization
Module Example
Public Sub Main()
Dim inputs() As String = { "3", "16:42", "1:6:52:35.0625",
"1:6:52:35,0625" }
Dim formats() As String = { "%h", "g", "G" }
Dim interval As TimeSpan
Dim culture As New CultureInfo("fr-FR")
' Parse each string in inputs using formats and the fr-FR culture.
For Each input As String In inputs
Try
interval = TimeSpan.ParseExact(input, formats, culture)
Console.WriteLine("{0} --> {1:c}", input, interval)
Catch e As FormatException
Console.WriteLine("{0} --> Bad Format", input)
Catch e As OverflowException
Console.WriteLine("{0} --> Overflow", input)
End Try
Next
End Sub
End Module
' The example displays the following output:
' 3 --> 3.00:00:00
' 16:42 --> 16:42:00
' 1:6:52:35.0625 --> Bad Format
' 1:6:52:35,0625 --> 1.06:52:35.0625000
Açıklamalar
ParseExact(String, String, IFormatProvider) yöntemi, bir zaman aralığının dize gösterimini ayrıştırarak, baştaki ve sondaki boşluk karakterlerinin yoksayılması dışında parametresi tarafından formats
tanımlanan biçimlerden birinde olması gerekir. içinde input
belirtilen formats
biçimlerden birine tam olarak uyması gerektiğinden, kullanıcı tarafından bir dize girişini zaman aralığına dönüştürürken her zaman özel durum işlemeyi kullanmalısınız. Özel durum işlemeyi kullanmamayı tercih ederseniz, bunun yerine yöntemini çağırabilirsiniz TryParseExact(String, String[], IFormatProvider, TimeSpan) .
formats
parametresi, öğeleri tek bir standart biçim belirticiden veya gerekli biçimini tanımlayan bir veya daha fazla özel biçim belirticiden oluşan bir dize dizisidirinput
. Geçerli biçim dizeleri hakkında daha fazla bilgi için bkz . Standart TimeSpan Biçim Dizeleri ve Özel TimeSpan Biçim Dizeleri.
input
ayrıştırma işleminin başarılı olması için bir üyesine formats
tam olarak karşılık olmalıdır. Ayrıştırma işlemi, dizideki formats
ilk öğeyle başlayarak içindeki her öğeyle eşleşmeye input
çalışır.
Önemli
yöntemi, ParseExact parametresi tarafından formatProvider
belirtilen kültürün kurallarını yalnızca ayrıştırmak input
için kullanılan biçim dizesinin değeri "g" veya "G" olan standart TimeSpan bir biçim dizesi olması durumunda kullanır. "c", "t" ve "T" standart biçim dizeler sabit kültürün biçimlendirme kurallarını kullanır. Özel biçim dizeleri, giriş dizesinin kesin biçimini tanımlar ve zaman aralığı bileşenlerini ayırmak için değişmez karakterler kullanır.
formatProvider
parametresi, ayrıştırmak input
için kullanılan biçim dizesi standart bir IFormatProvider biçim dizesiyse döndürülen dizenin biçimi hakkında kültüre özgü bilgiler sağlayan bir uygulamadır.
formatProvider
parametresi aşağıdakilerden biri olabilir:
CultureInfo Biçimlendirme kuralları döndürülen dizeye yansıtılacak olan kültürü temsil eden bir nesne. DateTimeFormatInfo özelliği tarafından CultureInfo.DateTimeFormat döndürülen nesne, döndürülen dizenin biçimlendirmesini tanımlar.
DateTimeFormatInfo Döndürülen dizenin biçimlendirmesini tanımlayan bir nesne.
Arabirimini uygulayan IFormatProvider özel bir nesne. IFormatProvider.GetFormat yöntemi, biçimlendirme bilgileri sağlayan bir DateTimeFormatInfo nesne döndürür.
ise formatProvider
null
, DateTimeFormatInfo geçerli kültürle ilişkili nesne kullanılır.
Ayrıca bkz.
- TryParseExact(String, String[], IFormatProvider, TimeSpan)
- Standart TimeSpan Biçim Dizeleri
- Özel TimeSpan Biçim Dizeleri
Şunlara uygulanır
ParseExact(String, String, IFormatProvider)
- Kaynak:
- TimeSpan.cs
- Kaynak:
- TimeSpan.cs
- Kaynak:
- TimeSpan.cs
Belirtilen biçimi ve kültüre özgü biçim bilgilerini kullanarak bir zaman aralığının dize gösterimini eşdeğerine TimeSpan dönüştürür. Dize gösteriminin biçimi belirtilen biçimle tam olarak eşleşmelidir.
public:
static TimeSpan ParseExact(System::String ^ input, System::String ^ format, IFormatProvider ^ formatProvider);
public static TimeSpan ParseExact (string input, string format, IFormatProvider formatProvider);
public static TimeSpan ParseExact (string input, string format, IFormatProvider? formatProvider);
static member ParseExact : string * string * IFormatProvider -> TimeSpan
Public Shared Function ParseExact (input As String, format As String, formatProvider As IFormatProvider) As TimeSpan
Parametreler
- input
- String
Dönüştürülecek zaman aralığını belirten bir dize.
- format
- String
Gerekli biçimini tanımlayan standart veya özel biçim input
dizesi.
- formatProvider
- IFormatProvider
Kültüre özgü biçimlendirme bilgilerini sağlayan nesne.
Döndürülenler
ve formatProvider
tarafından format
belirtildiği gibi öğesine karşılık gelen input
bir zaman aralığı.
Özel durumlar
input
, null
değeridir.
input
geçersiz bir biçime sahip.
input
TimeSpan.MinValue değerinden küçük veya TimeSpan.MaxValue değerinden büyük bir sayıyı temsil eder.
-veya-
içindeki input
gün, saat, dakika veya saniye bileşenlerinden en az biri geçerli aralığının dışındadır.
Örnekler
Aşağıdaki örnek, çeşitli biçim dizelerini ve kültürlerini kullanarak zaman aralıklarının çeşitli dize gösterimlerini ayrıştırmak için yöntemini kullanır ParseExact(String, String, IFormatProvider) .
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
string intervalString, format;
TimeSpan interval;
CultureInfo culture;
// Parse hour:minute value with "g" specifier current culture.
intervalString = "17:14";
format = "g";
culture = CultureInfo.CurrentCulture;
try {
interval = TimeSpan.ParseExact(intervalString, format, culture);
Console.WriteLine("'{0}' --> {1}", intervalString, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'",
intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse hour:minute:second value with "G" specifier.
intervalString = "17:14:48";
format = "G";
culture = CultureInfo.InvariantCulture;
try {
interval = TimeSpan.ParseExact(intervalString, format, culture);
Console.WriteLine("'{0}' --> {1}", intervalString, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse hours:minute.second value with "G" specifier
// and current (en-US) culture.
intervalString = "17:14:48.153";
format = "G";
culture = CultureInfo.CurrentCulture;
try {
interval = TimeSpan.ParseExact(intervalString, format, culture);
Console.WriteLine("'{0}' --> {1}", intervalString, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse days:hours:minute.second value with "G" specifier
// and current (en-US) culture.
intervalString = "3:17:14:48.153";
format = "G";
culture = CultureInfo.CurrentCulture;
try {
interval = TimeSpan.ParseExact(intervalString, format, culture);
Console.WriteLine("'{0}' --> {1}", intervalString, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse days:hours:minute.second value with "G" specifier
// and fr-FR culture.
intervalString = "3:17:14:48.153";
format = "G";
culture = new CultureInfo("fr-FR");
try {
interval = TimeSpan.ParseExact(intervalString, format, culture);
Console.WriteLine("'{0}' --> {1}", intervalString, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse days:hours:minute.second value with "G" specifier
// and fr-FR culture.
intervalString = "3:17:14:48,153";
format = "G";
try {
interval = TimeSpan.ParseExact(intervalString, format, culture);
Console.WriteLine("'{0}' --> {1}", intervalString, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse a single number using the "c" standard format string.
intervalString = "12";
format = "c";
try {
interval = TimeSpan.ParseExact(intervalString, format, null);
Console.WriteLine("'{0}' --> {1}", intervalString, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse a single number using the "%h" custom format string.
format = "%h";
try {
interval = TimeSpan.ParseExact(intervalString, format, null);
Console.WriteLine("'{0}' --> {1}", intervalString, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
// Parse a single number using the "%s" custom format string.
format = "%s";
try {
interval = TimeSpan.ParseExact(intervalString, format, null);
Console.WriteLine("'{0}' --> {1}", intervalString, interval);
}
catch (FormatException) {
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format);
}
catch (OverflowException) {
Console.WriteLine("'{0}': Overflow", intervalString);
}
}
}
// The example displays the following output:
// '17:14' --> 17:14:00
// '17:14:48': Bad Format for 'G'
// '17:14:48.153': Bad Format for 'G'
// '3:17:14:48.153' --> 3.17:14:48.1530000
// '3:17:14:48.153': Bad Format for 'G'
// '3:17:14:48,153' --> 3.17:14:48.1530000
// '12' --> 12.00:00:00
// '12' --> 12:00:00
// '12' --> 00:00:12
open System
open System.Globalization
do
// Parse hour:minute value with "g" specifier current culture.
let intervalString = "17:14"
let format = "g"
let culture = CultureInfo.CurrentCulture
try
let interval = TimeSpan.ParseExact(intervalString, format, culture)
printfn $"'{intervalString}' --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse hour:minute:second value with "G" specifier.
let intervalString = "17:14:48"
let format = "G"
let culture = CultureInfo.InvariantCulture
try
let interval = TimeSpan.ParseExact(intervalString, format, culture)
printfn $"'{intervalString}' --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse hours:minute.second value with "G" specifier
// and current (en-US) culture.
let intervalString = "17:14:48.153"
let format = "G"
let culture = CultureInfo.CurrentCulture
try
let interval = TimeSpan.ParseExact(intervalString, format, culture)
printfn $"'{intervalString}' --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse days:hours:minute.second value with "G" specifier
// and current (en-US) culture.
let intervalString = "3:17:14:48.153"
let format = "G"
let culture = CultureInfo.CurrentCulture
try
let interval = TimeSpan.ParseExact(intervalString, format, culture)
printfn $"'{intervalString}' --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse days:hours:minute.second value with "G" specifier
// and fr-FR culture.
let intervalString = "3:17:14:48.153"
let format = "G"
let culture = CultureInfo "fr-FR"
try
let interval = TimeSpan.ParseExact(intervalString, format, culture)
printfn $"'{intervalString}' --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse days:hours:minute.second value with "G" specifier
// and fr-FR culture.
let intervalString = "3:17:14:48,153"
let format = "G"
try
let interval = TimeSpan.ParseExact(intervalString, format, culture)
printfn $"'{intervalString}' --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse a single number using the "c" standard format string.
let intervalString = "12"
let format = "c"
try
let interval = TimeSpan.ParseExact(intervalString, format, null)
printfn $"'{intervalString}' --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse a single number using the "%h" custom format string.
let format = "%h"
try
let interval = TimeSpan.ParseExact(intervalString, format, null)
printfn $"'{intervalString}' --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// Parse a single number using the "%s" custom format string.
let format = "%s"
try
let interval = TimeSpan.ParseExact(intervalString, format, null)
printfn $"'{intervalString}' --> {interval}"
with
| :? FormatException ->
printfn $"'{intervalString}': Bad Format for '{format}'"
| :? OverflowException ->
printfn $"'{intervalString}': Overflow"
// The example displays the following output:
// '17:14' --> 17:14:00
// '17:14:48': Bad Format for 'G'
// '17:14:48.153': Bad Format for 'G'
// '3:17:14:48.153' --> 3.17:14:48.1530000
// '3:17:14:48.153': Bad Format for 'G'
// '3:17:14:48,153' --> 3.17:14:48.1530000
// '12' --> 12.00:00:00
// '12' --> 12:00:00
// '12' --> 00:00:12
Imports System.Globalization
Module Example
Public Sub Main()
Dim intervalString, format As String
Dim interval As TimeSpan
Dim culture As CultureInfo
' Parse hour:minute value with "g" specifier current culture.
intervalString = "17:14"
format = "g"
culture = CultureInfo.CurrentCulture
Try
interval = TimeSpan.ParseExact(intervalString, format, culture)
Console.WriteLine("'{0}' --> {1}", intervalString, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse hour:minute:second value with "G" specifier.
intervalString = "17:14:48"
format = "G"
culture = CultureInfo.InvariantCulture
Try
interval = TimeSpan.ParseExact(intervalString, format, culture)
Console.WriteLine("'{0}' --> {1}", intervalString, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse hours:minute.second value with "G" specifier
' and current (en-US) culture.
intervalString = "17:14:48.153"
format = "G"
culture = CultureInfo.CurrentCulture
Try
interval = TimeSpan.ParseExact(intervalString, format, culture)
Console.WriteLine("'{0}' --> {1}", intervalString, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse days:hours:minute.second value with "G" specifier
' and current (en-US) culture.
intervalString = "3:17:14:48.153"
format = "G"
culture = CultureInfo.CurrentCulture
Try
interval = TimeSpan.ParseExact(intervalString, format, culture)
Console.WriteLine("'{0}' --> {1}", intervalString, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse days:hours:minute.second value with "G" specifier
' and fr-FR culture.
intervalString = "3:17:14:48.153"
format = "G"
culture = New CultureInfo("fr-FR")
Try
interval = TimeSpan.ParseExact(intervalString, format, culture)
Console.WriteLine("'{0}' --> {1}", intervalString, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse days:hours:minute.second value with "G" specifier
' and fr-FR culture.
intervalString = "3:17:14:48,153"
format = "G"
culture = New CultureInfo("fr-FR")
Try
interval = TimeSpan.ParseExact(intervalString, format, culture)
Console.WriteLine("'{0}' --> {1}", intervalString, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse a single number using the "c" standard format string.
intervalString = "12"
format = "c"
Try
interval = TimeSpan.ParseExact(intervalString, format, Nothing)
Console.WriteLine("'{0}' --> {1}", intervalString, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse a single number using the "%h" custom format string.
format = "%h"
Try
interval = TimeSpan.ParseExact(intervalString, format, Nothing)
Console.WriteLine("'{0}' --> {1}", intervalString, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
' Parse a single number using the "%s" custom format string.
format = "%s"
Try
interval = TimeSpan.ParseExact(intervalString, format, Nothing)
Console.WriteLine("'{0}' --> {1}", intervalString, interval)
Catch e As FormatException
Console.WriteLine("'{0}': Bad Format for '{1}'", intervalString, format)
Catch e As OverflowException
Console.WriteLine("'{0}': Overflow", intervalString)
End Try
End Sub
End Module
' The example displays the following output:
' '17:14' --> 17:14:00
' '17:14:48': Bad Format for 'G'
' '17:14:48.153': Bad Format for 'G'
' '3:17:14:48.153' --> 3.17:14:48.1530000
' '3:17:14:48.153': Bad Format for 'G'
' '3:17:14:48,153' --> 3.17:14:48.1530000
' '12' --> 12.00:00:00
' '12' --> 12:00:00
' '12' --> 00:00:12
Açıklamalar
ParseExact(String, String, IFormatProvider) yöntemi, baştaki ve sondaki boşluk karakterlerinin yoksayılması dışında, parametre tarafından format
tanımlanan biçimde olması gereken bir zaman aralığının dize gösterimini ayrıştırıyor.
input
Biçimine tam olarak uyması gerektiğindenformat
, kullanıcı tarafından bir dize girişini zaman aralığına dönüştürürken her zaman özel durum işlemeyi kullanmanız gerekir. Özel durum işlemeyi kullanmamayı tercih ederseniz, bunun yerine yöntemini çağırabilirsiniz TryParseExact(String, String, IFormatProvider, TimeSpan) .
format
parametresi, tek bir standart biçim belirticisi veya gerekli biçimini tanımlayan bir veya daha fazla özel biçim belirticisi içeren bir dizedirinput
. Geçerli biçim dizeleri hakkında daha fazla bilgi için bkz . Standart TimeSpan Biçim Dizeleri ve Özel TimeSpan Biçim Dizeleri.
Önemli
yöntemi, ParseExact parametresi tarafından formatProvider
belirtilen kültürün kurallarını yalnızca değeri "g" veya "G" olan standart TimeSpan bir biçim dizesiyse format
kullanır. "c", "t" ve "T" standart biçim dizeler sabit kültürün biçimlendirme kurallarını kullanır. Özel biçim dizeleri, giriş dizesinin kesin biçimini tanımlar ve zaman aralığı bileşenlerini ayırmak için değişmez karakterler kullanır.
formatProvider
parametresi, standart bir IFormatProvider biçim dizesiyse format
döndürülen dizenin biçimi hakkında kültüre özgü bilgiler sağlayan bir uygulamadır.
formatProvider
parametresi aşağıdakilerden biri olabilir:
CultureInfo Biçimlendirme kuralları döndürülen dizeye yansıtılacak olan kültürü temsil eden bir nesne. DateTimeFormatInfo özelliği tarafından CultureInfo.DateTimeFormat döndürülen nesne, döndürülen dizenin biçimlendirmesini tanımlar.
DateTimeFormatInfo Döndürülen dizenin biçimlendirmesini tanımlayan bir nesne.
Arabirimini uygulayan IFormatProvider özel bir nesne. IFormatProvider.GetFormat yöntemi, biçimlendirme bilgileri sağlayan bir DateTimeFormatInfo nesne döndürür.
ise formatProvider
null
, DateTimeFormatInfo geçerli kültürle ilişkili nesne kullanılır.
Ayrıca bkz.
Şunlara uygulanır
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, TimeSpanStyles)
- Kaynak:
- TimeSpan.cs
- Kaynak:
- TimeSpan.cs
- Kaynak:
- TimeSpan.cs
Belirtilen biçimi ve kültüre özgü biçim bilgilerini kullanarak bir zaman aralığının karakter aralığını eşdeğerine TimeSpan dönüştürür. Dize gösteriminin biçimi belirtilen biçimle tam olarak eşleşmelidir.
public static TimeSpan ParseExact (ReadOnlySpan<char> input, ReadOnlySpan<char> format, IFormatProvider? formatProvider, System.Globalization.TimeSpanStyles styles = System.Globalization.TimeSpanStyles.None);
public static TimeSpan ParseExact (ReadOnlySpan<char> input, ReadOnlySpan<char> format, IFormatProvider formatProvider, System.Globalization.TimeSpanStyles styles = System.Globalization.TimeSpanStyles.None);
static member ParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> * IFormatProvider * System.Globalization.TimeSpanStyles -> TimeSpan
Public Shared Function ParseExact (input As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char), formatProvider As IFormatProvider, Optional styles As TimeSpanStyles = System.Globalization.TimeSpanStyles.None) As TimeSpan
Parametreler
- input
- ReadOnlySpan<Char>
Dönüştürülecek zaman aralığını belirten bir yayılma alanı.
- format
- ReadOnlySpan<Char>
Gerekli biçimini tanımlayan standart veya özel biçim input
dizesi.
- formatProvider
- IFormatProvider
Kültüre özgü biçimlendirme bilgilerini sağlayan nesne.
- styles
- TimeSpanStyles
içinde bulunabilecek input
stil öğelerini tanımlayan sabit listesi değerlerinin bit düzeyinde birleşimi.
Döndürülenler
ve formatProvider
tarafından format
belirtildiği gibi öğesine karşılık gelen input
bir zaman aralığı.
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin