TIMESERIAL |
Heure série |
|---|---|
| ASP 3.0 | |
Syntaxe
| Function TimeSerial(hour,minute,second) |
Paramètres
| Nom | Description |
|---|---|
| hour | Ce paramètre permet d'indiquer l'heure |
| minute | Ce paramètre permet d'indiquer les minutes |
| second | Ce paramètre permet d'indiquer les secondes |
Description
Cette fonction permet de créer une heure à partir de paramètre de temps.
Remarques
- La fonction TimeSerial permet de créer un objet Date à partir de valeurs horaires spécifiées (heures, minutes et secondes). Elle est particulièrement utile lorsqu'il est nécessaire de générer une valeur temporelle à partir d'entrées utilisateur ou de données dynamiques.
- Le format de la fonction TimeSerial est très simple : elle prend trois paramètres - hour, minute, et second - et renvoie une valeur de type Date représentant le temps spécifié. Cela permet d'éviter la nécessité de manipuler manuellement les chaînes de caractères ou les formats de date/heure.
- La fonction est extrêmement flexible : elle permet de générer des heures spécifiques, même au-delà des bornes normales, telles que 25 heures ou 75 minutes. Dans ces cas, TimeSerial ajustera automatiquement l'heure et les minutes en fonction des valeurs fournies.
- TimeSerial peut être utilisée pour effectuer des calculs sur des heures spécifiques. Par exemple, si vous avez besoin de calculer l'heure d'une tâche après une durée donnée, cette fonction permet de créer des valeurs horaires facilement manipulables.
- L'une des principales applications de TimeSerial est dans les systèmes d'horodatage où il est nécessaire de générer une heure précise à partir de valeurs d'entrée indépendantes. Cela peut être utile pour enregistrer une heure d'exécution d'une tâche ou un événement dans un système.
- Un point important est que TimeSerial ne prend pas en compte la date, elle retourne uniquement l'heure, ce qui signifie que si la date est importante, vous devrez combiner cette fonction avec d'autres méthodes comme DateSerial pour obtenir une valeur complète de type Date incluant la date et l'heure.
- En utilisant TimeSerial, on peut manipuler le temps de manière très intuitive. Par exemple, si l'on veut calculer l'heure de fin d'une réunion ou d'un événement, on peut créer l'heure de début avec TimeSerial, puis ajouter un certain nombre de minutes ou d'heures à cette valeur.
- TimeSerial prend des valeurs numériques en entrée pour les heures, minutes et secondes. Il est important de noter que les heures doivent être spécifiées entre 0 et 23, et les minutes et secondes doivent être entre 0 et 59. Si des valeurs non valides sont fournies, elles seront ajustées automatiquement sans provoquer d'erreur.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- <%
- Response.Write "TimeSerial(0,0,0) = " & TimeSerial(0,0,0) & "<br />"
- Response.Write "TimeSerial(8,12,14) = " & TimeSerial(8,12,14) & "<br />"
- Response.Write "TimeSerial(23,1,2) = " & TimeSerial(23,1,2) & "<br />"
- Response.Write "TimeSerial(24,0,0) = " & TimeSerial(24,0,0) & "<br />"
- %>
on obtiendra le résultat suivant :
TimeSerial(0,0,0) = 00:00:00TimeSerial(8,12,14) = 08:12:14
TimeSerial(23,1,2) = 23:01:02
TimeSerial(24,0,0) = 31/12/1899
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Vendredi, le 10 octobre 2014