$dateformat

Utilisation: $dateformat(date,[format],[ordre des dates])
Catégorie: information
Implémenté : Picard 2.7

Description:

Retourne la date d’entrée dans le format spécifié, qui est basé sur les codes de strftime standard de Python <https://strftime.org>`_. Si aucun format n’est spécifié, la date sera retournée sous la forme “2020-02-15” (année, mois, jour).

Les parties « année », « mois » et « jour » de la date doivent être saisies sous forme de nombres et peuvent être séparées par des caractères non numériques. L’ordre par défaut pour la date d’entrée est « ymd » (année, mois, jour). Ceci peut être modifié en spécifiant un ordre de date.

Les entrées valides pour ordre de date sont :

ymd - année, mois, jour (il s’agit de l’ordre par défaut).
dmy - jour, mois, année
mdy - mois, jour, année

Si la date ou le format sont invalides, une chaîne vide sera retournée. Si un ordre de date invalide est spécifié, l’ordre par défaut « ymd » sera utilisé.

Note

Tous les caractères spéciaux tels que « % », « $ », « (« , « ) » et « \ » devront être échappés comme indiqué dans les exemples ci-dessous.

Avertissement

Les codes de formatage spécifiques à une plate-forme doivent être évités afin de garantir la portabilité des scripts sur les différentes plates-formes. Ces codes comprennent : la suppression de la troncature zéro (par exemple : %-d et %-m sur Linux ou macOS, et leurs équivalents %#d et %#m sur Windows) ; les spécificateurs de longueur d’élément (par exemple : %3Y) ; et les « % » suspendus à la fin de la chaîne de format.

Exemples:

Les instructions suivantes renverront les valeurs indiquées :

$set(foo,07.21.2021)
$set(bar,mdy)
$set(format,\%Y.\%m.\%d)
$dateformat(%foo%,%format%,%bar%)     ==>  "2021.07.21"

$dateformat(2021 07 21)               ==>  "2021-07-21"
$dateformat(2021.07.21)               ==>  "2021-07-21"
$dateformat(2021-07-21)               ==>  "2021-07-21"
$dateformat(2021-7-21)                ==>  "2021-07-21"
$dateformat(2021-7-21,\%B \%d\, \%Y)  ==>  "July 21, 2021"

$dateformat(2021-07-21,,ymd)          ==>  "2021-07-21"
$dateformat(2021-07-21,,dmy)          ==>  ""
$dateformat(2021-07-21,,mdy)          ==>  ""
$dateformat(2021-July-21)             ==>  ""
$dateformat(2021)                     ==>  ""
$dateformat(2021-07)                  ==>  ""
$dateformat(,)                        ==>  ""