$cal.date

Description

Construit un objet de type date.

Syntaxe

La méthode autorise plusieurs syntaxes:

$cal.date() $cal.date(options) $cal.date(date) $cal.date(date, options)

Paramètres

date string

Valeur à convertir en date. La date passée en paramètre doit respecter le format ISO-8601 de date, à savoir "yyyy-MM-dd", ou alors le pattern de la date d'entrée doit être spécifié dans le paramètre pattern.

Si le paramètre n'est pas spécifié, la méthode génère une date à partir de la date du jour, selon le fuseau horaire dans lequel se trouve le serveur d'application.

Si le paramètre est null ou contient une valeur inappropriée, la méthode retourne une valeur null.

options map

Options de génération de la date. Les options reconnues sont:

pattern string

Pattern décrivant la forme de la valeur du paramètre date dans le cas où celle-ci ne suit pas le format ISO-8601.

timezone string

Timezone dans laquelle on souhaite exprimer l'heure, par exemple "UTC", "Europe/Paris", "America/New_York". Les règles de construction de la valeur sont décrites dans la javadoc https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html#of-java.lang.String-.

Retour

Objet de type date si le paramètre d'entrée est valide ou s'il n'est pas spécifié. Retourne null si le paramètre contient une valeur non appropriée.

Exemple

$cal.date();
$cal.date("2023-12-31");
$cal.date("31.12.2023", "dd.MM.YYYY");

$cal.date(null);    // retourne null
$cal.date("12");    // retourne null
$cal.date("hello"); // retourne null