Our APIs use the following syntax for timestamps:
| Type | Format |
More Information |
|---|---|---|
|
Date |
YYYY-MM-DD |
Identifies a date. |
|
Date/Time |
YYYY-MM-DDThh:mm:ss |
Identifies a date and time. Time (i.e., Thh:mm:ss) is optional. If time is not specified, then a default time (i.e., 00:00:00) will be used. |
|
Date/Time (Extended II) |
YYYY-MM-DDThh:mm:ss.ffffffZ |
Ad Server Debug API uses this format to define a timestamp that is precise to the millisecond. |
Date and time variables are described below.
| VariableA variable represents a value that must be replaced. A variable consists of either a URL segment (e.g., "0001" in /0001/) or a query string value (e.g., "3" in mediaTypes=3). | Description |
|---|---|
|
YYYY |
Represents a year in the Gregorian calendar using a four digit number (e.g., 2023). |
|
MM |
Represents a two digit month between 01 (January) and 12 (December). |
|
DD |
Represents a two digit day between 01 and 31. |
|
T |
Indicates a delimiter between date and time. This delimiter is only required if you would like to specify a time. Keep in mind that time must be specified using 24-hour clock notation in UTC. |
|
hh |
Represents a two digit hour between 00 (midnight) and 23 (11 p.m.). |
|
mm |
Represents the number of minutes into the specified hour. Minutes should be specified using two digits between 00 and 59. |
|
ss |
Represents the number of seconds into the specified minute. Seconds should be specified using two digits between 00 and 59. |
|
ffffff |
Represents the millionths into the specified second. This value should be specified using six digits between 000000 and 999999. |
|
Z |
Represents UTC time. |