m |
|||
Line 11: | Line 11: | ||
:*<code>xml</code> : Returns an xml file that contains all shard time information. | :*<code>xml</code> : Returns an xml file that contains all shard time information. | ||
− | ===Cache duration=== | + | ====Cache duration==== |
The data is cached for 1 minute. | The data is cached for 1 minute. | ||
− | = | + | ==== XML structure ==== |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | === XML structure === | ||
− | |||
:<syntaxhighlight lang="xml"><shard_time> | :<syntaxhighlight lang="xml"><shard_time> | ||
<server_tick>514105152</server_tick> | <server_tick>514105152</server_tick> | ||
Line 47: | Line 33: | ||
<cache created="1387437183" expire="1387437243"/> | <cache created="1387437183" expire="1387437243"/> | ||
</shard_time></syntaxhighlight> | </shard_time></syntaxhighlight> | ||
+ | |||
+ | ===PHP interface=== | ||
+ | :<code>ryzom_time_api()</code> : Returns SimpleXMLElement or boolean false on failure. | ||
+ | |||
+ | :<syntaxhighlight lang="php"><?php | ||
+ | require_once "ryzomapi_lite.php"; | ||
+ | |||
+ | $time = ryzom_time_api('xml'); | ||
+ | if ($time !== false) { | ||
+ | $txt_en = htmlspecialchars($time->txt_en); | ||
+ | echo "Atys time is {$txt_en}"; | ||
+ | } else { | ||
+ | echo "API failure"; | ||
+ | }</syntaxhighlight> | ||
+ | |||
<noinclude>[[Category:Ryzom API|Time]]</noinclude> | <noinclude>[[Category:Ryzom API|Time]]</noinclude> |
To know the time and date in Ryzom.
<base URL>/time.php
(optional), defaults ro raw.
raw
: Returns the tick. The server tick is a 32 bit integer that increases by one every 100 milliseconds.txt
: Returns a homine-readable string.xml
: Returns an xml file that contains all shard time information. The data is cached for 1 minute.
<shard_time>
<server_tick>514105152</server_tick>
<jena_year>2576</jena_year>
<day_of_jy>319</day_of_jy>
<month_of_jy>10</month_of_jy>
<cycle>0</cycle>
<day_of_cycle>319</day_of_cycle>
<month_of_cycle>10</month_of_cycle>
<day_of_month>19</day_of_month>
<day_of_week>1</day_of_week>
<season>3</season>
<day_of_season>49</day_of_season>
<time_of_day>13</time_of_day>
<txt_en>13h - Dua, Mystia 20, 1st AC 2576</txt_en>
<txt_fr>13h - Dua, Mystia 20, 1er CA 2576</txt_fr>
<txt_de>13h - Dua, Mystia 20, 1. AZ 2576</txt_de>
<cache created="1387437183" expire="1387437243"/>
</shard_time>
ryzom_time_api()
: Returns SimpleXMLElement or boolean false on failure.<?php
require_once "ryzomapi_lite.php";
$time = ryzom_time_api('xml');
if ($time !== false) {
$txt_en = htmlspecialchars($time->txt_en);
echo "Atys time is {$txt_en}";
} else {
echo "API failure";
}