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.