Data Types and Units of Measure

Data Types

The Wireless Network Services APIs use the following data types:

Primitive Data Types

The following table describes the most commonly used primitive data types.

NOTE: A complete set of XML schema data types (both primitive and derived) is available at the World Wide Web Consortium (W3C) website, at www.w3.org/TR/xmlschema-2/.

Primitive Data Type Description
Boolean Binary-valued logic: True, False; 1, 0.
dateTime

Date/time format: YYYY-MM-DDThh:mm:ss.SSSxyy:zz

Where:

  • YYYY - the year; must be four digits.
  • MM - the month; must be two digits (01 to 12).
  • DD - day of the month; must be two digits (01 to 31).
  • hh - hour of the day; must be two digits (00 to 23).
  • mm - minute of the hour; must be two digits (00 to 59).
  • ss - second of the minute; must be two digits (00 to 59).
  • SSS - decimal seconds, optional; if present, one or more digits.

  • xyy:zz - optional time zone offset. If this field is not present, Z, -00:00, or +00:00, then dateTime is GMT; if present, x is either "+" or "-", yy is 2-digit hours (00 to 12), and zz is 2-digit minutes (00 to 59). When Daylight Savings Time starts, the time zone offset should increase by one hour, as shown in the example below:

    • 2003-08-19T12:12:12-08:00 (Pacific time zone)
    • 2003-08-29T12:12:12-07:00 (Pacific time zone plus Daylight Savings offset)

NOTE: decimal seconds are not currently supported. If passed in, they will be ignored.

The time zone used in responses is UTC. You are responsible for any conversion of time and date data to and from UTC time zone.
decimal Arbitrary precision decimal numbers: -43.21, 1500.00.
double A double-precision 64-bit floating point: 12.78e-2.
duration

Format is: PnYn MnDT nH nMnS

Where:

  • nY - number of years
  • nM - number of months
  • nD - number of days
  • T - the date/time separator
  • nH - number of hours
  • nM - number of minutes
  • nS - number of seconds

NOTE: The number of seconds can include decimal digits to arbitrary precision. An optional preceding minus sign ("-") is allowed, to indicate a negative duration. When the sign is omitted, a positive duration is indicated. For example, to indicate a duration of 1 year, 2 months, 3 days, 10 hours, and 30 minutes, you would write: P1Y2M3DT10H30M.

For more information on the duration definition, visit the W3C.org website: www.w3.org/TR/xmlschema-2/#duration
float A single-precision 32-bit floating point.
string A text string: "This is a string."
Int An integer range from -2147483647 to +2147483648.
Short A short range from -32767 to + 32768.

Complex Data Types

Complex data types are defined in the WSDL files, and are documented throughout this guide.

Units of Measure

The units used by Wireless Network Services are: