TimeSpan.ParseExact Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Převede řetězcovou reprezentaci časového intervalu na jeho TimeSpan ekvivalent. Formát řetězcového vyjádření musí přesně odpovídat určenému formátu.
Přetížení
ParseExact(String, String[], IFormatProvider, TimeSpanStyles) |
Převede řetězcovou reprezentaci časového intervalu na jeho TimeSpan ekvivalent pomocí zadaných formátů, informací o formátu specifické pro jazykovou verzi a stylů. Formát řetězcového vyjádření musí přesně odpovídat jednomu z určených formátů. |
ParseExact(String, String, IFormatProvider, TimeSpanStyles) |
Převede řetězcovou reprezentaci časového intervalu na jeho TimeSpan ekvivalent pomocí zadaného formátu, informací o formátu specifické pro jazykovou verzi a stylů. Formát řetězcového vyjádření musí přesně odpovídat určenému formátu. |
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, TimeSpanStyles) |
Převede řetězcovou reprezentaci časového intervalu na jeho TimeSpan ekvivalent pomocí zadaných formátů, informací o formátu specifické pro jazykovou verzi a stylů. Formát řetězcového vyjádření musí přesně odpovídat jednomu z určených formátů. |
ParseExact(String, String[], IFormatProvider) |
Převede řetězcovou reprezentaci časového intervalu na jeho TimeSpan ekvivalent pomocí zadané pole formátovací řetězce a informace o formátu specifické pro jazykovou verzi. Formát řetězcového vyjádření musí přesně odpovídat jednomu z určených formátů. |
ParseExact(String, String, IFormatProvider) |
Převede řetězcovou reprezentaci časového intervalu na jeho TimeSpan ekvivalent pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi. Formát řetězcového vyjádření musí přesně odpovídat určenému formátu. |
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, TimeSpanStyles) |
Převede rozsah znaků časového intervalu na jeho TimeSpan ekvivalent pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi. Formát řetězcového vyjádření musí přesně odpovídat určenému formátu. |
ParseExact(String, String[], IFormatProvider, TimeSpanStyles)
- Zdroj:
- TimeSpan.cs
- Zdroj:
- TimeSpan.cs
- Zdroj:
- TimeSpan.cs
Převede řetězcovou reprezentaci časového intervalu na jeho TimeSpan ekvivalent pomocí zadaných formátů, informací o formátu specifické pro jazykovou verzi a stylů. Formát řetězcového vyjádření musí přesně odpovídat jednomu z určených formátů.
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
Parametry
- input
- String
Řetězec, který určuje časový interval k převedení.
- formats
- String[]
Pole standardních nebo vlastních formátových řetězců, které definují požadovaný formát objektu input
.
- formatProvider
- IFormatProvider
Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.
- styles
- TimeSpanStyles
Bitové kombinace hodnot výčtu, která definuje prvky stylu, které mohou být přítomny ve vstupu.
Návraty
Časový interval, který odpovídá hodnotě input
, jak je uvedeno v parametrech formats
, formatProvider
a styles
.
Výjimky
styles
je neplatná TimeSpanStyles hodnota.
input
je null
.
input
má neplatný formát.
input
představuje číslo, které je menší než TimeSpan.MinValue nebo větší než TimeSpan.MaxValue.
-nebo-
Alespoň jedna ze součástí dnů, hodin, minut nebo sekund je mimo input
platný rozsah.
Příklady
Následující příklad volá metodu ParseExact(String, String[], IFormatProvider, TimeSpanStyles) pro převod každého prvku pole řetězců na TimeSpan hodnotu. Řetězce mohou vyjadřovat časový interval buďto v obecném krátkém formátu, nebo v obecném dlouhém formátu.
Kromě toho se v tomto příkladu mění způsob, kterým metody analýzy časového intervalu interpretují jednu číslici. Obvykle je jedna číslice interpretována jako počet dnů v časovém intervalu. Místo toho se řetězec vlastního %h
formátu používá k interpretaci jedné číslice jako počtu hodin. Aby byla tato změna platná, musí řetězec vlastního %h
formátu předcházet ostatním řetězcům formátu v formats
poli. Z výstupu si také všimněte, že TimeSpanStyles.AssumeNegative příznak zadaný ve volání metody se používá pouze při analýze řetězce s tímto specifikátorem formátu.
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
Poznámky
Metoda ParseExact(String, String[], IFormatProvider, TimeSpanStyles) parsuje řetězcovou reprezentaci časového intervalu, který musí být v jednom z formátů definovaných parametrem, s tím rozdílem formats
, že počáteční a koncové prázdné znaky jsou ignorovány. Vzhledem k tomu, input
že musí přesně odpovídat jednomu z formátů zadaných v formats
nástroji , měli byste při převodu řetězcového vstupu uživatele na časový interval vždy použít zpracování výjimek. Pokud nechcete používat zpracování výjimek, můžete místo toho volat metodu TryParseExact(String, String[], IFormatProvider, TimeSpanStyles, TimeSpan) .
Parametr formats
je pole řetězců, jehož prvky se skládají buď z jednoho specifikátoru standardního formátu, nebo jednoho nebo více specifikátorů vlastního formátu, které definují požadovaný formát .input
Další informace o platných formátových řetězcích najdete v tématu Standardní řetězce formátu TimeSpan a Vlastní řetězce formátu TimeSpan. input
musí přesně odpovídat členu, formats
aby operace parse byla úspěšná. Operace parse se pokusí shodovat input
s každým prvkem počínaje formats
prvním prvkem v poli.
Důležité
Metoda ParseExact používá konvence jazykové verze určené parametrem formatProvider
pouze v případě, že formátovací řetězec použitý k analýze input
je řetězec standardního TimeSpan formátu, jehož hodnota je buď "g" nebo "G". Standardní řetězce formátu "c", "t" a "T" používají konvence formátování invariantní jazykové verze. Vlastní formátovací řetězce definují přesný formát vstupního řetězce a pomocí literálových znaků oddělují části časového intervalu.
Parametr formatProvider
je IFormatProvider implementace, která poskytuje informace specifické pro jazykovou verzi o formátu vráceného řetězce, pokud formátovací řetězec použitý k analýze input
je standardní formátovací řetězec. Parametr formatProvider
může být některý z následujících parametrů:
Objekt CultureInfo , který představuje jazykovou verzi, jejíž konvence formátování se mají promítnout do vráceného řetězce. Objekt DateTimeFormatInfo vrácený CultureInfo.DateTimeFormat vlastností definuje formátování vráceného řetězce.
Objekt DateTimeFormatInfo , který definuje formátování vráceného řetězce.
Vlastní objekt, který implementuje IFormatProvider rozhraní. Jeho IFormatProvider.GetFormat metoda vrátí DateTimeFormatInfo objekt, který poskytuje informace o formátování.
Pokud formatProvider
je null
, použije se DateTimeFormatInfo objekt přidružený k aktuální jazykové verzi.
Parametr styles
ovlivňuje interpretaci řetězců, které jsou analyzovány pomocí řetězců vlastního formátu. Určuje, zda input
je interpretován jako záporný časový interval pouze v případě, že je přítomno záporné znaménko (TimeSpanStyles.None), nebo zda je vždy interpretován jako záporný časový interval (TimeSpanStyles.AssumeNegative). Pokud TimeSpanStyles.AssumeNegative se nepoužívá, format
musí obsahovat symbol literálového záporného znaménka (například \-), aby bylo možné úspěšně parsovat záporný časový interval.
Viz také
Platí pro
ParseExact(String, String, IFormatProvider, TimeSpanStyles)
- Zdroj:
- TimeSpan.cs
- Zdroj:
- TimeSpan.cs
- Zdroj:
- TimeSpan.cs
Převede řetězcovou reprezentaci časového intervalu na jeho TimeSpan ekvivalent pomocí zadaného formátu, informací o formátu specifické pro jazykovou verzi a stylů. Formát řetězcového vyjádření musí přesně odpovídat určenému formátu.
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
Parametry
- input
- String
Řetězec, který určuje časový interval k převedení.
- format
- String
Standardní nebo vlastní formátovací řetězec, který definuje požadovaný formát souboru input
.
- formatProvider
- IFormatProvider
Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.
- styles
- TimeSpanStyles
Bitové kombinace hodnot výčtu, která definuje prvky stylu, které mohou být přítomny v input
.
Návraty
Časový interval, který odpovídá hodnotě input
, jak je uvedeno v parametrech format
, formatProvider
a styles
.
Výjimky
styles
je neplatná TimeSpanStyles hodnota.
input
je null
.
input
má neplatný formát.
input
představuje číslo, které je menší než TimeSpan.MinValue nebo větší než TimeSpan.MaxValue.
-nebo-
Alespoň jedna ze součástí dnů, hodin, minut nebo sekund je mimo input
platný rozsah.
Příklady
Následující příklad používá metodu ParseExact(String, String, IFormatProvider) k analýze několika řetězcových reprezentací časových intervalů pomocí různých formátových řetězců a jazykových verzí. Používá také TimeSpanStyles.AssumeNegative hodnotu k interpretaci každého řetězce jako záporného časového intervalu. Výstup z příkladu ukazuje, že styl ovlivňuje návratovou hodnotu pouze v případě, že TimeSpanStyles.AssumeNegative je použit s vlastními formátovacími řetězci.
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
Poznámky
Metoda ParseExact parsuje řetězcovou reprezentaci časového intervalu, který musí být ve formátu definovaném format
parametrem, s tím rozdílem, že počáteční a koncové prázdné znaky jsou ignorovány. Vzhledem k tomu input
, že se musí přesně shodovat s formátem format
, měli byste při převodu řetězcového vstupu uživatelem na časový interval vždy použít zpracování výjimek. Pokud nechcete používat zpracování výjimek, můžete místo toho volat metodu TryParseExact(String, String, IFormatProvider, TimeSpanStyles, TimeSpan) .
Parametr format
je řetězec, který obsahuje buď jeden specifikátor standardního formátu, nebo jeden nebo více specifikátorů vlastního formátu, které definují požadovaný formát .input
Další informace o platných formátových řetězcích najdete v tématu Standardní řetězce formátu TimeSpan a Vlastní řetězce formátu TimeSpan.
Důležité
Metoda ParseExact používá konvence jazykové verze určené parametrem formatProvider
pouze v případě, že format
je standardní TimeSpan formátovací řetězec, jehož hodnota je buď "g" nebo "G". Standardní řetězce formátu "c", "t" a "T" používají konvence formátování invariantní jazykové verze. Vlastní formátovací řetězce definují přesný formát vstupního řetězce a pomocí literálových znaků oddělují části časového intervalu.
Parametr formatProvider
je IFormatProvider implementace, která poskytuje informace specifické pro jazykovou verzi o formátu vráceného řetězce, pokud format
je standardní formátovací řetězec. Parametr formatProvider
může být některý z následujících parametrů:
Objekt CultureInfo , který představuje jazykovou verzi, jejíž konvence formátování se mají promítnout do vráceného řetězce. Objekt DateTimeFormatInfo vrácený CultureInfo.DateTimeFormat vlastností definuje formátování vráceného řetězce.
Objekt DateTimeFormatInfo , který definuje formátování vráceného řetězce.
Vlastní objekt, který implementuje IFormatProvider rozhraní. Jeho IFormatProvider.GetFormat metoda vrátí DateTimeFormatInfo objekt, který poskytuje informace o formátování.
Pokud formatProvider
je null
, použije se DateTimeFormatInfo objekt přidružený k aktuální jazykové verzi.
Parametr styles
ovlivňuje interpretaci řetězců, které jsou analyzovány pomocí řetězců vlastního formátu. Určuje, zda input
je interpretován jako záporný časový interval pouze v případě, že je přítomno záporné znaménko (TimeSpanStyles.None), nebo zda je vždy interpretován jako záporný časový interval (TimeSpanStyles.AssumeNegative). Pokud TimeSpanStyles.AssumeNegative se nepoužívá, format
musí obsahovat symbol literálového záporného znaménka (například \-), aby bylo možné úspěšně parsovat záporný časový interval.
Viz také
Platí pro
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, TimeSpanStyles)
- Zdroj:
- TimeSpan.cs
- Zdroj:
- TimeSpan.cs
- Zdroj:
- TimeSpan.cs
Převede řetězcovou reprezentaci časového intervalu na jeho TimeSpan ekvivalent pomocí zadaných formátů, informací o formátu specifické pro jazykovou verzi a stylů. Formát řetězcového vyjádření musí přesně odpovídat jednomu z určených formátů.
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
Parametry
- input
- ReadOnlySpan<Char>
Rozsah, který určuje časový interval, který se má převést.
- formats
- String[]
Pole standardních nebo vlastních formátových řetězců, které definují požadovaný formát objektu input
.
- formatProvider
- IFormatProvider
Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.
- styles
- TimeSpanStyles
Bitové kombinace hodnot výčtu, která definuje prvky stylu, které mohou být přítomny ve vstupu.
Návraty
Časový interval, který odpovídá hodnotě input
, jak je uvedeno v parametrech formats
, formatProvider
a styles
.
Platí pro
ParseExact(String, String[], IFormatProvider)
- Zdroj:
- TimeSpan.cs
- Zdroj:
- TimeSpan.cs
- Zdroj:
- TimeSpan.cs
Převede řetězcovou reprezentaci časového intervalu na jeho TimeSpan ekvivalent pomocí zadané pole formátovací řetězce a informace o formátu specifické pro jazykovou verzi. Formát řetězcového vyjádření musí přesně odpovídat jednomu z určených formátů.
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
Parametry
- input
- String
Řetězec, který určuje časový interval k převedení.
- formats
- String[]
Pole řetězců standardního nebo vlastního formátu, které definují požadovaný formát objektu input
.
- formatProvider
- IFormatProvider
Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.
Návraty
Časový interval, který odpovídá hodnotě input
, jak je uvedeno v parametrech formats
a formatProvider
.
Výjimky
input
je null
.
input
má neplatný formát.
input
představuje číslo, které je menší než TimeSpan.MinValue nebo větší než TimeSpan.MaxValue.
-nebo-
Alespoň jedna ze součástí dnů, hodin, minut nebo sekund je mimo input
platný rozsah.
Příklady
Následující příklad volá metodu ParseExact(String, String[], IFormatProvider) pro převod každého prvku pole řetězců na TimeSpan hodnotu. Příklad interpretuje řetězce pomocí konvencí formátování jazyka Francouzština - Francie ("fr-FR"). Řetězce mohou vyjadřovat časový interval buďto v obecném krátkém formátu, nebo v obecném dlouhém formátu.
Kromě toho se v tomto příkladu mění způsob, kterým metody analýzy časového intervalu interpretují jednu číslici. Obvykle je jedna číslice interpretována jako počet dnů v časovém intervalu. Místo toho se řetězec vlastního %h
formátu používá k interpretaci jedné číslice jako počtu hodin. Aby byla tato změna platná, musí řetězec vlastního %h
formátu předcházet ostatním řetězcům formátu v formats
poli.
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
Poznámky
Metoda ParseExact(String, String, IFormatProvider) parsuje řetězcovou reprezentaci časového intervalu, který musí být v jednom z formátů definovaných parametrem, s tím rozdílem formats
, že počáteční a koncové prázdné znaky jsou ignorovány. Vzhledem k tomu, input
že musí přesně odpovídat jednomu z formátů zadaných v formats
nástroji , měli byste při převodu řetězcového vstupu uživatele na časový interval vždy použít zpracování výjimek. Pokud nechcete používat zpracování výjimek, můžete místo toho volat metodu TryParseExact(String, String[], IFormatProvider, TimeSpan) .
Parametr formats
je pole řetězců, jehož prvky se skládají buď z jednoho specifikátoru standardního formátu, nebo jednoho nebo více specifikátorů vlastního formátu, které definují požadovaný formát .input
Další informace o platných formátových řetězcích najdete v tématu Standardní řetězce formátu TimeSpan a Vlastní řetězce formátu TimeSpan. input
musí přesně odpovídat členu, formats
aby operace parse byla úspěšná. Operace parse se pokusí shodovat input
s každým prvkem počínaje formats
prvním prvkem v poli.
Důležité
Metoda ParseExact používá konvence jazykové verze určené parametrem formatProvider
pouze v případě, že formátovací řetězec použitý k analýze input
je řetězec standardního TimeSpan formátu, jehož hodnota je buď "g" nebo "G". Standardní řetězce formátu "c", "t" a "T" používají konvence formátování invariantní jazykové verze. Vlastní formátovací řetězce definují přesný formát vstupního řetězce a pomocí literálových znaků oddělují části časového intervalu.
Parametr formatProvider
je IFormatProvider implementace, která poskytuje informace specifické pro jazykovou verzi o formátu vráceného řetězce, pokud formátovací řetězec použitý k analýze input
je standardní formátovací řetězec. Parametr formatProvider
může být některý z následujících parametrů:
Objekt CultureInfo , který představuje jazykovou verzi, jejíž konvence formátování se mají promítnout do vráceného řetězce. Objekt DateTimeFormatInfo vrácený CultureInfo.DateTimeFormat vlastností definuje formátování vráceného řetězce.
Objekt DateTimeFormatInfo , který definuje formátování vráceného řetězce.
Vlastní objekt, který implementuje IFormatProvider rozhraní. Jeho IFormatProvider.GetFormat metoda vrátí DateTimeFormatInfo objekt, který poskytuje informace o formátování.
Pokud formatProvider
je null
, použije se DateTimeFormatInfo objekt přidružený k aktuální jazykové verzi.
Viz také
- TryParseExact(String, String[], IFormatProvider, TimeSpan)
- Standardní řetězce formátu TimeSpan
- Vlastní řetězce formátu TimeSpan
Platí pro
ParseExact(String, String, IFormatProvider)
- Zdroj:
- TimeSpan.cs
- Zdroj:
- TimeSpan.cs
- Zdroj:
- TimeSpan.cs
Převede řetězcovou reprezentaci časového intervalu na jeho TimeSpan ekvivalent pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi. Formát řetězcového vyjádření musí přesně odpovídat určenému formátu.
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
Parametry
- input
- String
Řetězec, který určuje časový interval k převedení.
- format
- String
Standardní nebo vlastní formátovací řetězec, který definuje požadovaný formát souboru input
.
- formatProvider
- IFormatProvider
Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.
Návraty
Časový interval, který odpovídá hodnotě input
, jak je uvedeno v parametrech format
a formatProvider
.
Výjimky
input
je null
.
input
má neplatný formát.
input
představuje číslo, které je menší než TimeSpan.MinValue nebo větší než TimeSpan.MaxValue.
-nebo-
Alespoň jedna ze součástí dnů, hodin, minut nebo sekund je mimo input
platný rozsah.
Příklady
Následující příklad používá metodu ParseExact(String, String, IFormatProvider) k analýze několika řetězcových reprezentací časových intervalů pomocí různých formátových řetězců a jazykových verzí.
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
Poznámky
Metoda ParseExact(String, String, IFormatProvider) parsuje řetězcovou reprezentaci časového intervalu, který musí být ve formátu definovaném format
parametrem, s tím rozdílem, že počáteční a koncové prázdné znaky jsou ignorovány. Vzhledem k tomu input
, že se musí přesně shodovat s formátem format
, měli byste při převodu řetězcového vstupu uživatelem na časový interval vždy použít zpracování výjimek. Pokud nechcete používat zpracování výjimek, můžete místo toho volat metodu TryParseExact(String, String, IFormatProvider, TimeSpan) .
Parametr format
je řetězec, který obsahuje buď jeden specifikátor standardního formátu, nebo jeden nebo více specifikátorů vlastního formátu, které definují požadovaný formát .input
Další informace o platných formátových řetězcích najdete v tématu Standardní řetězce formátu TimeSpan a Vlastní řetězce formátu TimeSpan.
Důležité
Metoda ParseExact používá konvence jazykové verze určené parametrem formatProvider
pouze v případě, že format
je standardní TimeSpan formátovací řetězec, jehož hodnota je buď "g" nebo "G". Standardní řetězce formátu "c", "t" a "T" používají konvence formátování invariantní jazykové verze. Vlastní formátovací řetězce definují přesný formát vstupního řetězce a pomocí literálových znaků oddělují části časového intervalu.
Parametr formatProvider
je IFormatProvider implementace, která poskytuje informace specifické pro jazykovou verzi o formátu vráceného řetězce, pokud format
je standardní formátovací řetězec. Parametr formatProvider
může být některý z následujících parametrů:
Objekt CultureInfo , který představuje jazykovou verzi, jejíž konvence formátování se mají promítnout do vráceného řetězce. Objekt DateTimeFormatInfo vrácený CultureInfo.DateTimeFormat vlastností definuje formátování vráceného řetězce.
Objekt DateTimeFormatInfo , který definuje formátování vráceného řetězce.
Vlastní objekt, který implementuje IFormatProvider rozhraní. Jeho IFormatProvider.GetFormat metoda vrátí DateTimeFormatInfo objekt, který poskytuje informace o formátování.
Pokud formatProvider
je null
, použije se DateTimeFormatInfo objekt přidružený k aktuální jazykové verzi.
Viz také
Platí pro
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, TimeSpanStyles)
- Zdroj:
- TimeSpan.cs
- Zdroj:
- TimeSpan.cs
- Zdroj:
- TimeSpan.cs
Převede rozsah znaků časového intervalu na jeho TimeSpan ekvivalent pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi. Formát řetězcového vyjádření musí přesně odpovídat určenému formátu.
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
Parametry
- input
- ReadOnlySpan<Char>
Rozsah, který určuje časový interval, který se má převést.
- format
- ReadOnlySpan<Char>
Standardní nebo vlastní formátovací řetězec, který definuje požadovaný formát souboru input
.
- formatProvider
- IFormatProvider
Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.
- styles
- TimeSpanStyles
Bitové kombinace hodnot výčtu, která definuje prvky stylu, které mohou být přítomny v input
.
Návraty
Časový interval, který odpovídá hodnotě input
, jak je uvedeno v parametrech format
a formatProvider
.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro