Date/Time Parameters

This appendix describes how to use the date/time parameters in the Tidal Enterprise Scheduler Web Services SOAP API.

Date/Time Parameters

This section provides the following guidelines for using the date/time parameters in the Scheduler Web Services SOAP API:

  • All date/time parameters are of XML dateTime type as defined in http://www.w3.org/TR/xmlschema-2/#dateTime .
  • All date/time parameters are displayed and must be entered in the format conforming to this specification, with a Scheduler specific requirement that all times are according to the time zone of the target Scheduler Master.
  • When entering the date/time parameter, Tidal recommends leaving the Time Zone field blank so that the time will be interpreted by the API according to the time zone of Scheduler Master.

If present, the time zone field must represent the time zone of the target Scheduler Master. A typical date time string looks like one of the following:

– With the time zone: 2010-05-03T09:19:03-05:00

– Without the time zone: 2010-05-03T09:19:03

  • The src/com/tidalsoft/tesws/client/util/DateTime.java source file in the sample client implements a pair of examples on creating proper XMLGregorianCalendar objects to represent date and time parameters.