Soap.XSBuiltIns.XMLTimeToDateTime
Delphi
function XMLTimeToDateTime(const XMLDateTime: InvString; AsUTCTime: Boolean = False): TDateTime;
C++
extern DELPHI_PACKAGE System::TDateTime __fastcall XMLTimeToDateTime(const System::UnicodeString XMLDateTime, bool AsUTCTime = false);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | Soap.XSBuiltIns.pas Soap.XSBuiltIns.hpp |
Soap.XSBuiltIns | Soap.XSBuiltIns |
説明
XML 日時値に対応する TDateTime 値を返します。この関数は、DateTimeToXMLTime 関数の逆の働きをします。
XMLDateTime
は、"2014-02-18T03:30:45+01:00" のような ISO 8601 形式の日付または日時の文字列です。指定された値が正しくない場合、XMLTimeToDateTime は "有効な日時ではありません" という EConvertError 例外を発生させます。
AsUTCTime
は論理値です。AsUTCTime
が False
(デフォルト)の場合、日時は UTC で表現され、時間のオフセット(上の例における "+01:00")は UTC に対する相対値です。AsUTCTime
を True
に設定すると、日時は、アプリケーションが動作しているシステムのローカル タイム ゾーンを使ってローカルの日時として解析され、時間のオフセットもローカル タイム ゾーンを基に適用されます。
たとえば、米国の太平洋標準時(UTC-08:00)では、次のようになります。
XMLDateTime
|
AsUTCTime
|
結果 |
---|---|---|
2015-04-03T20:00:00 | False
|
2015-04-03 12:00:00 |
2015-04-03T20:00:00 | True
|
2015-04-03 20:00:00 |
2015-04-03T20:00:00+01:00 | False
|
2015-04-03 11:00:00 |
2015-04-03T20:00:00+01:00 | True
|
2015-04-03 19:00:00 |