Fonctions de date et d’heure

addMinutes (date; nombre)

Renvoie une nouvelle date suite à l’ajout d’un nombre donné de minutes à une date. Pour soustraire les minutes, saisissez un nombre négatif.

addHours (date; nombre)

Renvoie une nouvelle date suite à l’ajout d’un nombre donné d’heures à une date. Pour soustraire les heures, saisissez un nombre négatif.

addDays (date; nombre)

Renvoie une nouvelle date suite à l’ajout d’un nombre donné de jours à une date. Pour soustraire des jours, saisissez un nombre négatif.

addMonths (date; nombre)

Renvoie une nouvelle date suite à l’ajout d’un nombre donné de mois à une date. Pour soustraire des mois, saisissez un nombre négatif.

addYears (date; nombre)

Renvoie une nouvelle date suite à l’ajout d’un nombre donné d’années à une date. Pour soustraire des années, saisissez un nombre négatif.

setSecond (date; nombre)

Cette fonction renvoie une nouvelle date avec les secondes indiquées dans les paramètres.

Indiquez un nombre compris entre 0 et 59. Si le nombre se trouve en dehors de cette plage, la fonction renvoie une seconde à partir de la minute précédente (pour un nombre négatif) ou de la minute suivante (pour un nombre positif).

Si vous devez indiquer un nombre en dehors de la plage, nous vous recommandons d’utiliser addSeconds, comme décrit ci-dessus dans la section addSeconds (date; nombre).

setMinute (date; nombre)

Cette fonction renvoie une nouvelle date avec les minutes indiquées dans les paramètres.

Indiquez un nombre compris entre 0 et 59. Si le nombre se trouve en dehors de cette plage, la fonction renvoie une minute par rapport à l’heure précédente (pour un nombre négatif) ou à l’heure suivante (pour un nombre positif).

Si vous devez indiquer un nombre en dehors de la plage, nous vous recommandons d’utiliser addMinutes, comme décrit ci-dessus dans la section addMinutes (date; nombre).

setHour (date; nombre)

Cette fonction renvoie une nouvelle date avec l’heure indiquée dans les paramètres.

Indiquez un nombre compris entre 0 et 23. Si le nombre se trouve en dehors de cette plage, la fonction renvoie une heure à partir du jour précédent (pour un nombre négatif) ou du jour suivant (pour un nombre positif).

Si vous devez spécifier un nombre en dehors de la plage, nous vous recommandons d’utiliser addHours, comme décrit ci-dessus dans la section addHours (date; nombre).

setDay (date; nombre/nom du jour en anglais)

Cette fonction renvoie une nouvelle date avec le jour spécifié dans les paramètres.

Vous pouvez utiliser cette fonction pour définir le jour de la semaine, avec le dimanche comme 1 et le samedi comme 7. Si vous indiquez un nombre compris entre 1 et 7, la date obtenue est comprise dans la semaine en cours (du dimanche au samedi). Si le nombre ne figure pas dans cette plage, la fonction renvoie un jour de la semaine précédente (pour un nombre négatif) ou de la semaine suivante (pour un nombre positif).

Si vous devez spécifier un nombre en dehors de la plage, nous vous recommandons d’utiliser addDays, comme décrit ci-dessus dans la section addDays (date; nombre).

setDate (date; nombre)

Cette fonction renvoie une nouvelle date avec le jour du mois spécifié dans les paramètres.

Indiquez un nombre compris entre 1 et 31. Si le nombre se trouve en dehors de cette plage, la fonction renvoie un jour à partir du mois précédent (pour un nombre négatif) ou du mois suivant (pour un nombre positif).

setMonth (date; nombre/nom du mois en anglais)

Cette fonction renvoie une nouvelle date avec le mois spécifié dans les paramètres.

Indiquez un nombre compris entre 1 et 12. Si le nombre ne figure pas dans cette plage, la fonction renvoie le mois de l’année précédente (pour un nombre négatif) ou de l’année suivante (pour un nombre positif).

setYear (date; nombre)

Renvoie une nouvelle date avec l’année spécifiée dans les paramètres.

Valeur et type de renvoi

La fonction formatDate renvoie une représentation textuelle de la valeur Date donnée en fonction du format et du fuseau horaire spécifiés. Le type de données est Texte.

Valeur et type de renvoi

Cette fonction convertit une chaîne de texte en date, selon le format et le fuseau horaire indiqués. Le type de données de la valeur est Date.