DosSetDateTime |
DOS : Fixe la date et l'heure |
|---|---|
| DOSCALLS.DLL | os2.h |
Syntaxe
| APIRET DosSetDateTime( PDATETIME pdt ); |
Paramètres
| Nom | Description | |||
|---|---|---|---|---|
| pdt | Ce paramètre permet d'indiquer un pointeur vers une structure DATETIME contenant la date et l'heure à fixer dans le système. Voici la structure sur lequel elle pointe : | |||
| Champs | Type de données | Description | ||
| hours | UCHAR | Ce champ permet d'indiquer l'heure dans l'intervalle de 0 à 23. | ||
| minutes | UCHAR | Ce champ permet d'indiquer les minutes dans l'intervalle de 0 à 59. | ||
| seconds | UCHAR | Ce champ permet d'indiquer les secondes dans l'intervalle de 0 à 59. | ||
| hundredths | UCHAR | Ce champ permet d'indiquer les centièmes de secondes dans l'intervalle de 0 à 99. | ||
| day | UCHAR | Ce champ permet d'indiquer le jour du mois dans l'intervalle de 0 à 31. | ||
| month | UCHAR | Ce champ permet d'indiquer le numéro du mois dans l'intervalle de 0 à 12. Voici la correspondance des valeurs : | ||
| Valeur | Description | |||
| 1 | Janvier | |||
| 2 | Février | |||
| 3 | Mars | |||
| 4 | Avril | |||
| 5 | Mai | |||
| 6 | Juin | |||
| 7 | Juillet | |||
| 8 | Août | |||
| 9 | Septembre | |||
| 10 | Octobre | |||
| 11 | Novembre | |||
| 12 | Décembre | |||
| year | USHORT | Ce champ permet d'indiquer l'année. | ||
| timezone | SHORT | Ce champ permet d'indiquer la différence de minutes entre l'heure courante et le fuseau horaire de Greenwich (GMT > 0 ouest de Greenwich). | ||
| weekday | UCHAR | Ce champ permet d'indiquer le jour de la semaine dans l'intervalle de 0 à 6. Voici la correspondance des valeurs : | ||
| Valeur | Description | |||
| 0 | Dimanche | |||
| 1 | Lundi | |||
| 2 | Mardi | |||
| 3 | Mercredi | |||
| 4 | Jeudi | |||
| 5 | Vendredi | |||
| 6 | Samedi | |||
Retour
| Valeur | Constante | Description |
|---|---|---|
| 0 | NO_ERROR | Cette valeur permet d'indiquer que l'opération s'est correctement effectué |
| 327 | ERROR_TS_DATETIME | Cette valeur permet d'indiquer qu'une erreur s'est produite en voulant modifié le temps. |
Description
Cette fonction permet de fixer la date et l'heure du système.
Exemple
Voici un simple exemple montrant comme appeler cette API avec WatCom C++ for OS/2 :
- #define INCL_DOSERRORS
- #define INCL_DOSDATETIME
- #include "os2.h"
- #include "stdio.h"
-
- void main(void) {
- DATETIME dt;
- dt.hours=12;
- dt.minutes=59;
- dt.seconds=00;
- dt.hundredths=00;
- dt.day=6;
- dt.month=9;
- dt.year=2010;
- dt.timezone=0;
- dt.weekday=1;
- switch(DosSetDateTime(&dt)) {
- case NO_ERROR: printf("Tout va bien !");break;
- case ERROR_TS_DATETIME: printf("Erreur : une erreur s'est produite en voulant modifié le temps.");break;
- }
- }
Voir également
Langage de programmation - C pour OS/2 - DosGetDateTime
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010