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 |