DateTimeOffset.ParseExact Method (String, String, IFormatProvider, DateTimeStyles)

Parameters

• input
  Type: System.String
  A string that contains a date and time to convert.

• format
  Type: System.String
  A format specifier that defines the expected format of input.

• formatProvider
  Type: System.IFormatProvider
  An object that supplies culture-specific formatting information about input.

• styles
  Type: System.Globalization.DateTimeStyles
  A bitwise combination of enumeration values that indicates the permitted format of input.

Return Value

Type: System.DateTimeOffset
An object that is equivalent to the date and time that is contained in the input parameter, as specified by the format, formatProvider, and styles parameters.

Dim dateString, format As String
Dim result As DateTimeOffset
Dim provider As CultureInfo = CultureInfo.InvariantCulture

' Parse date-only value with invariant culture and assume time is UTC.
dateString = "06/15/2008"
format = "d"
Try
   result = DateTimeOffset.ParseExact(dateString, format, provider, _
                                      DateTimeStyles.AssumeUniversal)
   outputBlock.Text &= String.Format("'{0}' converts to {1}.", dateString, result.ToString()) & vbCrLf
Catch e As FormatException
   outputBlock.Text &= String.Format("'{0}' is not in the correct format.", dateString) & vbCrLf
End Try

' Parse date-only value with leading white space.
' Should throw a FormatException because only trailing whitespace is  
' specified in method call.
dateString = " 06/15/2008"
Try
   result = DateTimeOffset.ParseExact(dateString, format, provider, _
                                      DateTimeStyles.AllowTrailingWhite)
   outputBlock.Text &= String.Format("'{0}' converts to {1}.", dateString, result.ToString()) & vbCrLf
Catch e As FormatException
   outputBlock.Text &= String.Format("'{0}' is not in the correct format.", dateString) & vbCrLf
End Try

' Parse date and time value, and allow all white space.
dateString = " 06/15/   2008  15:15    -05:00"
format = "MM/dd/yyyy H:mm zzz"
Try
   result = DateTimeOffset.ParseExact(dateString, format, provider, _
                                      DateTimeStyles.AllowWhiteSpaces)
   outputBlock.Text &= String.Format("'{0}' converts to {1}.", dateString, result.ToString()) & vbCrLf
Catch e As FormatException
   outputBlock.Text &= String.Format("'{0}' is not in the correct format.", dateString) & vbCrLf
End Try

' Parse date and time and convert to UTC.
dateString = "  06/15/2008 15:15:30 -05:00"
format = "MM/dd/yyyy H:mm:ss zzz"
Try
   result = DateTimeOffset.ParseExact(dateString, format, provider, _
                                      DateTimeStyles.AllowWhiteSpaces Or _
                                      DateTimeStyles.AdjustToUniversal)
   outputBlock.Text &= String.Format("'{0}' converts to {1}.", dateString, result.ToString()) & vbCrLf
Catch e As FormatException
   outputBlock.Text &= String.Format("'{0}' is not in the correct format.", dateString) & vbCrLf
End Try
' The example displays the following output:
'    '06/15/2008' converts to 6/15/2008 12:00:00 AM +00:00.
'    ' 06/15/2008' is not in the correct format.
'    ' 06/15/   2008  15:15    -05:00' converts to 6/15/2008 3:15:00 PM -05:00.
'    '  06/15/2008 15:15:30 -05:00' converts to 6/15/2008 8:15:30 PM +00:00.

string dateString, format;
DateTimeOffset result;
CultureInfo provider = CultureInfo.InvariantCulture;

// Parse date-only value with invariant culture and assume time is UTC.
dateString = "06/15/2008";
format = "d";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider,
                                      DateTimeStyles.AssumeUniversal);
   outputBlock.Text += String.Format("'{0}' converts to {1}.", dateString, result.ToString()) + "\n";
}
catch (FormatException)
{
   outputBlock.Text += String.Format("'{0}' is not in the correct format.", dateString) + "\n";
}

// Parse date-only value with leading white space.
// Should throw a FormatException because only trailing whitespace is  
// specified in method call.
dateString = " 06/15/2008";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider,
                                      DateTimeStyles.AllowTrailingWhite);
   outputBlock.Text += String.Format("'{0}' converts to {1}.", dateString, result.ToString()) + "\n";
}
catch (FormatException)
{
   outputBlock.Text += String.Format("'{0}' is not in the correct format.", dateString) + "\n";
}

// Parse date and time value, and allow all white space.
dateString = " 06/15/   2008  15:15    -05:00";
format = "MM/dd/yyyy H:mm zzz";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider,
                                      DateTimeStyles.AllowWhiteSpaces);
   outputBlock.Text += String.Format("'{0}' converts to {1}.", dateString, result.ToString()) + "\n";
}
catch (FormatException)
{
   outputBlock.Text += String.Format("'{0}' is not in the correct format.", dateString) + "\n";
}

// Parse date and time and convert to UTC.
dateString = "  06/15/2008 15:15:30 -05:00";
format = "MM/dd/yyyy H:mm:ss zzz";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider,
                                      DateTimeStyles.AllowWhiteSpaces |
                                      DateTimeStyles.AdjustToUniversal);
   outputBlock.Text += String.Format("'{0}' converts to {1}.", dateString, result.ToString()) + "\n";
}
catch (FormatException)
{
   outputBlock.Text += String.Format("'{0}' is not in the correct format.", dateString) + "\n";
}
// The example displays the following output:
//    '06/15/2008' converts to 6/15/2008 12:00:00 AM +00:00.
//    ' 06/15/2008' is not in the correct format.
//    ' 06/15/   2008  15:15    -05:00' converts to 6/15/2008 3:15:00 PM -05:00.
//    '  06/15/2008 15:15:30 -05:00' converts to 6/15/2008 8:15:30 PM +00:00.