$cal.timestamp

Description

Construit un objet de type timestamp.

Syntaxe

$cal.timestamp( [ part1 [ , part2 ] ] )

Paramètres

part1 string

Valeur représentant soit un timestamp, soit une date au format ISO-8601. Le timestamp sera à noter selon la forme "yyyy-MM-dd hh:mm:ss.nnn" et la date selon la forme "yyyy-MM-dd".

Si le paramètre désigne un timestamp, le paramètre part2 est ignoré. S'il représente une date, le timestamp final est construit en concaténant part1 (qui représente une date) et part2(qui représente une heure).

Si le paramètre n'est pas spécifié, la méthode génère retourne le timestamp actuel, 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.

part2 string

Valeur représentant une heure au format ISO-8601, à savoir "hh:mm:ss.nnn", mais uniquement pris en considération si part1 est une date.

Retour

Objet de type timestamp si les paramètres d'entrée sont valides ou s'ils ne sont pas spécifiés. Retourne null si les paramètres contiennent des valeurs inappropriées.

Exemple

$cal.timestamp();
$cal.timestamp("2023-12-31 13:45:30.123");
$cal.timestamp("2023-12-31", "13:45:30");
$cal.timestamp(null, "13:45:30");   // reprend la date actuelle pour la partie date
$cal.timestamp("2023-12-31");       // partie heure fixée à 00:00:00.000

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