Difference between revisions of "Ryzom API/Time"
From EncyclopAtys
(→URL Parameters) |
|||
Line 4: | Line 4: | ||
====URL Parameters==== | ====URL Parameters==== | ||
− | + | ;format: (optional), defaults ro raw. | |
− | (optional), defaults ro raw. | ||
:*<code>raw</code> : Returns the tick. The server tick is a 32 bit integer that increases by one every 100 milliseconds. | :*<code>raw</code> : Returns the tick. The server tick is a 32 bit integer that increases by one every 100 milliseconds. | ||
:*<code>txt</code> : Returns a homine-readable string. | :*<code>txt</code> : Returns a homine-readable string. | ||
− | :*<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==== |
Revision as of 16:54, 27 October 2020
To know the time and date in Ryzom.
Usage
<base URL>/time.php
URL Parameters
- format
- (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.
Cache duration
The data is cached for 1 minute.
XML structure
<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>
PHP interface
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"; }