TimeSpan.ParseExact Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Преобразует строковое представление интервала времени в его TimeSpan эквивалент. Формат строкового представления должен точно соответствовать указанному формату.

Перегрузки

ParseExact(String, String, IFormatProvider)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент, используя указанные сведения о формате и языке и региональных параметрах. Формат строкового представления должен точно соответствовать указанному формату.
ParseExact(String, String[], IFormatProvider)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанного массива строк формата и сведений о формате, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, TimeSpanStyles)	Преобразует интервал времени в его TimeSpan эквивалент с помощью указанного формата и сведений о формате и региональных параметрах. Формат строкового представления должен точно соответствовать указанному формату.
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, TimeSpanStyles)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанных форматов, сведений о формате и стилях, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.
ParseExact(String, String, IFormatProvider, TimeSpanStyles)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанного формата, сведений о формате, региональных параметрах и стилях. Формат строкового представления должен точно соответствовать указанному формату.
ParseExact(String, String[], IFormatProvider, TimeSpanStyles)	Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанных форматов, сведений о формате и стилях, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.

ParseExact(String, String, IFormatProvider)

Исходный код:

TimeSpan.cs

Преобразует строковое представление интервала времени в его TimeSpan эквивалент, используя указанные сведения о формате и языке и региональных параметрах. Формат строкового представления должен точно соответствовать указанному формату.

C#

public static TimeSpan ParseExact (string input, string format, IFormatProvider? formatProvider);

Параметры

input

String

Строка, указывающая интервал времени для преобразования.

format

String

Стандартная или настраиваемая строка форматирования, определяющая обязательный формат input.

formatProvider

IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящие от языка и региональных параметров.

Возвращаемое значение

TimeSpan

Интервал времени, соответствующий input, как указано format и formatProvider.

Исключения

ArgumentNullException

input null.

FormatException

input имеет недопустимый формат.

OverflowException

input представляет число, которое меньше TimeSpan.MinValue или больше TimeSpan.MaxValue.

-или-

По крайней мере один из дней, часов, минут или секунд компонентов в input находится за пределами допустимого диапазона.

Примеры

В следующем примере метод ParseExact(String, String, IFormatProvider) используется для анализа нескольких строковых представлений интервалов времени с помощью различных строк форматирования и региональных параметров.

C#

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

Комментарии

Метод ParseExact(String, String, IFormatProvider) анализирует строковое представление интервала времени, который должен находиться в формате, определенном параметром format, за исключением того, что начальные и конечные символы пробелов игнорируются. Так как input должны соответствовать формату format точно, при преобразовании строковых входных данных пользователем в интервал времени всегда следует использовать обработку исключений. Если вы предпочитаете не использовать обработку исключений, вместо этого можно вызвать метод TryParseExact(String, String, IFormatProvider, TimeSpan).

Параметр format — это строка, содержащая один описатель стандартного формата или один или несколько настраиваемых описателей формата, определяющих требуемый формат input. Дополнительные сведения о допустимых строках форматирования см. в строках формата Standard TimeSpan и строк форматирования настраиваемого диапазона timeSpan.

Важно!

Метод ParseExact использует соглашения языка и региональных параметров, указанные параметром formatProvider, только если format является стандартной строкой формата TimeSpan, значение которой равно "g" или "G". Строки стандартного формата "c", "t" и "T" используют соглашения о форматировании инвариантного языка и региональных параметров. Строки пользовательского формата определяют точный формат входной строки и используют литеральные символы для разделения компонентов интервала времени.

Параметр formatProvider — это реализация IFormatProvider, которая предоставляет сведения о формате возвращаемой строки, если format является стандартной строкой формата. Параметр formatProvider может быть любым из следующих:

• Объект CultureInfo, представляющий язык и региональные параметры, соглашения о форматировании которых должны отражаться в возвращаемой строке. Объект DateTimeFormatInfo, возвращаемый свойством CultureInfo.DateTimeFormat, определяет форматирование возвращаемой строки.

• Объект DateTimeFormatInfo, определяющий форматирование возвращаемой строки.

