System.DateUtils.TryISO8601ToDate

• Up to Parent: System.DateUtils

Delphi

function TryISO8601ToDate(const AISODate: string; out Value: TDateTime; AReturnUTC: Boolean = True): Boolean;

C++

extern DELPHI_PACKAGE bool __fastcall TryISO8601ToDate(const System::UnicodeString AISODate, /* out */ System::TDateTime &Value, bool AReturnUTC = true);

Properties

Type	Visibility	Source	Unit	Parent
function	public	System.DateUtils.pas System.DateUtils.hpp	System.DateUtils	System.DateUtils

Description

Tries to convert the provided date-and-time value, specified in the ISO 8601 format, into the date-and-time value in the TDateTime format. Returns True if the conversion succeeds.

• AISODate is a date-and-time value in the ISO 8601 format.
• AReturnUTC is an optional Boolean parameter that indicates whether the resulting date-and-time value should take into account the Time offsets for the local time zone of the system that runs your application. The default is True.
  • If AReturnUTC is True, the resulting value does not take into account the time offset for the local time zone.
  • If AReturnUTC is False, the resulting value takes into account the time offset for the local time zone.
• Value is the output variable for the resulting date-and-time value.

The following table demonstrates usage of AReturnUTC. The input AISODate date-and-time values are specified in the ISO 8601 format. This example calculates results for the local time zone (UTC+04:00).

AISODate	AReturnUTC	Text representation of TDateTime Result
2013-10-18T18:36:22.966Z	True	10/18/2013 6:36:22 PM
2013-10-18T18:36:22.966Z	False	10/18/2013 10:36:22 PM
2013-10-18T18:36:22.966-03:00	True	10/18/2013 9:36:22 PM
2013-10-18T18:36:22.966-03:00	False	10/19/2013 1:36:22 AM

Note: -03:00 is the time offset for the UTC-03:00 time zone from UTC.

See Also

• System.TDateTime

• System.DateUtils.DateToISO8601

• Date and Time Support

• ISO 8601