Developer manual
date
Returns date/time/calendar specific information
Updated: Type: url
Method
/date/attribute/value
Current
URL Attributes
| Attribute | Type | Description | Default | Required? | |
|---|---|---|---|---|---|
| current | timezone | number | The timezone to use in the returned results Allowed values: +NNNN, -NNNN, +N, -N Timezone +5 can be expressed as either +0500 or +5 |
+0800 (Perth, Australia) | No |
| current | date | date | The date/time to use to calculate the returned results Allowed values: YYYY-MM-DD HH:MM:SS, YYYY-MM-DD, HH:MM:SS Time must be expressed in 24 hour format |
{current date/time} | No |
| current | adjust | number | Adjusts the time. Takes into consideration time changes that return a different date. Allowed values: +NNNN, -NNNN • +100 adds 1 hour • -100 subtracts 1 hour • 1450 adds 14 hours and 30 minutes • -50 subtracts 30 minutes |
No | |
| current | calendar | date | Returns information required when rendering calendars | No |
Examples
#1
Request
/date
Returns full details for the current server date/time
Response
<?xml version="1.0"?>
<datapackets>
<now>
<servertime>1329465388</servertime>
<timezone>+0800</timezone>
<date>
<rfcdate>Fri, 17 Feb 2012 03:56:28 +0800</rfcdate>
<unixdate>1329465388</unixdate>
<revdate>20120217</revdate>
<year>2012</year>
<n-month>02</n-month>
<n-day>17</n-day>
<month>February</month>
<day>Friday</day>
<week>07</week>
<suffix>th</suffix>
<hour>03</hour>
<minute>56</minute>
<meridiem>pm</meridiem>
</date>
<time>03:56:28 pm</time>
<agetime>0</agetime>
</now>
<calendar>
<month>
<date>1325347200</date>
<year>2012</year>
<n-month>01</n-month>
<month>January</month>
<start>1</start>
<startmonday>7</startmonday>
<total>31</total>
<totalmonday>37</totalmonday>
<overflow>3</overflow>
<overflowmonday>2</overflowmonday>
<count>31</count>
<prev>2011-12</prev>
<next>2012-02</next>
<today>2012-02-17</today>
</month>
<month>
<date>1328025600</date>
<year>2012</year>
<n-month>02</n-month>
<month>February</month>
<start>4</start>
<startmonday>3</startmonday>
<total>32</total>
<totalmonday>31</totalmonday>
<overflow>4</overflow>
<overflowmonday>3</overflowmonday>
<count>29</count>
<prev>2012-01</prev>
<next>2012-03</next>
<today>2012-02-17</today>
</month>
<month>
<date>1330531200</date>
<year>2012</year>
<n-month>03</n-month>
<month>March</month>
<start>5</start>
<startmonday>4</startmonday>
<total>35</total>
<totalmonday>34</totalmonday>
<overflow>0</overflow>
<overflowmonday>6</overflowmonday>
<count>31</count>
<prev>2012-02</prev>
<next>2012-04</next>
<today>2012-02-17</today>
</month>
<month>
<date>1333209600</date>
<year>2012</year>
<n-month>04</n-month>
<month>April</month>
<start>1</start>
<startmonday>7</startmonday>
<total>30</total>
<totalmonday>36</totalmonday>
<overflow>2</overflow>
<overflowmonday>1</overflowmonday>
<count>30</count>
<prev>2012-03</prev>
<next>2012-05</next>
<today>2012-02-17</today>
</month>
<month>
<date>1335801600</date>
<year>2012</year>
<n-month>05</n-month>
<month>May</month>
<start>3</start>
<startmonday>2</startmonday>
<total>33</total>
<totalmonday>32</totalmonday>
<overflow>5</overflow>
<overflowmonday>4</overflowmonday>
<count>31</count>
<prev>2012-04</prev>
<next>2012-06</next>
<today>2012-02-17</today>
</month>
<month>
<date>1338480000</date>
<year>2012</year>
<n-month>06</n-month>
<month>June</month>
<start>6</start>
<startmonday>5</startmonday>
<total>35</total>
<totalmonday>34</totalmonday>
<overflow>0</overflow>
<overflowmonday>6</overflowmonday>
<count>30</count>
<prev>2012-05</prev>
<next>2012-07</next>
<today>2012-02-17</today>
</month>
<month>
<date>1341072000</date>
<year>2012</year>
<n-month>07</n-month>
<month>July</month>
<start>1</start>
<startmonday>7</startmonday>
<total>31</total>
<totalmonday>37</totalmonday>
<overflow>3</overflow>
<overflowmonday>2</overflowmonday>
<count>31</count>
<prev>2012-06</prev>
<next>2012-08</next>
<today>2012-02-17</today>
</month>
<month>
<date>1343750400</date>
<year>2012</year>
<n-month>08</n-month>
<month>August</month>
<start>4</start>
<startmonday>3</startmonday>
<total>34</total>
<totalmonday>33</totalmonday>
<overflow>6</overflow>
<overflowmonday>5</overflowmonday>
<count>31</count>
<prev>2012-07</prev>
<next>2012-09</next>
<today>2012-02-17</today>
</month>
<month>
<date>1346428800</date>
<year>2012</year>
<n-month>09</n-month>
<month>September</month>
<start>7</start>
<startmonday>6</startmonday>
<total>36</total>
<totalmonday>35</totalmonday>
<overflow>1</overflow>
<overflowmonday>0</overflowmonday>
<count>30</count>
<prev>2012-08</prev>
<next>2012-10</next>
<today>2012-02-17</today>
</month>
<month>
<date>1349020800</date>
<year>2012</year>
<n-month>10</n-month>
<month>October</month>
<start>2</start>
<startmonday>1</startmonday>
<total>32</total>
<totalmonday>31</totalmonday>
<overflow>4</overflow>
<overflowmonday>3</overflowmonday>
<count>31</count>
<prev>2012-09</prev>
<next>2012-11</next>
<today>2012-02-17</today>
</month>
<month>
<date>1351699200</date>
<year>2012</year>
<n-month>11</n-month>
<month>November</month>
<start>5</start>
<startmonday>4</startmonday>
<total>34</total>
<totalmonday>33</totalmonday>
<overflow>6</overflow>
<overflowmonday>5</overflowmonday>
<count>30</count>
<prev>2012-10</prev>
<next>2012-12</next>
<today>2012-02-17</today>
</month>
<month>
<date>1354291200</date>
<year>2012</year>
<n-month>12</n-month>
<month>December</month>
<start>7</start>
<startmonday>6</startmonday>
<total>37</total>
<totalmonday>36</totalmonday>
<overflow>2</overflow>
<overflowmonday>1</overflowmonday>
<count>31</count>
<prev>2012-11</prev>
<next>2013-01</next>
<today>2012-02-17</today>
</month>
</calendar>
</datapackets>
#2
Request
/date/date/2012-03-14 14:05:00/
Returns date data for the 14th March 2012 at 2:05PM
Response
<?xml version="1.0"?>
<datapackets>
<now>
<servertime>1329465540</servertime>
<timezone>+0800</timezone>
<date>
<rfcdate>Wed, 14 Mar 2012 02:05:00 +0800</rfcdate>
<unixdate>1331705100</unixdate>
<revdate>20120314</revdate>
<year>2012</year>
<n-month>03</n-month>
<n-day>14</n-day>
<month>March</month>
<day>Wednesday</day>
<week>11</week>
<suffix>th</suffix>
<hour>02</hour>
<minute>05</minute>
<meridiem>pm</meridiem>
</date>
<time>02:05:00 pm</time>
<agetime>-2239560</agetime>
</now>
<calendar>
<month>
<date>1330531200</date>
<year>2012</year>
<n-month>03</n-month>
<month>March</month>
<start>5</start>
<startmonday>4</startmonday>
<total>35</total>
<totalmonday>34</totalmonday>
<overflow>0</overflow>
<overflowmonday>6</overflowmonday>
<count>31</count>
<prev>2012-02</prev>
<next>2012-04</next>
<today>2012-02-17</today>
</month>
</calendar>
</datapackets>
#3
Request
/date/date/2012-03-14 14:05:00/adjust/6400/
Returns date data for 64 hours after 14th March 2012 at 2:05PM
Response
<?xml version="1.0"?>
<datapackets>
<now>
<servertime>1329465767</servertime>
<timezone>+0800</timezone>
<date>
<rfcdate>Sat, 17 Mar 2012 06:05:00 +0800</rfcdate>
<unixdate>1331935500</unixdate>
<revdate>20120317</revdate>
<year>2012</year>
<n-month>03</n-month>
<n-day>17</n-day>
<month>March</month>
<day>Saturday</day>
<week>11</week>
<suffix>th</suffix>
<hour>06</hour>
<minute>05</minute>
<meridiem>am</meridiem>
</date>
<time>06:05:00 am</time>
<agetime>-2469733</agetime>
</now>
<calendar>
<month>
<date>1330531200</date>
<year>2012</year>
<n-month>03</n-month>
<month>March</month>
<start>5</start>
<startmonday>4</startmonday>
<total>35</total>
<totalmonday>34</totalmonday>
<overflow>0</overflow>
<overflowmonday>6</overflowmonday>
<count>31</count>
<prev>2012-02</prev>
<next>2012-04</next>
<today>2012-02-17</today>
</month>
</calendar>
</datapackets>
#4
Request
/date/calendar/2014
Returns calendar data for 2014
Response
<?xml version="1.0"?>
<datapackets>
<now>
<servertime>1329465905</servertime>
<timezone>+0800</timezone>
<date>
<rfcdate>Fri, 17 Feb 2012 04:05:05 +0800</rfcdate>
<unixdate>1329465905</unixdate>
<revdate>20120217</revdate>
<year>2012</year>
<n-month>02</n-month>
<n-day>17</n-day>
<month>February</month>
<day>Friday</day>
<week>07</week>
<suffix>th</suffix>
<hour>04</hour>
<minute>05</minute>
<meridiem>pm</meridiem>
</date>
<time>04:05:05 pm</time>
<agetime>0</agetime>
</now>
<calendar>
<month>
<date>1388505600</date>
<year>2014</year>
<n-month>01</n-month>
<month>January</month>
<start>4</start>
<startmonday>3</startmonday>
<total>34</total>
<totalmonday>33</totalmonday>
<overflow>6</overflow>
<overflowmonday>5</overflowmonday>
<count>31</count>
<prev>2013-12</prev>
<next>2014-02</next>
<today>2012-02-17</today>
</month>
<month>
<date>1391184000</date>
<year>2014</year>
<n-month>02</n-month>
<month>February</month>
<start>7</start>
<startmonday>6</startmonday>
<total>34</total>
<totalmonday>33</totalmonday>
<overflow>6</overflow>
<overflowmonday>5</overflowmonday>
<count>28</count>
<prev>2014-01</prev>
<next>2014-03</next>
<today>2012-02-17</today>
</month>
<month>
<date>1393603200</date>
<year>2014</year>
<n-month>03</n-month>
<month>March</month>
<start>7</start>
<startmonday>6</startmonday>
<total>37</total>
<totalmonday>36</totalmonday>
<overflow>2</overflow>
<overflowmonday>1</overflowmonday>
<count>31</count>
<prev>2014-02</prev>
<next>2014-04</next>
<today>2012-02-17</today>
</month>
<month>
<date>1396281600</date>
<year>2014</year>
<n-month>04</n-month>
<month>April</month>
<start>3</start>
<startmonday>2</startmonday>
<total>32</total>
<totalmonday>31</totalmonday>
<overflow>4</overflow>
<overflowmonday>3</overflowmonday>
<count>30</count>
<prev>2014-03</prev>
<next>2014-05</next>
<today>2012-02-17</today>
</month>
<month>
<date>1398873600</date>
<year>2014</year>
<n-month>05</n-month>
<month>May</month>
<start>5</start>
<startmonday>4</startmonday>
<total>35</total>
<totalmonday>34</totalmonday>
<overflow>0</overflow>
<overflowmonday>6</overflowmonday>
<count>31</count>
<prev>2014-04</prev>
<next>2014-06</next>
<today>2012-02-17</today>
</month>
<month>
<date>1401552000</date>
<year>2014</year>
<n-month>06</n-month>
<month>June</month>
<start>1</start>
<startmonday>7</startmonday>
<total>30</total>
<totalmonday>36</totalmonday>
<overflow>2</overflow>
<overflowmonday>1</overflowmonday>
<count>30</count>
<prev>2014-05</prev>
<next>2014-07</next>
<today>2012-02-17</today>
</month>
<month>
<date>1404144000</date>
<year>2014</year>
<n-month>07</n-month>
<month>July</month>
<start>3</start>
<startmonday>2</startmonday>
<total>33</total>
<totalmonday>32</totalmonday>
<overflow>5</overflow>
<overflowmonday>4</overflowmonday>
<count>31</count>
<prev>2014-06</prev>
<next>2014-08</next>
<today>2012-02-17</today>
</month>
<month>
<date>1406822400</date>
<year>2014</year>
<n-month>08</n-month>
<month>August</month>
<start>6</start>
<startmonday>5</startmonday>
<total>36</total>
<totalmonday>35</totalmonday>
<overflow>1</overflow>
<overflowmonday>0</overflowmonday>
<count>31</count>
<prev>2014-07</prev>
<next>2014-09</next>
<today>2012-02-17</today>
</month>
<month>
<date>1409500800</date>
<year>2014</year>
<n-month>09</n-month>
<month>September</month>
<start>2</start>
<startmonday>1</startmonday>
<total>31</total>
<totalmonday>30</totalmonday>
<overflow>3</overflow>
<overflowmonday>2</overflowmonday>
<count>30</count>
<prev>2014-08</prev>
<next>2014-10</next>
<today>2012-02-17</today>
</month>
<month>
<date>1412092800</date>
<year>2014</year>
<n-month>10</n-month>
<month>October</month>
<start>4</start>
<startmonday>3</startmonday>
<total>34</total>
<totalmonday>33</totalmonday>
<overflow>6</overflow>
<overflowmonday>5</overflowmonday>
<count>31</count>
<prev>2014-09</prev>
<next>2014-11</next>
<today>2012-02-17</today>
</month>
<month>
<date>1414771200</date>
<year>2014</year>
<n-month>11</n-month>
<month>November</month>
<start>7</start>
<startmonday>6</startmonday>
<total>36</total>
<totalmonday>35</totalmonday>
<overflow>1</overflow>
<overflowmonday>0</overflowmonday>
<count>30</count>
<prev>2014-10</prev>
<next>2014-12</next>
<today>2012-02-17</today>
</month>
<month>
<date>1417363200</date>
<year>2014</year>
<n-month>12</n-month>
<month>December</month>
<start>2</start>
<startmonday>1</startmonday>
<total>32</total>
<totalmonday>31</totalmonday>
<overflow>4</overflow>
<overflowmonday>3</overflowmonday>
<count>31</count>
<prev>2014-11</prev>
<next>2015-01</next>
<today>2012-02-17</today>
</month>
</calendar>
</datapackets>
#5
Request
/date/timezone/+1000/
Returns the current time in the specified timezone. Does not support daylight savings currently.