• Пользовательский объект, реализующий интерфейс IFormatProvider. Его метод IFormatProvider.GetFormat возвращает объект DateTimeFormatInfo, предоставляющий сведения о форматировании.

Если formatProvidernull, используется объект DateTimeFormatInfo, связанный с текущим языком и региональными параметрами.

См. также раздел

• строк форматирования стандартного интервала времени
• настраиваемые строки формата timeSpan

ParseExact(String, String[], IFormatProvider)

Исходный код:

TimeSpan.cs

Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанного массива строк формата и сведений о формате, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.

C#

public static TimeSpan ParseExact (string input, string[] formats, IFormatProvider? formatProvider);

Параметры

input

String

Строка, указывающая интервал времени для преобразования.

formats

String[]

Массив строк стандартного или пользовательского формата, определяющий обязательный формат input.

formatProvider

IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящие от языка и региональных параметров.

Возвращаемое значение

TimeSpan

Интервал времени, соответствующий input, как указано formats и formatProvider.

Исключения

ArgumentNullException

input null.

FormatException

input имеет недопустимый формат.

OverflowException

input представляет число, которое меньше TimeSpan.MinValue или больше TimeSpan.MaxValue.

-или-

По крайней мере один из дней, часов, минут или секунд компонентов в input находится за пределами допустимого диапазона.

Примеры

В следующем примере вызывается метод ParseExact(String, String[], IFormatProvider) для преобразования каждого элемента массива строк в значение TimeSpan. В примере интерпретируются строки с помощью соглашений о форматировании языка и региональных параметров французского языка ( Франция ("fr-FR") и региональных параметров. Строки могут представлять интервал времени в общем коротком формате или общем длинном формате.

Кроме того, в примере изменяется способ, в котором методы синтаксического анализа интервала времени интерпретируют одну цифру. Обычно одна цифра интерпретируется как количество дней в интервале времени. Вместо этого строка пользовательского формата %h используется для интерпретации одной цифры в виде количества часов. Чтобы это изменение было эффективным, обратите внимание, что строка пользовательского формата %h должна предшествовать другим строкам формата в массиве formats.

C#

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

Комментарии

Метод ParseExact(String, String, IFormatProvider) анализирует строковое представление интервала времени, который должен находиться в одном из форматов, определенных параметром formats, за исключением того, что начальные и конечные символы пробелов игнорируются. Так как input должны точно соответствовать одному из форматов, указанных в formats, при преобразовании строковых входных данных пользователем в интервал времени всегда следует использовать обработку исключений. Если вы предпочитаете не использовать обработку исключений, вместо этого можно вызвать метод TryParseExact(String, String[], IFormatProvider, TimeSpan).

Параметр formats — это строковый массив, элементы которого состоят из одного описателя стандартного формата или одного или нескольких настраиваемых описателей формата, определяющих требуемый формат input. Дополнительные сведения о допустимых строках форматирования см. в строках формата Standard TimeSpan и строк форматирования настраиваемого диапазона timeSpan. input должен точно соответствовать элементу formats для успешной операции синтаксического анализа. Операция синтаксического анализа пытается сопоставить input с каждым элементом в formats начиная с первого элемента в массиве.

Важно!

Метод ParseExact использует соглашения языка и региональных параметров, указанные параметром formatProvider, только если строка формата, используемая для анализа input, является стандартной строкой формата TimeSpan, значение которой равно "g" или "G". Строки стандартного формата "c", "t" и "T" используют соглашения о форматировании инвариантного языка и региональных параметров. Строки пользовательского формата определяют точный формат входной строки и используют литеральные символы для разделения компонентов интервала времени.

Параметр formatProvider — это реализация IFormatProvider, которая предоставляет сведения о формате возвращаемой строки, если строка формата, используемая для анализа input, является стандартной строкой формата. Параметр formatProvider может быть любым из следующих:

• Объект CultureInfo, представляющий язык и региональные параметры, соглашения о форматировании которых должны отражаться в возвращаемой строке. Объект DateTimeFormatInfo, возвращаемый свойством CultureInfo.DateTimeFormat, определяет форматирование возвращаемой строки.

• Объект DateTimeFormatInfo, определяющий форматирование возвращаемой строки.

• Пользовательский объект, реализующий интерфейс IFormatProvider. Его метод IFormatProvider.GetFormat возвращает объект DateTimeFormatInfo, предоставляющий сведения о форматировании.

Если formatProvidernull, используется объект DateTimeFormatInfo, связанный с текущим языком и региональными параметрами.

См. также раздел

• TryParseExact(String, String[], IFormatProvider, TimeSpan)
• строк форматирования стандартного интервала времени
• настраиваемые строки формата timeSpan

ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, TimeSpanStyles)

