Soap.XSBuiltIns.TXSDateTime
Delphi
TXSDateTime = class(TXSCustomDateTime)
C++
class PASCALIMPLEMENTATION TXSDateTime : public TXSCustomDateTime
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| class | public | Soap.XSBuiltIns.pas Soap.XSBuiltIns.hpp |
Soap.XSBuiltIns | Soap.XSBuiltIns |
Description
TXSDateTime implémente le type de schéma XML date/heure utilisable par les interfaces invocables.
TXSDateTime sert d'enveloppe au type scalaire simple date/heure défini par le W3C pour les schémas XML. Comme ce type ne correspond pas directement à un type Delphi ou C++, il nécessite un marshaling particulier lors de son utilisation dans une interface invocable. TXSDateTime permet ce marshaling car c'est un descendant de TRemotable.
Pour convertir une valeur TXSDateTime en une valeur TDateTime, utilisez la propriété AsDateTime. La valeur résultante représente la partie heure selon le temps UTC (Coordinated Universal Time). Pour la convertir en une heure utilisant un temps local, ajustez les parties heure et minutes en utilisant les propriétés HourOffset et MinuteOffset.
Dans les applications serveurs, les instances de TXSDateTime utilisées comme paramètres d'entrée d'une interface invocable sont créées automatiquement lorsque l'appel de méthode est désassemblé et sont libérées automatiquement quand des paramètres de sortie ou une valeur renvoyée sont assemblés afin d'être envoyées au xclient. Quand une instance de TXSDateTime est créée par une méthode appelée à distance en utilisant une interface invocable, l'instance est libérée automatiquement après l'assemblage de la valeur du descendant de TRemotable en vue de son renvoi à l'application client.
L'appelant d'une interface invocable (client) est responsable de la création de toute instance de TXSDateTime qu'il transmet en paramètre d'entrée, et de la libération de toute instance de TXSDateTime qu'il crée ou qui est renvoyée sous la forme de paramètres de sortie ou de résultats de méthode.