[Overview][Constants][Procedures and functions][Index] Reference for unit 'DateUtils' (#rtl)

TryISOTZStrToTZOffset

Attempts to convert an ISO 8601 time zone designation to an offset in minutes

Declaration

Source position: dateutil.inc line 464

function TryISOTZStrToTZOffset(

  const TZ: string;

  out TZOffset: Integer

):Boolean;

Arguments

TZ

  

time zone designation examined in the method

TZOffset

  

Contains the time zone offset expressed as a positive or negative number of minutes

Function result

True if the time zone designation was converted to an offset

Description

TryISOTZStrToTZOffset is a Boolean function which attempts to convert the ISO 8601 time zone designation to a time zone offset expressed as a positive or negative number of minutes. TZ contains the time zone designation examined in the function. It should not contain any other portion of a date/time value using ISO 8601 notation - just the time zone designation.

TryISOTZStrToTZOffset recognizes the following values in the TZ argument:

Z
Represents time zone Zulu (short for "Zulu time") as used by the military and in navigation. Refers to UTC (Coordinated Universal Time), formerly known as Greenwich Mean Time.
±HHNN or ±HH:NN
time zone designation expressed as a positive or negative number of hours and minutes for a given time value.

TZOffset is an Integer updated to contains the number of minutes needed to adjust a time value for a given time zone back to UTC (Zulu time). The hour and minute component values in TZ are converted to minutes and complemented (multiplied by -1) to derive the offset value. The derived value in TZOffset is 0 when TZ contains Zulu time, an empty string (''), or cannot be converted successfully.

The return value is True if the time zone designation in TZ is successfully converted to a time zone offset.

Use ISOTZStrToTZOffset to convert the time zone designation and raise an exception for an invalid time zone designation.

See also

ISOTZStrToTZOffset


Documentation generated on: May 14 2021