Исходный код:

TimeSpan.cs

Преобразует интервал времени в его TimeSpan эквивалент с помощью указанного формата и сведений о формате и региональных параметрах. Формат строкового представления должен точно соответствовать указанному формату.

C#

public static TimeSpan ParseExact (ReadOnlySpan<char> input, ReadOnlySpan<char> format, IFormatProvider? formatProvider, System.Globalization.TimeSpanStyles styles = System.Globalization.TimeSpanStyles.None);

Параметры

input

ReadOnlySpan<Char>

Диапазон, указывающий интервал времени для преобразования.

format

ReadOnlySpan<Char>

Стандартная или настраиваемая строка форматирования, определяющая обязательный формат input.

formatProvider

IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящие от языка и региональных параметров.

styles

TimeSpanStyles

Побитовое сочетание значений перечисления, определяющее элементы стиля, которые могут присутствовать в input.

Возвращаемое значение

TimeSpan

Интервал времени, соответствующий input, как указано format и formatProvider.

ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, TimeSpanStyles)

Исходный код:

TimeSpan.cs

Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанных форматов, сведений о формате и стилях, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.

C#

public static TimeSpan ParseExact (ReadOnlySpan<char> input, string[] formats, IFormatProvider? formatProvider, System.Globalization.TimeSpanStyles styles = System.Globalization.TimeSpanStyles.None);

Параметры

input

ReadOnlySpan<Char>

Диапазон, указывающий интервал времени для преобразования.

formats

String[]

Массив строк стандартного или пользовательского формата, определяющий требуемый формат input.

formatProvider

IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящие от языка и региональных параметров.

styles

TimeSpanStyles

Побитовое сочетание значений перечисления, определяющее элементы стиля, которые могут присутствовать во входных данных.

Возвращаемое значение

TimeSpan

Интервал времени, соответствующий input, как указано в formats, formatProviderи styles.

ParseExact(String, String, IFormatProvider, TimeSpanStyles)

Исходный код:

TimeSpan.cs

Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанного формата, сведений о формате, региональных параметрах и стилях. Формат строкового представления должен точно соответствовать указанному формату.

C#

public static TimeSpan ParseExact (string input, string format, IFormatProvider? formatProvider, System.Globalization.TimeSpanStyles styles);

Параметры

input

String

Строка, указывающая интервал времени для преобразования.

format

String

Стандартная или настраиваемая строка форматирования, определяющая обязательный формат input.

formatProvider

IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящие от языка и региональных параметров.

styles

TimeSpanStyles

Побитовое сочетание значений перечисления, определяющее элементы стиля, которые могут присутствовать в input.

Возвращаемое значение

TimeSpan

Интервал времени, соответствующий input, как указано в format, formatProviderи styles.

Исключения

ArgumentException

styles является недопустимым значением TimeSpanStyles.

ArgumentNullException

input null.

FormatException

input имеет недопустимый формат.

OverflowException

input представляет число, которое меньше TimeSpan.MinValue или больше TimeSpan.MaxValue.

-или-

По крайней мере один из дней, часов, минут или секунд компонентов в input находится за пределами допустимого диапазона.

Примеры

В следующем примере метод ParseExact(String, String, IFormatProvider) используется для анализа нескольких строковых представлений интервалов времени с помощью различных строк форматирования и региональных параметров. Он также использует значение TimeSpanStyles.AssumeNegative для интерпретации каждой строки как отрицательного интервала времени. Выходные данные из примера показывают, что стиль TimeSpanStyles.AssumeNegative влияет на возвращаемое значение, только если оно используется с настраиваемыми строками форматирования.

