Date et heure (bibliothèque d'exécution de Apache OpenOffice)

From Apache OpenOffice Wiki
Jump to: navigation, search
doc OOo
Book.png


                   Dans Apache OpenOffice Basic, le type de données Date enregistre les informations de date et d'heure dans un format binaire.

Spécification de la date et de l'heure dans le code de programme

Vous pouvez assigner une date à une variable de date par la simple assignation d'une chaîne :

Dim MyDate As Date
MyDate = "24.1.2002"

Cette assignation peut fonctionner correctement, car Apache OpenOffice Basic convertit automatiquement la valeur de date définie sous forme de chaîne en variable de date. Ce type d'assignation peut cependant provoquer des erreurs, les valeurs de date et d'heure étant définies et affichées différemment selon les pays.

Comme Apache OpenOffice Basic utilise les paramètres nationaux du système d'exploitation lors de la conversion d'une chaîne en valeur de date, l'expression indiquée plus haut ne fonctionne correctement que si les paramètres nationaux correspondent au format de la chaîne de caractères.

Afin d'éviter ce problème, il est recommandé d'assigner une valeur fixe à une variable de date à l'aide de la fonction DateSerial :

Dim MyVar As Date
MyDate = DateSerial (2001, 1, 24)

Le paramètre de la fonction doit correspondre à l'ordre : année, mois, jour. Cette fonction garantit que la variable reçoit bien la valeur correcte, quels que soient les paramètres nationaux.

La fonction TimeSerial formate les informations d'heure de la même manière que la fonction DateSerial formate les dates :

Dim MyVar As Date
MyDate =  TimeSerial(11, 23, 45)

Leurs paramètres doivent être spécifiés dans l'ordre : heures, minutes, secondes.

Extraction de la date et de l'heure

Les fonctions suivantes constituent le pendant des fonctions DateSerial et TimeSerial :

Day(MyDate)
retourne le jour du mois de MyDate.
Month(MyDate)
retourne le mois de MyDate.
Year(MyDate)
retourne l'année de MyDate.
Weekday(MyDate)
retourne le numéro du jour de la semaine de MyDate.
Hour(MyTime)
retourne les heures de MyTime.
Minute(MyTime)
retourne les minutes de MyTime.
Second(MyTime)
retourne les secondes de MyTime.

Ces fonctions extraient les sections de date ou d'heure d'une variable Date spécifiée. L'exemple suivant détermine si la date enregistrée dans MyDate correspond à l'année 2003.

Dim MyDate As Date
' ... Initialization of MyDate
 
If Year(MyDate) = 2003 Then
  ' ... Specified date is in the year 2003
End If

De la même façon, l'exemple suivant détermine si MyTime se trouve entre 12 et 14 heures.

Dim MyTime As Date
' ... Initialization of MyTime
 
If Hour(MyTime) >= 12 And Hour(MyTime) < 14 Then
  ' ... Specified time is between 12 and 14 hours
End If

La fonction Weekday retourne le numéro du jour de la semaine pour la date indiquée :

Dim MyDate As Date
Dim MyWeekday As String
' ... initialize MyDate
 
Select Case WeekDay(MyDate)
  case 1
    MyWeekday = "Sunday"
  case 2
    MyWeekday = "Monday"
  case 3
    MyWeekday = "Tuesday"
  case 4
    MyWeekday = "Wednesday"
  case 5
    MyWeekday = "Thursday"
  case 6
    MyWeekday = "Friday"
  case 7
    MyWeekday = "Saturday"
End Select
Documentation note.png Le dimanche est considéré comme le premier jour de la semaine.

Obtention de l'heure et de la date système

Les fonctions suivantes de Apache OpenOffice Basic permettent d'obtenir l'heure et la date système :

Date
retourne la date actuelle.
Time
retourne l'heure actuelle.
Now
retourne le point présent dans le temps (la date et l'heure combinées dans une seule valeur).
Content on this page is licensed under the Public Documentation License (PDL).
Personal tools