mirror of
https://gitlab.easter-eggs.com/ee/ldapsaisie.git
synced 2024-11-25 11:29:06 +01:00
89 lines
3.6 KiB
Text
89 lines
3.6 KiB
Text
<sect4 id="config-LSattr_ldap_date">
|
||
<title>LSattr_ldap_date</title>
|
||
<para>Ce type est utilisé pour la gestion des attributs dont la valeur est
|
||
une date.</para>
|
||
|
||
<note>
|
||
<para>Au sein d'LdapSaisie, les dates manipulées au travers ce type
|
||
d'attribut LDAP, sont au format <emphasis>timestamp</emphasis>. Il s'agit
|
||
donc de nombres entiers correpondants au nombre de secondes depuis le 1 janvier
|
||
1970.</para>
|
||
<para>Le type d'attribut HTML utilisé conjointement avec ce type d'attribut LDAP
|
||
devra être prévu pour recevoir et fournir des dates au format <emphasis>timestamp
|
||
</emphasis>, comme c'est le cas pour le <link linkend='config-LSattr_html_date'>
|
||
type d'attribut HTML <emphasis>date</emphasis></link>.</para>
|
||
</note>
|
||
|
||
<programlisting linenumbering="unnumbered">
|
||
<citetitle>Structure</citetitle>...
|
||
<![CDATA['ldap_options' => array (
|
||
'timestamp' => [Booléen], // Si la date est stockée au format timestamp
|
||
'formats' => array(
|
||
'[Format de stockage principal]', // Par défaut : "YmdHisO"
|
||
'[Formats de stockage alternatifs]', // Par défaut : "YmdHis.vO" & "YmdHis.uO"
|
||
[...]
|
||
),
|
||
'timezone' => '[Fuseau horaire]', // Default : "UTC"
|
||
),]]>
|
||
...
|
||
</programlisting>
|
||
|
||
<variablelist>
|
||
<title>Paramètres de configuration</title>
|
||
|
||
<varlistentry>
|
||
<term>timestamp</term>
|
||
<listitem>
|
||
<simpara>Booléen définissant si la date est stockée sous la forme d'un
|
||
timestamp Unix (nombre de secondes depuis le 1er janvier 1970 à 00:00:00
|
||
UTC).</simpara>
|
||
<remark>Si <parameter>timestamp</parameter> est vrai, &LdapSaisie; ne tient
|
||
pas compte du paramètre <parameter>format</parameter>.</remark>
|
||
</listitem>
|
||
</varlistentry>
|
||
|
||
<varlistentry>
|
||
<term>formats</term>
|
||
<listitem>
|
||
<para>Formats de stockage de la date dans l'annuaire. Ces formats sont composés à
|
||
partir des motifs clés gérés par la fonction <function>date()</function>
|
||
de &php;. Pour plus d'information, consulter
|
||
<ulink url='http://www.php.net/date'>la documentation officielle</ulink>. Plusieurs
|
||
formats peuvent être définis, mais en cas de stockage d'une nouvelle valeur, se sera
|
||
le premier format défini qui sera utilisé.
|
||
<note><simpara>La valeur par défaut est <emphasis>["YmdHisO", "YmdHis.vO", "YmdHis.uO"]</emphasis>,
|
||
correspondant à la syntaxe <literal>Generalized Time</literal> (sans et avec les milli-secondes
|
||
ou micro-secondes) telle que définie dans la
|
||
<ulink url='https://tools.ietf.org/html/rfc4517'>RFC4517</ulink>. Exemples :
|
||
<literal>20091206230506Z</literal>
|
||
<emphasis>(=2009/12/06 23:05:66 UTC)</emphasis>,
|
||
<literal>20190613143537+0200</literal>
|
||
<emphasis>(=2019/06/13 14:35:37 UTC+0200)</emphasis> ou
|
||
<literal>20230818121005.307+0200</literal>
|
||
<emphasis>(=2023/08/18 12:10:05.307 UTC+0200)</emphasis>.</simpara></note>
|
||
<warning><simpara>Si vous exploitez un attribut stockant une date incluant les
|
||
milli-secondes ou les micro-secondes, ce type d'attribut LDAP sera capable de gérer
|
||
l'interpratation des valeurs stockées, en outre le type d'attribut &LSattr_html_date;,
|
||
s'appuyant sur les méthodes standards <literal>strftime()</literal> et
|
||
<literal>strptime()</literal>, ne permettra pas aujourd'hui leur saisie et affichage.
|
||
</simpara></warning>
|
||
</para>
|
||
|
||
</listitem>
|
||
</varlistentry>
|
||
|
||
<varlistentry>
|
||
<term>timezone</term>
|
||
<listitem>
|
||
<para>Fuseau horaire de stockage des dates dans l'annuaire LDAP. Les valeurs
|
||
possibles sont documentées dans <ulink url='https://www.php.net/timezones'>la
|
||
documentation officielle de PHP</ulink>. (Par défaut : <literal>UTC</literal>)
|
||
</para>
|
||
|
||
</listitem>
|
||
</varlistentry>
|
||
|
||
</variablelist>
|
||
|
||
|
||
</sect4>
|