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.