`$cal.timestamp`¶

Description¶

Construit un objet de type timestamp.

Syntaxe¶

La méthode autorise plusieurs syntaxes:

$cal.timestamp()
$cal.timestamp(options)
$cal.timestamp(part1)
$cal.timestamp(part1, options)
$cal.timestamp(part1, part2)
$cal.timestamp(part1, part2, options)

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.

options map

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

pattern string: Pattern décrivant la forme de la valeur des autres paramètres dans le cas où ceux-ci ne suivent pas le format ISO-8601. Si les deux paramètres part1 et part2 sont définis, le pattern s'applique à la valeur résultant de la concaténation part1 + " " + part2 (avec un espace entre les deux parties)
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 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("31.12.2023", "13:45:30", "dd.MM.yyyy hh:mm:ss);
$cal.timestamp({ timezone: "UTC" });    // timestamp actuel en UTC

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

// affiche le timestamp UTC en format ISO
$cal.format($cal.timestamp({ timezone: "UTC" }), "yyyy-MM-dd'T'HH:mm:ss'Z'");

$cal.timestamp¶