Ryzom API

h1. Time

This Ryzom API gets the time in the game servers (shards).

h2. Base URL

* http://api.ryzom.com/time.php

h2. URL Parameters

h3. @format@ (optional) 

Default @format@ is @raw@.

* @raw@: Returns the tick. The server tick is a 32 bit integer that increases by one every 100 milliseconds ("example":http://api.ryzom.com/time.php?format=raw).

* @txt@: Returns a homine-readable string ("example":http://api.ryzom.com/time.php?format=txt).

* @xml@: Returns an xml file that contains all shard time information ("example":http://api.ryzom.com/time.php?format=xml).

h2. Cache Duration

The data is cached during *1 minute*.

h2. PHP Interface

h3. @ryzom_time_api()@

Returns *SimpleXMLElement* or boolean *false* on failure.

h3. XML structure

<pre><code class="xml">

<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>

</code></pre>

h2. Real Examples

If you have a website that use this Ryzom API, tell it in the forum and we'll add it.

* Unversal Widget (for windows, netvibes, igoogle,...) http://eco.netvibes.com/widgets/305491/ryzom-time

* Atys Time converter (sources available) http://ryzom.kervala.net/time.php