C#

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

Комментарии

Метод ParseExact анализирует строковое представление интервала времени, который должен находиться в формате, определенном параметром format, за исключением того, что начальные и конечные символы пробелов игнорируются. Так как input должны соответствовать формату format точно, при преобразовании строковых входных данных пользователем в интервал времени всегда следует использовать обработку исключений. Если вы предпочитаете не использовать обработку исключений, вместо этого можно вызвать метод TryParseExact(String, String, IFormatProvider, TimeSpanStyles, TimeSpan).

Параметр format — это строка, содержащая один описатель стандартного формата или один или несколько настраиваемых описателей формата, определяющих требуемый формат input. Дополнительные сведения о допустимых строках форматирования см. в строках формата Standard TimeSpan и строк форматирования настраиваемого диапазона timeSpan.

Важно!

Метод ParseExact использует соглашения языка и региональных параметров, указанные параметром formatProvider, только если format является стандартной строкой формата TimeSpan, значение которой равно "g" или "G". Строки стандартного формата "c", "t" и "T" используют соглашения о форматировании инвариантного языка и региональных параметров. Строки пользовательского формата определяют точный формат входной строки и используют литеральные символы для разделения компонентов интервала времени.

Параметр formatProvider — это реализация IFormatProvider, которая предоставляет сведения о формате возвращаемой строки, если format является стандартной строкой формата. Параметр formatProvider может быть любым из следующих:

• Объект CultureInfo, представляющий язык и региональные параметры, соглашения о форматировании которых должны отражаться в возвращаемой строке. Объект DateTimeFormatInfo, возвращаемый свойством CultureInfo.DateTimeFormat, определяет форматирование возвращаемой строки.

• Объект DateTimeFormatInfo, определяющий форматирование возвращаемой строки.

• Пользовательский объект, реализующий интерфейс IFormatProvider. Его метод IFormatProvider.GetFormat возвращает объект DateTimeFormatInfo, предоставляющий сведения о форматировании.

Если formatProvidernull, используется объект DateTimeFormatInfo, связанный с текущим языком и региональными параметрами.

Параметр styles влияет на интерпретацию строк, которые анализируются с помощью настраиваемых строк форматирования. Он определяет, интерпретируется ли input как отрицательный интервал времени, только если отрицательный знак присутствует (TimeSpanStyles.None), или всегда ли он интерпретируется как отрицательный интервал времени (TimeSpanStyles.AssumeNegative). Если TimeSpanStyles.AssumeNegative не используется, format должен включать символ отрицательного знака литералов (например, "\-") для успешного анализа отрицательного интервала времени.

См. также раздел

• строк форматирования стандартного интервала времени
• настраиваемые строки формата timeSpan

ParseExact(String, String[], IFormatProvider, TimeSpanStyles)

Исходный код:

TimeSpan.cs

Преобразует строковое представление интервала времени в его TimeSpan эквивалент с помощью указанных форматов, сведений о формате и стилях, зависящих от языка и региональных параметров. Формат строкового представления должен точно соответствовать одному из указанных форматов.

C#

public static TimeSpan ParseExact (string input, string[] formats, IFormatProvider? formatProvider, System.Globalization.TimeSpanStyles styles);

Параметры

input

String

Строка, указывающая интервал времени для преобразования.

formats

String[]

Массив строк стандартного или пользовательского формата, определяющий требуемый формат input.

formatProvider

IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящие от языка и региональных параметров.

styles

TimeSpanStyles

Побитовое сочетание значений перечисления, определяющее элементы стиля, которые могут присутствовать во входных данных.

Возвращаемое значение

TimeSpan

Интервал времени, соответствующий input, как указано в formats, formatProviderи styles.

Исключения

ArgumentException

styles является недопустимым значением TimeSpanStyles.

ArgumentNullException

input null.

FormatException

input имеет недопустимый формат.

OverflowException

input представляет число, которое меньше TimeSpan.MinValue или больше TimeSpan.MaxValue.

