`$cal.time`¶

Description¶

Construit un objet de type time.

Syntaxe¶

La méthode autorise plusieurs syntaxes:

$cal.time() $cal.time(options) $cal.time(time) $cal.time(time, options)

Paramètres¶

time string

Valeur à convertir en heure. L'heure passée en paramètre doit respecter le format ISO-8601 pour les heures, à savoir "hh:mm:ss", ou alors le pattern de l'heure 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 heure à partir de l'heure actuelle, 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. LLes options reconnues sont:

pattern string: Pattern décrivant la forme de la valeur du paramètre time 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 time 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.time();
$cal.time("13:45:30");
$cal.time("13-45-30", "hh-mm-ss");

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

$cal.time¶