Table of Contents

Search

  1. Preface
  2. Introduction to Business Entity Services
  3. EJB Business Entity Service Calls
  4. REST Business Entity Service Calls
  5. REST APIs for Data Director
  6. SOAP Business Entity Service Calls
  7. Cross-reference Records and BVT Calculations Services
  8. Supporting Corporate Linkage Service
  9. External Calls to Cleanse, Analyze, and Transform Data
  10. Appendix A: Using REST APIs to Add Records
  11. Appendix B: Using REST APIs to Upload Files
  12. Appendix C: Using REST APIs to Manage Reports

Formats for Dates and Time in UTC

Formats for Dates and Time in UTC

In the request and response, all dates and times are specified in UTC (Coordinated Universal Time), with or without an offset for a specific time zone.
When you specify a date and time in a request body, use one of the formats defined in Date and Time Formats (NOTE-datetime) for ISO specification 8601.
The following guidelines are taken from the NOTE-datetime document:
Type
Syntax
Example
Date: Year
YYYY
1997
Date: Year and month
YYYY-MM
1997-07
Date: Year, month, and day
YYYY-MM-DD
1997-07-16
Date plus hours and minutes
YYYY-MM-DDThh:mmTZD
1997-07-16T19:20+01:00
Date plus hours, minutes, and seconds
YYYY-MM-DDThh:mm:ssTZD
1997-07-16T19:20:30+01:00
Date plus hours, minutes, seconds, and fractional seconds
YYYY-MM-DDThh:mm:ss.sTZD
1997-07-16T19:20:30.45+01:00
where:
  • YYYY = a four-digit year
  • MM = a two-digit month, from 01 to 12
  • DD = a two-digit day of the month, from 01 to 31
  • T = a literal value that follows the date and introduces the time
  • hh = two digits for the hour, from 00 to 23
  • mm = two digits for the minutes, from 00 to 59
  • ss = two digits for the seconds, from 00 to 59
  • s = one or more digits representing a decimal fraction of a second
  • TZD = time zone designator (Z or +hh:mm or -hh:mm)
    • Z for UTC time
    • +hh:mm for a local time zone that is ahead of UTC
    • -hh:mm for a local time zone that is behind UTC

0 COMMENTS

We’d like to hear from you!