Update LSattr_ldap::date doc (from 05519c5432)

This commit is contained in:
Benjamin Renard 2023-08-18 12:27:03 +02:00
parent c31fe88371
commit d781be02f8
Signed by: bn8
GPG key ID: 3E2E1CE1907115BC

View file

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