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