From d781be02f8814bce37bbbe26faedd02bee56704d Mon Sep 17 00:00:00 2001 From: Benjamin Renard Date: Fri, 18 Aug 2023 12:27:03 +0200 Subject: [PATCH] Update LSattr_ldap::date doc (from 05519c543276f8f06d24628d29598b75f40c732f) --- .../LSattr_ldap/LSattr_ldap_date.md | 33 +++++++++++-------- 1 file changed, 20 insertions(+), 13 deletions(-) diff --git a/doc/src/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_date.md b/doc/src/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_date.md index f94a92c9..5d954f30 100644 --- a/doc/src/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_date.md +++ b/doc/src/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_date.md @@ -15,7 +15,11 @@ Ce type est utilisé pour la gestion des attributs dont la valeur est une date. ``` 'ldap_options' => array ( 'timestamp' => [Booléen], // Si la date est stockée au format timestamp - 'format' => '[Format de stockage]', // Default : "YmdHisO" + '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" ), ... @@ -28,27 +32,30 @@ Ce type est utilisé pour la gestion des attributs dont la valeur est une date. Si `timestamp` est vrai, LdapSaisie ne tient pas compte du paramètre format. -- `format` +- `formats` - Format de stockage de la date dans l'annuaire. Ce format est composé à partir des motifs clés + 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 `date()` de PHP. Pour plus d'information, consulter - [la documentation officielle](http://www.php.net/date). + [la documentation officielle](http://www.php.net/date). 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 - La valeur par défaut est *YmdHisO*, correspondant à la syntaxe `Generalized Time` (sans les - micro-secondes) telle que définie dans la [RFC4517](https://tools.ietf.org/html/rfc4517). - Exemples : `20091206230506Z` *(=2009/12/06 23:05:66 UTC)* ou `20190613143537+0200` - *(=2019/06/13 14:35:37 UTC+0200)*. + La valeur par défaut est *["YmdHisO", "YmdHis.vO", "YmdHis.uO"]*, correspondant à la syntaxe + `Generalized Time` (sans et avec les milli-secondes ou micro-secondes) telle que définie dans + la [RFC4517](https://tools.ietf.org/html/rfc4517). + Exemples : `20091206230506Z` *(=2009/12/06 23:05:66 UTC)*, `20190613143537+0200` + *(=2019/06/13 14:35:37 UTC+0200)* ou `20230818121005.307+0200` + *(=2023/08/18 12:10:05.307 UTC+0200)*. !!! warning - Si vous exploitez un attribut stockant une date incluant les micro-secondes, ce type - d'attribut LDAP sera capable de gérer l'interpratation des valeurs stockées en configurant le - format `YmdHis.uO`. En outre, le type d'attribut + 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](../LSattr_html/LSattr_html_date.md#lsattr_html_date), s'appuyant sur les - méthodes standards `strftime()` et `strptime()`, ne permettra pas aujourd'hui la saisie et - l'affichage des millisecondes. + méthodes standards `strftime()` et `strptime()`, ne permettra pas aujourd'hui leur saisie et + affichage. - `timezone`