-или-

По крайней мере один из дней, часов, минут или секунд компонентов в input находится за пределами допустимого диапазона.

Примеры

В следующем примере вызывается метод ParseExact(String, String[], IFormatProvider, TimeSpanStyles) для преобразования каждого элемента массива строк в значение TimeSpan. Строки могут представлять интервал времени в общем коротком формате или общем длинном формате.

Кроме того, в примере изменяется способ, в котором методы синтаксического анализа интервала времени интерпретируют одну цифру. Обычно одна цифра интерпретируется как количество дней в интервале времени. Вместо этого строка пользовательского формата %h используется для интерпретации одной цифры в виде количества часов. Чтобы это изменение было эффективным, обратите внимание, что строка пользовательского формата %h должна предшествовать другим строкам формата в массиве formats. Кроме того, обратите внимание на выходные данные, что флаг TimeSpanStyles.AssumeNegative, указанный в вызове метода, используется только при синтаксическом анализе строки с помощью этого описателя формата.

C#

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

Комментарии

Метод ParseExact(String, String[], IFormatProvider, TimeSpanStyles) анализирует строковое представление интервала времени, который должен находиться в одном из форматов, определенных параметром formats, за исключением того, что начальные и конечные символы пробелов игнорируются. Так как input должны точно соответствовать одному из форматов, указанных в formats, при преобразовании строковых входных данных пользователем в интервал времени всегда следует использовать обработку исключений. Если вы предпочитаете не использовать обработку исключений, вместо этого можно вызвать метод TryParseExact(String, String[], IFormatProvider, TimeSpanStyles, TimeSpan).

Параметр formats — это строковый массив, элементы которого состоят из одного описателя стандартного формата или одного или нескольких настраиваемых описателей формата, определяющих требуемый формат input. Дополнительные сведения о допустимых строках форматирования см. в строках формата Standard TimeSpan и строк форматирования настраиваемого диапазона timeSpan. input должен точно соответствовать элементу formats для успешной операции синтаксического анализа. Операция синтаксического анализа пытается сопоставить input с каждым элементом в formats начиная с первого элемента в массиве.

Важно!

Метод ParseExact использует соглашения языка и региональных параметров, указанные параметром formatProvider, только если строка формата, используемая для анализа input, является стандартной строкой формата TimeSpan, значение которой равно "g" или "G". Строки стандартного формата "c", "t" и "T" используют соглашения о форматировании инвариантного языка и региональных параметров. Строки пользовательского формата определяют точный формат входной строки и используют литеральные символы для разделения компонентов интервала времени.

Параметр formatProvider — это реализация IFormatProvider, которая предоставляет сведения о формате возвращаемой строки, если строка формата, используемая для анализа input, является стандартной строкой формата. Параметр formatProvider может быть любым из следующих:

• Объект CultureInfo, представляющий язык и региональные параметры, соглашения о форматировании которых должны отражаться в возвращаемой строке. Объект DateTimeFormatInfo, возвращаемый свойством CultureInfo.DateTimeFormat, определяет форматирование возвращаемой строки.

• Объект DateTimeFormatInfo, определяющий форматирование возвращаемой строки.

• Пользовательский объект, реализующий интерфейс IFormatProvider. Его метод IFormatProvider.GetFormat возвращает объект DateTimeFormatInfo, предоставляющий сведения о форматировании.

Если formatProvidernull, используется объект DateTimeFormatInfo, связанный с текущим языком и региональными параметрами.

Параметр styles влияет на интерпретацию строк, которые анализируются с помощью настраиваемых строк форматирования. Он определяет, интерпретируется ли input как отрицательный интервал времени, только если отрицательный знак присутствует (TimeSpanStyles.None), или всегда ли он интерпретируется как отрицательный интервал времени (TimeSpanStyles.AssumeNegative). Если TimeSpanStyles.AssumeNegative не используется, format должен включать символ отрицательного знака литералов (например, "\-") для успешного анализа отрицательного интервала времени.

См. также раздел

• строк форматирования стандартного интервала времени
• настраиваемые строки формата timeSpan