WS_DATETIME_FORMAT enumeration

Specifies the textual format of a WS_DATETIME.

Syntax

enum WS_DATETIME_FORMAT {  WS_DATETIME_FORMAT_UTC    = 0, 
  WS_DATETIME_FORMAT_LOCAL, 
  WS_DATETIME_FORMAT_NONE 

};

Constants

WS_DATETIME_FORMAT_UTC

This format displays a time in the GMT timezone. It is formatted with a "Z" following the time. For example, September 25, 2007 at 1:30AM in the GMT timezone would be represented as "2007-09-25T01:30:00Z".

WS_DATETIME_FORMAT_LOCAL

This format displays a time with a specific timezone. The time is followed by "[+|-]hh:mm" indicating the relative difference between the local time and UTC in hours and minutes. For example, September 27, 2007 at 10:30AM in the Pacific timezone would be represented as "2007-09-27T10:30:00-07:00".

If the system is unable to convert the time to a local format because timezone information for the time specified it not available, then it will format the time as WS_DATETIME_FORMAT_UTC.

WS_DATETIME_FORMAT_NONE

This format displays a time with no timezone. The time is formatted with no additional information and no timezone is implied. For example, September 27, 2007 at 10:30AM would be represented as "2007-09-27T10:30:00".

Requirements