$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. 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(,)                        ==>  ""